@contractspec/example.learning-journey-studio-onboarding 1.56.1 → 1.58.0

package/.turbo/turbo-build.log

@@ -1,46 +1,47 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-studio-onboarding/tsdown.config.js 
-ℹ entry: src/example.ts, src/index.ts, src/learning-journey-studio-onboarding.feature.ts, src/track.ts, src/docs/index.ts, src/docs/studio-onboarding.docblock.ts, src/handlers/demo.handlers.ts, src/operations/index.ts, src/presentations/index.ts, src/tests/operations.test-spec.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ dist/operations/index.js                                  4.34 kB │ gzip: 1.08 kB
-ℹ dist/track.js                                             2.43 kB │ gzip: 0.91 kB
-ℹ dist/learning-journey-studio-onboarding.feature.js        1.84 kB │ gzip: 0.62 kB
-ℹ dist/docs/studio-onboarding.docblock.js                   1.67 kB │ gzip: 0.83 kB
-ℹ dist/presentations/index.js                               1.63 kB │ gzip: 0.61 kB
-ℹ dist/index.js                                             1.10 kB │ gzip: 0.31 kB
-ℹ dist/example.js                                           1.04 kB │ gzip: 0.55 kB
-ℹ dist/tests/operations.test-spec.js                        0.92 kB │ gzip: 0.42 kB
-ℹ dist/handlers/demo.handlers.js                            0.83 kB │ gzip: 0.41 kB
-ℹ dist/docs/index.js                                        0.04 kB │ gzip: 0.06 kB
-ℹ dist/operations/index.js.map                              6.42 kB │ gzip: 1.59 kB
-ℹ dist/track.js.map                                         3.79 kB │ gzip: 1.24 kB
-ℹ dist/learning-journey-studio-onboarding.feature.js.map    2.92 kB │ gzip: 1.04 kB
-ℹ dist/presentations/index.js.map                           2.35 kB │ gzip: 0.90 kB
-ℹ dist/docs/studio-onboarding.docblock.js.map               2.10 kB │ gzip: 1.00 kB
-ℹ dist/handlers/demo.handlers.js.map                        1.58 kB │ gzip: 0.71 kB
-ℹ dist/example.js.map                                       1.47 kB │ gzip: 0.74 kB
-ℹ dist/tests/operations.test-spec.js.map                    1.46 kB │ gzip: 0.62 kB
-ℹ dist/operations/index.d.ts.map                            0.84 kB │ gzip: 0.32 kB
-ℹ dist/handlers/demo.handlers.d.ts.map                      0.60 kB │ gzip: 0.33 kB
-ℹ dist/learning-journey-studio-onboarding.feature.d.ts.map  0.22 kB │ gzip: 0.16 kB
-ℹ dist/presentations/index.d.ts.map                         0.21 kB │ gzip: 0.17 kB
-ℹ dist/tests/operations.test-spec.d.ts.map                  0.17 kB │ gzip: 0.14 kB
-ℹ dist/example.d.ts.map                                     0.14 kB │ gzip: 0.13 kB
-ℹ dist/track.d.ts.map                                       0.14 kB │ gzip: 0.13 kB
-ℹ dist/operations/index.d.ts                                8.83 kB │ gzip: 0.93 kB
-ℹ dist/index.d.ts                                           1.07 kB │ gzip: 0.29 kB
-ℹ dist/handlers/demo.handlers.d.ts                          0.97 kB │ gzip: 0.42 kB
-ℹ dist/presentations/index.d.ts                             0.56 kB │ gzip: 0.22 kB
-ℹ dist/learning-journey-studio-onboarding.feature.d.ts      0.52 kB │ gzip: 0.27 kB
-ℹ dist/track.d.ts                                           0.36 kB │ gzip: 0.20 kB
-ℹ dist/tests/operations.test-spec.d.ts                      0.28 kB │ gzip: 0.18 kB
-ℹ dist/example.d.ts                                         0.25 kB │ gzip: 0.17 kB
-ℹ dist/docs/index.d.ts                                      0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/studio-onboarding.docblock.d.ts                 0.01 kB │ gzip: 0.03 kB
-ℹ 35 files, total: 53.11 kB
-✔ Build complete in 27474ms
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=10
+Bundled 10 modules in 29ms
+
+  docs/index.js                                     1.71 KB   (entry point)
+  tests/operations.test-spec.js                     0.92 KB   (entry point)
+  ./index.js                                        13.26 KB  (entry point)
+  docs/studio-onboarding.docblock.js                1.71 KB   (entry point)
+  ./example.js                                      1.0 KB    (entry point)
+  handlers/demo.handlers.js                         3.23 KB   (entry point)
+  ./learning-journey-studio-onboarding.feature.js   1.55 KB   (entry point)
+  presentations/index.js                            8.17 KB   (entry point)
+  operations/index.js                               6.74 KB   (entry point)
+  ./track.js                                        2.58 KB   (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=10
+Bundled 10 modules in 46ms
+
+  docs/index.js                                     1.67 KB   (entry point)
+  tests/operations.test-spec.js                     0.91 KB   (entry point)
+  ./index.js                                        13.22 KB  (entry point)
+  docs/studio-onboarding.docblock.js                1.67 KB   (entry point)
+  ./example.js                                      1.00 KB   (entry point)
+  handlers/demo.handlers.js                         3.22 KB   (entry point)
+  ./learning-journey-studio-onboarding.feature.js   1.55 KB   (entry point)
+  presentations/index.js                            8.16 KB   (entry point)
+  operations/index.js                               6.73 KB   (entry point)
+  ./track.js                                        2.58 KB   (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=10
+Bundled 10 modules in 36ms
+
+  docs/index.js                                     1.67 KB   (entry point)
+  tests/operations.test-spec.js                     0.91 KB   (entry point)
+  ./index.js                                        13.22 KB  (entry point)
+  docs/studio-onboarding.docblock.js                1.67 KB   (entry point)
+  ./example.js                                      1.00 KB   (entry point)
+  handlers/demo.handlers.js                         3.22 KB   (entry point)
+  ./learning-journey-studio-onboarding.feature.js   1.55 KB   (entry point)
+  presentations/index.js                            8.16 KB   (entry point)
+  operations/index.js                               6.73 KB   (entry point)
+  ./track.js                                        2.58 KB   (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @contractspec/example.learning-journey-studio-onboarding
 
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/module.learning-journey@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+  - @contractspec/lib.schema@1.58.0
+
+## 1.57.0
+
+### Minor Changes
+
+- 11a5a05: feat: improve product intent
+
+### Patch Changes
+
+- Updated dependencies [8ecf3c1]
+- Updated dependencies [47c48c2]
+- Updated dependencies [a119963]
+- Updated dependencies [4651e06]
+- Updated dependencies [ad9d10a]
+- Updated dependencies [11a5a05]
+  - @contractspec/lib.contracts@1.57.0
+  - @contractspec/module.learning-journey@1.57.0
+  - @contractspec/lib.schema@1.57.0
+
 ## 1.56.1
 
 ### Patch Changes

package/dist/browser/docs/index.js

@@ -0,0 +1,35 @@
+// src/docs/studio-onboarding.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts";
+var studioOnboardingDocBlocks = [
+  {
+    id: "docs.learning-journey.studio-onboarding",
+    title: "Learning Journey — Studio Getting Started",
+    summary: "Track that guides a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/learning-journey/studio-onboarding",
+    tags: ["learning", "onboarding", "studio"],
+    body: `## Track
+- **Key**: \`studio_getting_started\`
+- **Persona**: new Studio developer, first 30 minutes
+- **Goal**: instantiate template → edit spec → regenerate → play → run evolution
+
+## Steps & Events
+1) \`choose_template\` → event \`studio.template.instantiated\`
+2) \`edit_spec\` → event \`spec.changed\` (scope: sandbox)
+3) \`regenerate_app\` → event \`regeneration.completed\`
+4) \`play_in_playground\` → event \`playground.session.started\`
+5) \`try_evolution_mode\` → event \`studio.evolution.applied\`
+
+XP: 20/20/20/20/30 with bonus 25 XP if completed within 48h (streak rule). Badge: \`studio_first_30m\`.
+
+## Wiring
+- Tracks export from \`@contractspec/example.learning-journey-studio-onboarding/track\`.
+- Use onboarding API:
+  - \`learning.onboarding.listTracks\` to surface catalog
+  - \`learning.onboarding.getProgress\` to render progress
+  - \`learning.onboarding.recordEvent\` to advance from bus events
+- Events should be emitted by Studio surfaces (template creation, spec save, regeneration, playground session start, evolution apply).`
+  }
+];
+registerDocBlocks(studioOnboardingDocBlocks);

package/dist/browser/docs/studio-onboarding.docblock.js

@@ -0,0 +1,35 @@
+// src/docs/studio-onboarding.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts";
+var studioOnboardingDocBlocks = [
+  {
+    id: "docs.learning-journey.studio-onboarding",
+    title: "Learning Journey — Studio Getting Started",
+    summary: "Track that guides a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/learning-journey/studio-onboarding",
+    tags: ["learning", "onboarding", "studio"],
+    body: `## Track
+- **Key**: \`studio_getting_started\`
+- **Persona**: new Studio developer, first 30 minutes
+- **Goal**: instantiate template → edit spec → regenerate → play → run evolution
+
+## Steps & Events
+1) \`choose_template\` → event \`studio.template.instantiated\`
+2) \`edit_spec\` → event \`spec.changed\` (scope: sandbox)
+3) \`regenerate_app\` → event \`regeneration.completed\`
+4) \`play_in_playground\` → event \`playground.session.started\`
+5) \`try_evolution_mode\` → event \`studio.evolution.applied\`
+
+XP: 20/20/20/20/30 with bonus 25 XP if completed within 48h (streak rule). Badge: \`studio_first_30m\`.
+
+## Wiring
+- Tracks export from \`@contractspec/example.learning-journey-studio-onboarding/track\`.
+- Use onboarding API:
+  - \`learning.onboarding.listTracks\` to surface catalog
+  - \`learning.onboarding.getProgress\` to render progress
+  - \`learning.onboarding.recordEvent\` to advance from bus events
+- Events should be emitted by Studio surfaces (template creation, spec save, regeneration, playground session start, evolution apply).`
+  }
+];
+registerDocBlocks(studioOnboardingDocBlocks);

package/dist/browser/example.js

@@ -0,0 +1,32 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "learning-journey-studio-onboarding",
+    version: "1.0.0",
+    title: "Learning Journey — Studio Getting Started",
+    description: "Onboarding track guiding a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.",
+    kind: "template",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["learning", "onboarding", "studio"]
+  },
+  docs: {
+    rootDocId: "docs.learning-journey.studio-onboarding"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.learning-journey-studio-onboarding",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["playground", "markdown"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/browser/handlers/demo.handlers.js

@@ -0,0 +1,107 @@
+// src/track.ts
+var studioGettingStartedTrack = {
+  id: "studio_getting_started",
+  productId: "contractspec-studio",
+  name: "Studio Getting Started",
+  description: "First 30 minutes in Studio: create a project, edit the spec, deploy/regenerate, and try key modules.",
+  targetUserSegment: "new_studio_user",
+  targetRole: "developer",
+  totalXp: 110,
+  streakRule: { hoursWindow: 48, bonusXp: 25 },
+  completionRewards: { xpBonus: 25, badgeKey: "studio_first_30m" },
+  steps: [
+    {
+      id: "choose_template",
+      title: "Choose a template",
+      description: "Create your first Studio project (starter template).",
+      order: 1,
+      completion: {
+        eventName: "studio.template.instantiated",
+        sourceModule: "@contractspec/bundle.studio"
+      },
+      xpReward: 20,
+      metadata: { surface: "projects" }
+    },
+    {
+      id: "edit_spec",
+      title: "Edit the spec",
+      description: "Change the spec (not generated code) and save.",
+      instructions: "Open spec editor, tweak a contract or presentation, save.",
+      order: 2,
+      completion: {
+        eventName: "spec.changed",
+        sourceModule: "@contractspec/bundle.studio"
+      },
+      xpReward: 20,
+      metadata: { surface: "spec-editor" }
+    },
+    {
+      id: "regenerate_app",
+      title: "Regenerate the app",
+      description: "Regenerate artifacts from the updated spec.",
+      order: 3,
+      completion: {
+        eventName: "regeneration.completed",
+        sourceModule: "@contractspec/lib.contracts/regenerator"
+      },
+      xpReward: 20,
+      metadata: { surface: "regenerator" }
+    },
+    {
+      id: "open_canvas",
+      title: "Open the canvas",
+      description: "Visit the canvas module for your project.",
+      order: 4,
+      completion: {
+        eventName: "module.navigated",
+        sourceModule: "@contractspec/bundle.studio",
+        payloadFilter: { moduleId: "canvas" }
+      },
+      xpReward: 20,
+      metadata: { surface: "canvas" }
+    },
+    {
+      id: "try_evolution_mode",
+      title: "Try evolution mode",
+      description: "Request a change via Evolution, then regenerate.",
+      order: 5,
+      completion: {
+        eventName: "studio.evolution.applied",
+        sourceModule: "@contractspec/lib.evolution"
+      },
+      xpReward: 30,
+      metadata: { surface: "evolution" }
+    }
+  ],
+  metadata: {
+    persona: "first_run",
+    surfacedIn: ["studio/home", "studio/sidebar/learning"]
+  }
+};
+var studioLearningTracks = [
+  studioGettingStartedTrack
+];
+
+// src/handlers/demo.handlers.ts
+var studioOnboardingEvents = [
+  "studio.template.instantiated",
+  "spec.changed",
+  "regeneration.completed",
+  "playground.session.started",
+  "studio.evolution.applied"
+];
+var emitStudioOnboardingEvent = (eventName, { learnerId, occurredAt = new Date }, record) => {
+  const event = {
+    learnerId,
+    name: eventName,
+    occurredAt,
+    trackId: studioGettingStartedTrack.id
+  };
+  return record ? record(event) : event;
+};
+var emitAllStudioOnboardingEvents = (params, record) => studioOnboardingEvents.map((name) => emitStudioOnboardingEvent(name, params, record));
+export {
+  studioOnboardingEvents,
+  emitStudioOnboardingEvent,
+  emitAllStudioOnboardingEvents
+};