@twobirds/microcomponents 0.8.0 → 0.9.0

package/dist/cli/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;EAkBE;AAUF;;;;;;;;;;EAUE;AACF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC7B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;EAYE;AACF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CA0BhE"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;EAkBE;AAUF;;;;;;;;;;EAUE;AACF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC7B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;EAYE;AACF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CA2BhE"}

package/dist/cli/create.js

@@ -63,6 +63,7 @@ export function scaffoldProject(namespace) {
     files['vite.config.ts'] = viteConfig(namespace);
     files['.gitignore'] = gitignore();
     files['opencode.jsonc'] = opencodeConfig();
+    files['.opencode/skills/components/SKILL.md'] = componentSkill(namespace, tag);
     files['README.md'] = readme(namespace, tag);
     files['src/index.html'] = prodShell(tag);
     files['src/index-dev.html'] = devShell(namespace, tag);
@@ -84,7 +85,7 @@ function packageJson(namespace) {
             typecheck: 'tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.vc.json',
         },
         dependencies: {
-            '@twobirds/microcomponents': '^0.8.0',
+            '@twobirds/microcomponents': '^0.9.0',
         },
         devDependencies: {
             vite: '^8.1.5',
@@ -144,6 +145,86 @@ function opencodeConfig() {
         },
     }, null, '\t');
 }
+function componentSkill(namespace, tag) {
+    return `---
+name: components
+description: Use when adding, editing, naming, or wiring a micro component in this project, registering a component in the bundle, choosing an event dispatch target, running dev or build, or touching build/ or public/.
+---
+
+# Micro Components project
+
+Namespace \`${namespace}\`. Every tag starts with \`${namespace}-\`. Components live in \`src/${namespace}/\` and the starter is \`<${tag}>\`.
+
+## The chain
+
+\`src/\` → \`build/\` → \`public/\`
+
+- \`src/\` is the only folder to edit.
+- \`build/\` is the \`tsc\` output plus mirrored companion assets, served by the dev server. Generated.
+- \`public/\` is the production site: \`bundle.js\` with companion assets inlined, \`bundle.css\`, \`index.html\`. Generated.
+
+Never edit, rename, or delete anything under \`build/\` or \`public/\`. Change \`src/\` and rebuild.
+
+## Add a component
+
+\`\`\`sh
+npx mc new ${namespace}-name --target-html --target-css
+\`\`\`
+
+The tag must be kebab-case with at least one hyphen. \`ns-name\` becomes \`src/ns/name.ts\`: the first hyphen becomes the folder, which is the same rule the autoloader uses.
+
+Register the component so the production bundle picks it up:
+
+\`\`\`ts
+// src/${namespace}/bundle.ts
+import './name.js';
+\`\`\`
+
+A component missing from the barrel loads in dev through \`autoload()\` but is absent from \`public/bundle.js\`.
+
+## Companion assets
+
+A camelCase descriptor maps to a dotted filename and is listed in \`static assets\`:
+
+| descriptor | file | role |
+| --- | --- | --- |
+| \`css\` | \`name.css\` | document-level tokens under \`:root\` |
+| \`targetCss\` | \`name.target.css\` | styles scoped to the host tag |
+| \`shadowCss\` | \`name.shadow.css\` | styles inside the shadow root |
+| \`html\` | \`name.html\` | light-DOM template |
+| \`targetHtml\` | \`name.target.html\` | template for \`target.innerHTML\`, \`{key}\` tokens filled by \`parse()\` |
+| \`shadowHtml\` | \`name.shadow.html\` | template for \`shadowRoot.innerHTML\` |
+
+The loader fetches exactly the listed descriptors, so every entry in \`static assets\` needs its file.
+
+## Events
+
+Prefer a direct target with the default local dispatch and a typed payload:
+
+\`\`\`ts
+target.dispatchEvent(
+	new CustomEvent('${namespace}:action', { detail: { data: { id: 'x' } } })
+);
+\`\`\`
+
+Bubble up or down the tree only when the receiver cannot be named.
+
+## Verify
+
+\`\`\`sh
+pnpm typecheck
+pnpm dev
+pnpm build
+pnpm preview
+\`\`\`
+
+\`mc clean\` removes \`build/\`, \`public/\` and \`coverage/\`.
+
+## API reference
+
+The \`microcomponents\` MCP server registered in \`opencode.jsonc\` documents every export, the event system, and the concept essays. Query it instead of guessing an API.
+`;
+}
 function readme(namespace, tag) {
     return `# ${namespace} App
 
@@ -201,6 +282,10 @@ npx mc new ${namespace}-name --target-html --target-css
 \`\`\`
 
 Then add its import to \`src/${namespace}/bundle.ts\` so the production bundle picks it up.
+
+\`.opencode/skills/components/SKILL.md\` carries the same rules for opencode: the
+\`src/\` → \`build/\` → \`public/\` chain, the asset descriptors, the bundle registration,
+and the event dispatch preference.
 `;
 }
 function viteConfig(namespace) {

package/dist/mcp/api.json

@@ -1,5 +1,5 @@
 {
-  "libraryVersion": "0.8.0",
+  "libraryVersion": "0.9.0",
   "exportedCount": 42,
   "entries": {
     "MC": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twobirds/microcomponents",
-	"version": "0.8.0",
+	"version": "0.9.0",
 	"description": "Micro Components",
 	"keywords": [
 		"PWA",