Feature/component scaffold

.stan/system/.docs.meta.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.4.0"
+  "version": "0.5.6"
 }

.stan/system/stan.project.md

@@ -0,0 +1,50 @@
+# stan.project.md — Project-specific requirements
+
+When updated: 2025-08-29T00:00:00Z
+
+Repository goal
+
+- Provide a ready-to-use template for building and publishing React 18
+  component libraries using TypeScript.
+
+Baseline decisions
+
+- React
+  - Target React 18.
+  - Use the modern “react-jsx” runtime.
+- Build outputs
+  - ESM-only. No CJS or IIFE bundles.
+  - ship types (.d.ts).
+- Dependencies
+  - react and react-dom are peerDependencies (>=18).
+  - Also present as devDependencies for local development and playground.
+  - Mark package as "sideEffects": false (no global CSS side-effects).
+- Linting
+  - TS-only rules; no react-specific eslint plugins for now.
+  - Ignore playground/\*\* from lint to avoid dev-only noise.
+  - Flat config in eslint.config.ts (TypeScript), executed via
+    `node --loader tsx` in npm scripts.
+  - Tests linted with Vitest recommended rules (non type-checked).
+- Testing
+  - Vitest with happy-dom environment (project default).
+  - @testing-library/react and @testing-library/jest-dom for component tests.
+  - jest-dom is registered via vitest.setup.ts.
+- Dev preview
+  - Vite playground under /playground for interactive browser viewing.
+  - Playground is excluded from npm package (files: ["dist"]) and from
+    typecheck/lint.
+- Source layout
+  - Components under src/components.
+  - Public entry at src/index.ts re-exports components.
+- Removed legacy pieces
+  - CLI example and related build logic removed.
+  - No IIFE browser bundle.
+- Docs
+  - Keep TypeDoc for API docs; entry remains src/index.ts.
+
+Operational notes
+
+- Rollup marks react and react/jsx-runtime as externals.
+- Keep release and docs scripts; they may be adjusted later as needed.
+- Consider adding Storybook or Ladle later if richer docs are required.
+

.stan/system/stan.todo.md

@@ -0,0 +1,35 @@
+When updated: 2025-08-31T00:00:00Z
+
+Next up
+
+- Run: npm install to ensure new devDependencies (react, react-dom,
+  @types/react, @types/react-dom, vite, @vitejs/plugin-react,
+  @testing-library/\*, tsx) are installed before running test/docs/typecheck.
+- Optionally add story tooling (Storybook or Ladle) if docs scale up.
+- Consider pruning unused devDependencies flagged by knip.
+
+Completed (recent)
+
+- Added tests for library entry re-exports and HelloWorld edge cases.
+- Tuned Vitest coverage to exclude docs/, dist/, and playground/ by default.
+- Updated README test section with entry re-export example and coverage notes.
+- Updated README to reflect React component template usage and features.
+- Replaced eslint.config.js with eslint.config.ts (flat config), updated
+  npm scripts to run ESLint via node --loader tsx.
+- Scoped linting to avoid type-aware parse errors; ignore playground;
+  tests use Vitest recommended rules (non type-checked).
+- Excluded tests and playground from ts typecheck; removed jest-dom types from tsconfig to prevent build/docs errors if not installed.
+- Excluded .rollup.cache from Vitest to avoid stale compiled tests.
+- Excluded playground from lint/typecheck to reduce false positives.
+- Added vitest.setup.ts and configured jest-dom globally.
+- Fixed unsafe return by typing HelloWorld return to JSX.Element.
+- Sorted imports and simplified tests.
+- Updated stan.config.yml to use standard build script.
+- Converted template to React 18 with react-jsx runtime.
+- Switched to ESM-only build; removed CJS/IIFE and CLI scaffold.
+- Added Vite playground under /playground for browser preview.
+- Added HelloWorld component + tests (Testing Library).
+- Marked react/react-dom as peerDependencies; set sideEffects: false.
+- Updated rollup config to externalize react & react/jsx-runtime.
+- Kept TypeDoc; preserved Vitest + happy-dom environment.
+- Updated package/repository metadata placeholders.

