Skip to content

Refactor public API into 4 entry points by paradigm boundary#12

Merged
penta2himajin merged 1 commit into
masterfrom
claude/refactor-solidion-api-hLIpu
Mar 25, 2026
Merged

Refactor public API into 4 entry points by paradigm boundary#12
penta2himajin merged 1 commit into
masterfrom
claude/refactor-solidion-api-hLIpu

Conversation

@penta2himajin

@penta2himajin penta2himajin commented Mar 25, 2026

Copy link
Copy Markdown
Owner

Summary

  • Split flat export surface into 4 entry points following SolidJS's convention (solid-js, solid-js/store, solid-js/web):
    • solidion — L0–L1c daily API (22 exports: components, contexts, hooks, behaviors)
    • solidion/ecs — Data-driven ECS pattern (System, step functions)
    • solidion/core — Frame-aware escape hatch (renderer primitives, useFrame/useTime, meta/props/events/texture/scene-stack)
    • solidion/debug — Dev-only utilities
  • Added exports field to package.json for proper subpath resolution
  • Migrated all 5 examples to import from new entry points instead of deep paths
  • Fixed Quick Start docs to use createRoot pattern (matching all examples, not render())

Test plan

  • All 443 tests pass (npx vitest run)
  • Verify examples build correctly with npm run build in each example directory
  • Verify site builds correctly with npm run build

https://claude.ai/code/session_012YDb9c6dVsVqArhTzQHTZP

Split the flat export surface into solidion (L0-L1c daily API),
solidion/ecs (data-driven ECS), solidion/core (frame-aware escape
hatch), and solidion/debug (dev utilities). This follows SolidJS's
own convention of separating entry points where a different mental
model is needed.

- Create src/core/index.ts with renderer primitives, useFrame/useTime,
  and all L3-L4 utilities
- Slim src/index.ts to 22 exports (components, contexts, hooks, behaviors)
- Add package.json exports field for all 4 entry points
- Migrate all 5 examples to import from new entry points
- Update vite.config.ts aliases to resolve subpath imports
- Fix Quick Start docs to use createRoot pattern (matching examples)
- Update README export documentation

https://claude.ai/code/session_012YDb9c6dVsVqArhTzQHTZP
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
solidion 5dc1d96 Commit Preview URL

Branch Preview URL
Mar 25 2026, 04:06 PM

@penta2himajin penta2himajin merged commit 29934e1 into master Mar 25, 2026
2 checks passed
@penta2himajin penta2himajin deleted the claude/refactor-solidion-api-hLIpu branch March 25, 2026 16:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants