@slicemedia/create-devkit 0.2.0 → 0.3.0

package/dist/scaffold.js

@@ -89,7 +89,7 @@ export function createProjectSlider(
         integrationFile: "src/integrations/animations.ts",
         renderIntegration: () => `import { gsap } from "gsap";
 
-/** Project-owned GSAP entry point. Import this module from main.ts when the composition is ready. */
+/** Project-owned GSAP integration. Import only from the addon/project entry that needs it. */
 export { gsap };
 `,
     },

package/dist/template/README.md

@@ -11,10 +11,33 @@ starter is deliberately neutral: no optional capability is imported by `src/main
 4. Import only the generated files under `src/integrations/` that the project is ready to compose.
 5. Run `pnpm typecheck` and `pnpm build`.
 
-The build emits one project-owned ES2018 IIFE at `dist/project.js` and, when styles are imported,
-`dist/project.css`. `pnpm catalog -- --json` inspects the single project entry. Use
+Create each public browser entry in `src/addons/<name>.ts` or `src/addons/<name>/index.ts`.
+The build emits separate standalone ES2018 scripts at `dist/addons/<name>.js` and optional
+`dist/addons/<name>.css`. Shared helpers belong outside these entry paths or in `_`-prefixed files.
+New addons are discovered automatically alongside entries configured in `devkit.config.json`.
+`pnpm catalog -- --json` inspects all public entries. Use
 `pnpm devkit -- <command>` for other DevKit commands.
 
+Run `pnpm devkit -- explain <name>` for an addon's Webflow setup guide and local testing tags. Add
+`--public-base-url` with the deployed asset base URL for production JS/CSS tags. Load only the
+scripts needed on each page. The optional neutral `src/main.ts` entry builds separately to
+`dist/projects/project.js` and optional CSS; remove its config entry if no shared project script
+is needed. It does not import or collect addon entries.
+
+Each addon entry explicitly initializes its behavior and registers its API with the shared
+DevKit runtime. Inline scripts can then use `window.slicemediaDevKit.counter.refresh()` or
+`window.slicemediaDevKit.whenReady("counter", callback)`. Keep package definitions inert; put
+browser initialization in the public entry. The build also writes `dist/webflow-scripts.json`
+with the actual script and stylesheet paths.
+
+`pnpm build -- --sourcemap` generates private JavaScript maps in `.slicemedia/sourcemaps/`, outside
+`dist/`. Deploy only `dist/`; keep debugging artifacts private. The production bundle contains no
+map references. Browser JavaScript itself remains publicly inspectable.
+
+The repository documentation includes an optional worked example at
+[`docs/examples/on-demand-counter`](https://github.com/slicemedia/devkit/tree/main/docs/examples/on-demand-counter).
+Example features are not copied into generated projects.
+
 The project-owned `WEBFLOW_PROJECT.md` is always present. If agent targets were selected, run
 `pnpm agents:generate` after installation. Slice Media Agent Kit preserves that guide and creates
 only the requested Codex, Claude, Cursor, Copilot, or Webflow files; it is maintained in a separate

package/dist/template/WEBFLOW_PROJECT.md

@@ -1,13 +1,19 @@
 # Webflow project guidance
 
 Webflow owns editable structure, components, styles, CMS content, forms, and native interactions.
-This project owns only the browser enhancements explicitly composed in `src/main.ts`.
+This project owns only explicitly authored browser enhancements. Put each public addon entry in
+`src/addons/<name>.ts` or `src/addons/<name>/index.ts`; each builds to its own
+`dist/addons/<name>.js` and optional stylesheet. Load only the scripts needed on each Webflow page.
+Use `src/main.ts` or `src/projects/` only for optional, deliberately composed project behavior.
 
 - Prefer native Webflow features before adding code.
 - Use documented, scoped `data-wft-*` hooks instead of generated classes or guessed identifiers.
 - Keep optional files under `src/integrations/` disconnected until their markup contract is ready.
 - Make initialization idempotent and restore owned DOM, attributes, listeners, observers, and timers
   during teardown.
+- Install the shared DevKit runtime explicitly and register each public addon API after successful
+  initialization. Inline scripts can use `window.slicemediaDevKit.whenReady(name, callback)` and
+  direct named access such as `window.slicemediaDevKit.counter.refresh()`.
 - Inspect before remote work. Webflow writes and publishing require an explicit request, review,
   read-back, and verification through the official Webflow MCP server.
 

package/dist/template/devkit.config.json

@@ -2,13 +2,30 @@
   "entries": [
     {
       "name": "project",
+      "kind": "project",
       "input": "src/main.ts",
       "version": "0.1.0",
-      "description": "Project-owned Webflow browser entry.",
+      "description": "Optional project-wide browser entry; addons build independently.",
       "placement": "body-end",
       "dependencies": [],
       "attributes": [],
       "scriptAttributes": {},
+      "bundle": {
+        "input": "src/main.ts",
+        "scriptFile": "projects/project.js",
+        "cssFile": "projects/project.css"
+      },
+      "usage": {
+        "setup": [
+          "Author the required markup and data-wft-* hooks in Webflow.",
+          "Create standalone browser entries under src/addons/ and document their contracts.",
+          "Use src/project.ts only for deliberately shared project behavior; it is optional.",
+          "Run the local dev server and test only the scripts needed on an approved Webflow testing page."
+        ],
+        "notes": [
+          "The starter has no feature behavior. Remove this entry if no project-wide script is needed; addon discovery remains active."
+        ]
+      },
       "api": {
         "entry": "webflow-project",
         "capabilities": []

package/dist/template/package.json

@@ -6,7 +6,7 @@
   "type": "module",
   "packageManager": "pnpm@11.21.0",
   "scripts": {
-    "build": "slicemedia-devkit build --entry src/main.ts --out-dir dist --script-file project.js --css-file project.css",
+    "build": "slicemedia-devkit build",
     "catalog": "slicemedia-devkit catalog --root .",
     "dev": "slicemedia-devkit dev",
     "sanitize": "slicemedia-devkit sanitize --root .",

package/dist/versions.generated.d.ts

@@ -1,8 +1,8 @@
 /** Generated by scripts/sync-versions.mjs. Do not edit by hand. */
-export declare const DEVKIT_PACKAGE_VERSION = "0.2.0";
-export declare const DEFAULT_DEVKIT_VERSION_RANGE = "^0.2.0";
+export declare const DEVKIT_PACKAGE_VERSION = "0.3.0";
+export declare const DEFAULT_DEVKIT_VERSION_RANGE = "^0.3.0";
 export declare const EXTERNAL_PRODUCT_VERSION_RANGES: {
-    readonly agentKit: "^0.1.0";
+    readonly agentKit: "^0.2.0";
     readonly swiperAdapter: "^0.1.0";
     readonly spacesDeployer: "^0.2.0";
 };

package/dist/versions.generated.js

@@ -1,8 +1,8 @@
 /** Generated by scripts/sync-versions.mjs. Do not edit by hand. */
-export const DEVKIT_PACKAGE_VERSION = "0.2.0";
-export const DEFAULT_DEVKIT_VERSION_RANGE = "^0.2.0";
+export const DEVKIT_PACKAGE_VERSION = "0.3.0";
+export const DEFAULT_DEVKIT_VERSION_RANGE = "^0.3.0";
 export const EXTERNAL_PRODUCT_VERSION_RANGES = {
-    agentKit: "^0.1.0",
+    agentKit: "^0.2.0",
     swiperAdapter: "^0.1.0",
     spacesDeployer: "^0.2.0",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slicemedia/create-devkit",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Interactive project wizard for Slice Media DevKit.",
   "author": "Slice Media",
   "repository": {