docs/assets/highlight.css

@@ -7,10 +7,22 @@
     --dark-hl-2: #CE9178;
     --light-hl-3: #008000;
     --dark-hl-3: #6A9955;
-    --light-hl-4: #0000FF;
-    --dark-hl-4: #569CD6;
-    --light-hl-5: #AF00DB;
-    --dark-hl-5: #C586C0;
+    --light-hl-4: #AF00DB;
+    --dark-hl-4: #C586C0;
+    --light-hl-5: #0000FF;
+    --dark-hl-5: #569CD6;
+    --light-hl-6: #267F99;
+    --dark-hl-6: #4EC9B0;
+    --light-hl-7: #001080;
+    --dark-hl-7: #9CDCFE;
+    --light-hl-8: #800000;
+    --dark-hl-8: #808080;
+    --light-hl-9: #800000;
+    --dark-hl-9: #569CD6;
+    --light-hl-10: #E50000;
+    --dark-hl-10: #9CDCFE;
+    --light-hl-11: #0451A5;
+    --dark-hl-11: #9CDCFE;
     --light-code-background: #FFFFFF;
     --dark-code-background: #1E1E1E;
 }
@@ -22,6 +34,12 @@
     --hl-3: var(--light-hl-3);
     --hl-4: var(--light-hl-4);
     --hl-5: var(--light-hl-5);
+    --hl-6: var(--light-hl-6);
+    --hl-7: var(--light-hl-7);
+    --hl-8: var(--light-hl-8);
+    --hl-9: var(--light-hl-9);
+    --hl-10: var(--light-hl-10);
+    --hl-11: var(--light-hl-11);
     --code-background: var(--light-code-background);
 } }
 
@@ -32,6 +50,12 @@
     --hl-3: var(--dark-hl-3);
     --hl-4: var(--dark-hl-4);
     --hl-5: var(--dark-hl-5);
+    --hl-6: var(--dark-hl-6);
+    --hl-7: var(--dark-hl-7);
+    --hl-8: var(--dark-hl-8);
+    --hl-9: var(--dark-hl-9);
+    --hl-10: var(--dark-hl-10);
+    --hl-11: var(--dark-hl-11);
     --code-background: var(--dark-code-background);
 } }
 
@@ -42,6 +66,12 @@
     --hl-3: var(--light-hl-3);
     --hl-4: var(--light-hl-4);
     --hl-5: var(--light-hl-5);
+    --hl-6: var(--light-hl-6);
+    --hl-7: var(--light-hl-7);
+    --hl-8: var(--light-hl-8);
+    --hl-9: var(--light-hl-9);
+    --hl-10: var(--light-hl-10);
+    --hl-11: var(--light-hl-11);
     --code-background: var(--light-code-background);
 }
 
@@ -52,6 +82,12 @@
     --hl-3: var(--dark-hl-3);
     --hl-4: var(--dark-hl-4);
     --hl-5: var(--dark-hl-5);
+    --hl-6: var(--dark-hl-6);
+    --hl-7: var(--dark-hl-7);
+    --hl-8: var(--dark-hl-8);
+    --hl-9: var(--dark-hl-9);
+    --hl-10: var(--dark-hl-10);
+    --hl-11: var(--dark-hl-11);
     --code-background: var(--dark-code-background);
 }
 
@@ -61,4 +97,10 @@
 .hl-3 { color: var(--hl-3); }
 .hl-4 { color: var(--hl-4); }
 .hl-5 { color: var(--hl-5); }
+.hl-6 { color: var(--hl-6); }
+.hl-7 { color: var(--hl-7); }
+.hl-8 { color: var(--hl-8); }
+.hl-9 { color: var(--hl-9); }
+.hl-10 { color: var(--hl-10); }
+.hl-11 { color: var(--hl-11); }
 pre, code { background: var(--code-background); }