@contractspec/example.learning-journey-studio-onboarding 1.44.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/.turbo/turbo-build$colon$bundle.log +41 -0
  2. package/.turbo/turbo-build.log +42 -0
  3. package/CHANGELOG.md +178 -0
  4. package/LICENSE +21 -0
  5. package/README.md +41 -0
  6. package/dist/docs/index.d.ts +1 -0
  7. package/dist/docs/index.js +1 -0
  8. package/dist/docs/studio-onboarding.docblock.d.ts +1 -0
  9. package/dist/docs/studio-onboarding.docblock.js +40 -0
  10. package/dist/docs/studio-onboarding.docblock.js.map +1 -0
  11. package/dist/example.d.ts +33 -0
  12. package/dist/example.d.ts.map +1 -0
  13. package/dist/example.js +35 -0
  14. package/dist/example.js.map +1 -0
  15. package/dist/handlers/demo.handlers.d.ts +23 -0
  16. package/dist/handlers/demo.handlers.d.ts.map +1 -0
  17. package/dist/handlers/demo.handlers.js +24 -0
  18. package/dist/handlers/demo.handlers.js.map +1 -0
  19. package/dist/index.d.ts +7 -0
  20. package/dist/index.js +9 -0
  21. package/dist/learning-journey-studio-onboarding.feature.d.ts +12 -0
  22. package/dist/learning-journey-studio-onboarding.feature.d.ts.map +1 -0
  23. package/dist/learning-journey-studio-onboarding.feature.js +68 -0
  24. package/dist/learning-journey-studio-onboarding.feature.js.map +1 -0
  25. package/dist/operations/index.d.ts +271 -0
  26. package/dist/operations/index.d.ts.map +1 -0
  27. package/dist/operations/index.js +176 -0
  28. package/dist/operations/index.js.map +1 -0
  29. package/dist/presentations/index.d.ts +9 -0
  30. package/dist/presentations/index.d.ts.map +1 -0
  31. package/dist/presentations/index.js +57 -0
  32. package/dist/presentations/index.js.map +1 -0
  33. package/dist/track.d.ts +8 -0
  34. package/dist/track.d.ts.map +1 -0
  35. package/dist/track.js +91 -0
  36. package/dist/track.js.map +1 -0
  37. package/example.ts +1 -0
  38. package/package.json +67 -0
  39. package/src/docs/index.ts +1 -0
  40. package/src/docs/studio-onboarding.docblock.ts +38 -0
  41. package/src/example.ts +24 -0
  42. package/src/handlers/demo.handlers.ts +48 -0
  43. package/src/index.ts +7 -0
  44. package/src/learning-journey-studio-onboarding.feature.ts +66 -0
  45. package/src/operations/index.test.ts +49 -0
  46. package/src/operations/index.ts +122 -0
  47. package/src/presentations/index.ts +57 -0
  48. package/src/track.ts +86 -0
  49. package/tsconfig.json +9 -0
  50. package/tsconfig.tsbuildinfo +1 -0
  51. package/tsdown.config.js +17 -0
@@ -0,0 +1,41 @@
1
+ $ tsdown
2
+ ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
3
+ ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-studio-onboarding/tsdown.config.js
4
+ ℹ 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
5
+ ℹ target: esnext
6
+ ℹ tsconfig: tsconfig.json
7
+ ℹ Build start
8
+ ℹ Cleaning 35 files
9
+ ℹ dist/operations/index.js 4.33 kB │ gzip: 1.07 kB
10
+ ℹ dist/track.js 2.43 kB │ gzip: 0.91 kB
11
+ ℹ dist/docs/studio-onboarding.docblock.js 1.67 kB │ gzip: 0.83 kB
12
+ ℹ dist/learning-journey-studio-onboarding.feature.js 1.57 kB │ gzip: 0.55 kB
13
+ ℹ dist/presentations/index.js 1.56 kB │ gzip: 0.59 kB
14
+ ℹ dist/index.js 1.10 kB │ gzip: 0.31 kB
15
+ ℹ dist/example.js 0.86 kB │ gzip: 0.47 kB
16
+ ℹ dist/handlers/demo.handlers.js 0.83 kB │ gzip: 0.41 kB
17
+ ℹ dist/docs/index.js 0.04 kB │ gzip: 0.06 kB
18
+ ℹ dist/operations/index.js.map 6.41 kB │ gzip: 1.59 kB
19
+ ℹ dist/track.js.map 3.89 kB │ gzip: 1.25 kB
20
+ ℹ dist/learning-journey-studio-onboarding.feature.js.map 2.89 kB │ gzip: 1.03 kB
21
+ ℹ dist/presentations/index.js.map 2.56 kB │ gzip: 0.89 kB
22
+ ℹ dist/docs/studio-onboarding.docblock.js.map 2.10 kB │ gzip: 1.00 kB
23
+ ℹ dist/handlers/demo.handlers.js.map 1.61 kB │ gzip: 0.72 kB
24
+ ℹ dist/example.js.map 1.21 kB │ gzip: 0.64 kB
25
+ ℹ dist/operations/index.d.ts.map 0.84 kB │ gzip: 0.32 kB
26
+ ℹ dist/handlers/demo.handlers.d.ts.map 0.60 kB │ gzip: 0.33 kB
27
+ ℹ dist/learning-journey-studio-onboarding.feature.d.ts.map 0.20 kB │ gzip: 0.15 kB
28
+ ℹ dist/presentations/index.d.ts.map 0.19 kB │ gzip: 0.16 kB
29
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
30
+ ℹ dist/track.d.ts.map 0.14 kB │ gzip: 0.13 kB
31
+ ℹ dist/operations/index.d.ts 8.83 kB │ gzip: 0.93 kB
32
+ ℹ dist/example.d.ts 1.09 kB │ gzip: 0.46 kB
33
+ ℹ dist/index.d.ts 1.07 kB │ gzip: 0.29 kB
34
+ ℹ dist/handlers/demo.handlers.d.ts 0.97 kB │ gzip: 0.42 kB
35
+ ℹ dist/learning-journey-studio-onboarding.feature.d.ts 0.48 kB │ gzip: 0.26 kB
36
+ ℹ dist/presentations/index.d.ts 0.47 kB │ gzip: 0.21 kB
37
+ ℹ dist/track.d.ts 0.36 kB │ gzip: 0.20 kB
38
+ ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
39
+ ℹ dist/docs/studio-onboarding.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
40
+ ℹ 31 files, total: 50.46 kB
41
+ ✔ Build complete in 19120ms
@@ -0,0 +1,42 @@
1
+ $ bun build:types && bun build:bundle
2
+ $ tsc --noEmit
3
+ $ tsdown
4
+ ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
5
+ ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-studio-onboarding/tsdown.config.js
6
+ ℹ 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
7
+ ℹ target: esnext
8
+ ℹ tsconfig: tsconfig.json
9
+ ℹ Build start
10
+ ℹ dist/operations/index.js 4.33 kB │ gzip: 1.07 kB
11
+ ℹ dist/track.js 2.43 kB │ gzip: 0.91 kB
12
+ ℹ dist/docs/studio-onboarding.docblock.js 1.67 kB │ gzip: 0.83 kB
13
+ ℹ dist/learning-journey-studio-onboarding.feature.js 1.57 kB │ gzip: 0.55 kB
14
+ ℹ dist/presentations/index.js 1.56 kB │ gzip: 0.59 kB
15
+ ℹ dist/index.js 1.10 kB │ gzip: 0.31 kB
16
+ ℹ dist/example.js 0.86 kB │ gzip: 0.47 kB
17
+ ℹ dist/handlers/demo.handlers.js 0.83 kB │ gzip: 0.41 kB
18
+ ℹ dist/docs/index.js 0.04 kB │ gzip: 0.06 kB
19
+ ℹ dist/operations/index.js.map 6.41 kB │ gzip: 1.59 kB
20
+ ℹ dist/track.js.map 3.89 kB │ gzip: 1.25 kB
21
+ ℹ dist/learning-journey-studio-onboarding.feature.js.map 2.89 kB │ gzip: 1.03 kB
22
+ ℹ dist/presentations/index.js.map 2.56 kB │ gzip: 0.89 kB
23
+ ℹ dist/docs/studio-onboarding.docblock.js.map 2.10 kB │ gzip: 1.00 kB
24
+ ℹ dist/handlers/demo.handlers.js.map 1.61 kB │ gzip: 0.72 kB
25
+ ℹ dist/example.js.map 1.21 kB │ gzip: 0.64 kB
26
+ ℹ dist/operations/index.d.ts.map 0.84 kB │ gzip: 0.32 kB
27
+ ℹ dist/handlers/demo.handlers.d.ts.map 0.60 kB │ gzip: 0.33 kB
28
+ ℹ dist/learning-journey-studio-onboarding.feature.d.ts.map 0.20 kB │ gzip: 0.15 kB
29
+ ℹ dist/presentations/index.d.ts.map 0.19 kB │ gzip: 0.16 kB
30
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
31
+ ℹ dist/track.d.ts.map 0.14 kB │ gzip: 0.13 kB
32
+ ℹ dist/operations/index.d.ts 8.83 kB │ gzip: 0.93 kB
33
+ ℹ dist/example.d.ts 1.09 kB │ gzip: 0.46 kB
34
+ ℹ dist/index.d.ts 1.07 kB │ gzip: 0.29 kB
35
+ ℹ dist/handlers/demo.handlers.d.ts 0.97 kB │ gzip: 0.42 kB
36
+ ℹ dist/learning-journey-studio-onboarding.feature.d.ts 0.48 kB │ gzip: 0.26 kB
37
+ ℹ dist/presentations/index.d.ts 0.47 kB │ gzip: 0.21 kB
38
+ ℹ dist/track.d.ts 0.36 kB │ gzip: 0.20 kB
39
+ ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
40
+ ℹ dist/docs/studio-onboarding.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
41
+ ℹ 31 files, total: 50.46 kB
42
+ ✔ Build complete in 21294ms
package/CHANGELOG.md ADDED
@@ -0,0 +1,178 @@
1
+ # @contractspec/example.learning-journey-studio-onboarding
2
+
3
+ ## 1.44.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 5f3a868: chore: isolate branding to contractspec.io
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [5f3a868]
12
+ - @contractspec/module.learning-journey@1.44.0
13
+ - @contractspec/lib.contracts@1.44.0
14
+ - @contractspec/lib.schema@1.44.0
15
+
16
+ ## 1.43.3
17
+
18
+ ### Patch Changes
19
+
20
+ - 9216062: fix: cross-platform compatibility
21
+ - Updated dependencies [9216062]
22
+ - @contractspec/module.learning-journey@1.43.4
23
+ - @contractspec/lib.contracts@1.43.4
24
+ - @contractspec/lib.schema@1.43.3
25
+
26
+ ## 1.43.2
27
+
28
+ ### Patch Changes
29
+
30
+ - 24d9759: improve documentation
31
+ - Updated dependencies [24d9759]
32
+ - @contractspec/module.learning-journey@1.43.3
33
+ - @contractspec/lib.contracts@1.43.3
34
+ - @contractspec/lib.schema@1.43.2
35
+
36
+ ## 1.43.2
37
+
38
+ ### Patch Changes
39
+
40
+ - e147271: fix: improve stability
41
+ - Updated dependencies [e147271]
42
+ - @contractspec/module.learning-journey@1.43.2
43
+ - @contractspec/lib.contracts@1.43.2
44
+ - @contractspec/lib.schema@1.43.1
45
+
46
+ ## 1.43.1
47
+
48
+ ### Patch Changes
49
+
50
+ - Updated dependencies [f28fdad]
51
+ - @contractspec/lib.contracts@1.43.1
52
+ - @contractspec/module.learning-journey@1.43.1
53
+
54
+ ## 1.43.0
55
+
56
+ ### Minor Changes
57
+
58
+ - 042d072: feat: schema declaration using json schema, including zod
59
+
60
+ ### Patch Changes
61
+
62
+ - Updated dependencies [042d072]
63
+ - @contractspec/module.learning-journey@1.43.0
64
+ - @contractspec/lib.contracts@1.43.0
65
+ - @contractspec/lib.schema@1.43.0
66
+
67
+ ## 1.42.10
68
+
69
+ ### Patch Changes
70
+
71
+ - 1e6a0f1: fix: mcp server
72
+ - Updated dependencies [1e6a0f1]
73
+ - @contractspec/module.learning-journey@1.42.10
74
+ - @contractspec/lib.contracts@1.42.10
75
+ - @contractspec/lib.schema@1.42.10
76
+
77
+ ## 1.42.9
78
+
79
+ ### Patch Changes
80
+
81
+ - 9281db7: fix ModelRegistry
82
+ - Updated dependencies [9281db7]
83
+ - @contractspec/module.learning-journey@1.42.9
84
+ - @contractspec/lib.contracts@1.42.9
85
+ - @contractspec/lib.schema@1.42.9
86
+
87
+ ## 1.42.8
88
+
89
+ ### Patch Changes
90
+
91
+ - e07b5ac: fix
92
+ - Updated dependencies [e07b5ac]
93
+ - @contractspec/module.learning-journey@1.42.8
94
+ - @contractspec/lib.contracts@1.42.8
95
+ - @contractspec/lib.schema@1.42.8
96
+
97
+ ## 1.42.7
98
+
99
+ ### Patch Changes
100
+
101
+ - e9b575d: fix release
102
+ - Updated dependencies [e9b575d]
103
+ - @contractspec/module.learning-journey@1.42.7
104
+ - @contractspec/lib.contracts@1.42.7
105
+ - @contractspec/lib.schema@1.42.7
106
+
107
+ ## 1.42.6
108
+
109
+ ### Patch Changes
110
+
111
+ - 1500242: fix tooling
112
+ - Updated dependencies [1500242]
113
+ - @contractspec/module.learning-journey@1.42.6
114
+ - @contractspec/lib.contracts@1.42.6
115
+ - @contractspec/lib.schema@1.42.6
116
+
117
+ ## 1.42.5
118
+
119
+ ### Patch Changes
120
+
121
+ - 1299719: fix vscode
122
+ - Updated dependencies [1299719]
123
+ - @contractspec/module.learning-journey@1.42.5
124
+ - @contractspec/lib.contracts@1.42.5
125
+ - @contractspec/lib.schema@1.42.5
126
+
127
+ ## 1.42.4
128
+
129
+ ### Patch Changes
130
+
131
+ - ac28b99: fix: generate from openapi
132
+ - Updated dependencies [ac28b99]
133
+ - @contractspec/module.learning-journey@1.42.4
134
+ - @contractspec/lib.contracts@1.42.4
135
+ - @contractspec/lib.schema@1.42.4
136
+
137
+ ## 1.42.3
138
+
139
+ ### Patch Changes
140
+
141
+ - 3f5d015: fix(tooling): cicd
142
+ - Updated dependencies [3f5d015]
143
+ - @contractspec/lib.contracts@1.42.3
144
+ - @contractspec/lib.schema@1.42.3
145
+ - @contractspec/module.learning-journey@1.42.3
146
+
147
+ ## 1.42.2
148
+
149
+ ### Patch Changes
150
+
151
+ - 1f9ac4c: fix
152
+ - Updated dependencies [1f9ac4c]
153
+ - @contractspec/lib.contracts@1.42.2
154
+ - @contractspec/lib.schema@1.42.2
155
+ - @contractspec/module.learning-journey@1.42.2
156
+
157
+ ## 1.42.1
158
+
159
+ ### Patch Changes
160
+
161
+ - f043995: Fix release
162
+ - Updated dependencies [f043995]
163
+ - @contractspec/module.learning-journey@1.42.1
164
+ - @contractspec/lib.contracts@1.42.1
165
+ - @contractspec/lib.schema@1.42.1
166
+
167
+ ## 1.42.0
168
+
169
+ ### Minor Changes
170
+
171
+ - 8eefd9c: initial release
172
+
173
+ ### Patch Changes
174
+
175
+ - Updated dependencies [8eefd9c]
176
+ - @contractspec/lib.contracts@1.42.0
177
+ - @contractspec/lib.schema@1.42.0
178
+ - @contractspec/module.learning-journey@1.42.0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Chaman Ventures, SASU
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,41 @@
1
+ # @contractspec/example.learning-journey-studio-onboarding
2
+
3
+ Website: https://contractspec.io/
4
+
5
+
6
+ Learning Journey example focused on the first 30 minutes inside ContractSpec Studio.
7
+
8
+ ## Track
9
+
10
+ - **Key**: `studio_getting_started`
11
+ - **Persona**: new Studio developer
12
+ - **XP**: 20/20/20/20/30 + 25 bonus within 48h
13
+ - **Badge**: `studio_first_30m`
14
+
15
+ ## Steps & Events
16
+
17
+ 1. `choose_template` → `studio.template.instantiated`
18
+ 2. `edit_spec` → `spec.changed` (scope: sandbox)
19
+ 3. `regenerate_app` → `regeneration.completed`
20
+ 4. `play_in_playground` → `playground.session.started`
21
+ 5. `try_evolution_mode` → `studio.evolution.applied`
22
+
23
+ ## Usage
24
+
25
+ - Import track specs:
26
+ `import { studioLearningTracks } from '@contractspec/example.learning-journey-studio-onboarding/track'`
27
+ - Contracts/handlers for demos:
28
+ `import { GetStudioOnboardingTrack, RecordStudioOnboardingEvent } from '@contractspec/example.learning-journey-studio-onboarding/contracts'`
29
+ `import { emitStudioOnboardingEvent } from '@contractspec/example.learning-journey-studio-onboarding/handlers/demo.handlers'`
30
+ - Presentations (react/markdown/json targets):
31
+ `import { studioOnboardingPresentations } from '@contractspec/example.learning-journey-studio-onboarding/presentations'`
32
+ - Register with Learning Journey surfaces via onboarding API:
33
+ - `learning.onboarding.listTracks` to surface catalog
34
+ - `learning.onboarding.getProgress` to show status
35
+ - `learning.onboarding.recordEvent` in event-bus handlers to advance steps
36
+ - Wire events from Studio surfaces (template spawn, spec save, regeneration, playground session start, evolution apply) to `recordEvent`.
37
+
38
+ ## Docs
39
+
40
+ - Docblock: `src/docs/studio-onboarding.docblock.ts`
41
+ - Route suggestion: `/docs/learning-journey/studio-onboarding`
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1 @@
1
+ import "./studio-onboarding.docblock.js";
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1,40 @@
1
+ import { registerDocBlocks } from "@contractspec/lib.contracts";
2
+
3
+ //#region src/docs/studio-onboarding.docblock.ts
4
+ registerDocBlocks([{
5
+ id: "docs.learning-journey.studio-onboarding",
6
+ title: "Learning Journey — Studio Getting Started",
7
+ summary: "Track that guides a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.",
8
+ kind: "reference",
9
+ visibility: "public",
10
+ route: "/docs/learning-journey/studio-onboarding",
11
+ tags: [
12
+ "learning",
13
+ "onboarding",
14
+ "studio"
15
+ ],
16
+ body: `## Track
17
+ - **Key**: \`studio_getting_started\`
18
+ - **Persona**: new Studio developer, first 30 minutes
19
+ - **Goal**: instantiate template → edit spec → regenerate → play → run evolution
20
+
21
+ ## Steps & Events
22
+ 1) \`choose_template\` → event \`studio.template.instantiated\`
23
+ 2) \`edit_spec\` → event \`spec.changed\` (scope: sandbox)
24
+ 3) \`regenerate_app\` → event \`regeneration.completed\`
25
+ 4) \`play_in_playground\` → event \`playground.session.started\`
26
+ 5) \`try_evolution_mode\` → event \`studio.evolution.applied\`
27
+
28
+ XP: 20/20/20/20/30 with bonus 25 XP if completed within 48h (streak rule). Badge: \`studio_first_30m\`.
29
+
30
+ ## Wiring
31
+ - Tracks export from \`@contractspec/example.learning-journey-studio-onboarding/track\`.
32
+ - Use onboarding API:
33
+ - \`learning.onboarding.listTracks\` to surface catalog
34
+ - \`learning.onboarding.getProgress\` to render progress
35
+ - \`learning.onboarding.recordEvent\` to advance from bus events
36
+ - Events should be emitted by Studio surfaces (template creation, spec save, regeneration, playground session start, evolution apply).`
37
+ }]);
38
+
39
+ //#endregion
40
+ //# sourceMappingURL=studio-onboarding.docblock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-onboarding.docblock.js","names":[],"sources":["../../src/docs/studio-onboarding.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts';\nimport { registerDocBlocks } from '@contractspec/lib.contracts';\n\nconst studioOnboardingDocBlocks: DocBlock[] = [\n {\n id: 'docs.learning-journey.studio-onboarding',\n title: 'Learning Journey — Studio Getting Started',\n summary:\n 'Track that guides a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.',\n kind: 'reference',\n visibility: 'public',\n route: '/docs/learning-journey/studio-onboarding',\n tags: ['learning', 'onboarding', 'studio'],\n body: `## Track\n- **Key**: \\`studio_getting_started\\`\n- **Persona**: new Studio developer, first 30 minutes\n- **Goal**: instantiate template → edit spec → regenerate → play → run evolution\n\n## Steps & Events\n1) \\`choose_template\\` → event \\`studio.template.instantiated\\`\n2) \\`edit_spec\\` → event \\`spec.changed\\` (scope: sandbox)\n3) \\`regenerate_app\\` → event \\`regeneration.completed\\`\n4) \\`play_in_playground\\` → event \\`playground.session.started\\`\n5) \\`try_evolution_mode\\` → event \\`studio.evolution.applied\\`\n\nXP: 20/20/20/20/30 with bonus 25 XP if completed within 48h (streak rule). Badge: \\`studio_first_30m\\`.\n\n## Wiring\n- Tracks export from \\`@contractspec/example.learning-journey-studio-onboarding/track\\`.\n- Use onboarding API:\n - \\`learning.onboarding.listTracks\\` to surface catalog\n - \\`learning.onboarding.getProgress\\` to render progress\n - \\`learning.onboarding.recordEvent\\` to advance from bus events\n- Events should be emitted by Studio surfaces (template creation, spec save, regeneration, playground session start, evolution apply).`,\n },\n];\n\nregisterDocBlocks(studioOnboardingDocBlocks);\n"],"mappings":";;;AAqCA,kBAlC8C,CAC5C;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAY;EAAc;EAAS;CAC1C,MAAM;;;;;;;;;;;;;;;;;;;;;CAqBP,CACF,CAE2C"}
@@ -0,0 +1,33 @@
1
+ //#region src/example.d.ts
2
+ declare const example: {
3
+ readonly id: "learning-journey-studio-onboarding";
4
+ readonly title: "Learning Journey — Studio Getting Started";
5
+ readonly summary: "Onboarding track guiding a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.";
6
+ readonly tags: readonly ["learning", "onboarding", "studio"];
7
+ readonly kind: "template";
8
+ readonly visibility: "public";
9
+ readonly docs: {
10
+ readonly rootDocId: "docs.learning-journey.studio-onboarding";
11
+ };
12
+ readonly entrypoints: {
13
+ readonly packageName: "@contractspec/example.learning-journey-studio-onboarding";
14
+ readonly docs: "./docs";
15
+ };
16
+ readonly surfaces: {
17
+ readonly templates: true;
18
+ readonly sandbox: {
19
+ readonly enabled: true;
20
+ readonly modes: readonly ["playground", "markdown"];
21
+ };
22
+ readonly studio: {
23
+ readonly enabled: true;
24
+ readonly installable: true;
25
+ };
26
+ readonly mcp: {
27
+ readonly enabled: true;
28
+ };
29
+ };
30
+ };
31
+ //#endregion
32
+ export { example as default };
33
+ //# sourceMappingURL=example.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EAqBI,EAAA,oCAAA"}
@@ -0,0 +1,35 @@
1
+ //#region src/example.ts
2
+ const example = {
3
+ id: "learning-journey-studio-onboarding",
4
+ title: "Learning Journey — Studio Getting Started",
5
+ summary: "Onboarding track guiding a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.",
6
+ tags: [
7
+ "learning",
8
+ "onboarding",
9
+ "studio"
10
+ ],
11
+ kind: "template",
12
+ visibility: "public",
13
+ docs: { rootDocId: "docs.learning-journey.studio-onboarding" },
14
+ entrypoints: {
15
+ packageName: "@contractspec/example.learning-journey-studio-onboarding",
16
+ docs: "./docs"
17
+ },
18
+ surfaces: {
19
+ templates: true,
20
+ sandbox: {
21
+ enabled: true,
22
+ modes: ["playground", "markdown"]
23
+ },
24
+ studio: {
25
+ enabled: true,
26
+ installable: true
27
+ },
28
+ mcp: { enabled: true }
29
+ }
30
+ };
31
+ var example_default = example;
32
+
33
+ //#endregion
34
+ export { example_default as default };
35
+ //# sourceMappingURL=example.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n id: 'learning-journey-studio-onboarding',\n title: 'Learning Journey — Studio Getting Started',\n summary:\n 'Onboarding track guiding a new Studio user through template spawn, spec edit, regeneration, playground, and evolution.',\n tags: ['learning', 'onboarding', 'studio'],\n kind: 'template',\n visibility: 'public',\n docs: {\n rootDocId: 'docs.learning-journey.studio-onboarding',\n },\n entrypoints: {\n packageName: '@contractspec/example.learning-journey-studio-onboarding',\n docs: './docs',\n },\n surfaces: {\n templates: true,\n sandbox: { enabled: true, modes: ['playground', 'markdown'] },\n studio: { enabled: true, installable: true },\n mcp: { enabled: true },\n },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAY;EAAc;EAAS;CAC1C,MAAM;CACN,YAAY;CACZ,MAAM,EACJ,WAAW,2CACZ;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,cAAc,WAAW;GAAE;EAC7D,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}
@@ -0,0 +1,23 @@
1
+ //#region src/handlers/demo.handlers.d.ts
2
+ interface EmitParams {
3
+ learnerId: string;
4
+ occurredAt?: Date;
5
+ }
6
+ interface LearningJourneyEvent {
7
+ learnerId: string;
8
+ name: string;
9
+ occurredAt: Date;
10
+ trackId: string;
11
+ payload?: Record<string, unknown>;
12
+ }
13
+ type RecordEvent = (event: LearningJourneyEvent) => unknown;
14
+ declare const studioOnboardingEvents: readonly ["studio.template.instantiated", "spec.changed", "regeneration.completed", "playground.session.started", "studio.evolution.applied"];
15
+ type StudioEvent = (typeof studioOnboardingEvents)[number];
16
+ declare const emitStudioOnboardingEvent: (eventName: StudioEvent, {
17
+ learnerId,
18
+ occurredAt
19
+ }: EmitParams, record?: RecordEvent) => unknown;
20
+ declare const emitAllStudioOnboardingEvents: (params: EmitParams, record?: RecordEvent) => unknown[];
21
+ //#endregion
22
+ export { StudioEvent, emitAllStudioOnboardingEvents, emitStudioOnboardingEvent, studioOnboardingEvents };
23
+ //# sourceMappingURL=demo.handlers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"demo.handlers.d.ts","names":[],"sources":["../../src/handlers/demo.handlers.ts"],"sourcesContent":[],"mappings":";UAEU,UAAA;EAAA,SAAA,EAAA,MAAU;EAKV,UAAA,CAAA,EAHK,IAGL;AAKQ;AAKlB,UAVU,oBAAA,CAgBA;EAEE,SAAA,EAAA,MAAW;EAEV,IAAA,EAAA,MAAA;EACA,UAAA,EAlBC,IAkBD;EACX,OAAA,EAAA,MAAA;EAAA,OAAA,CAAA,EAjBU,MAiBV,CAAA,MAAA,EAAA,OAAA,CAAA;;KAdG,WAAA,GAeM,CAAA,KAAA,EAfgB,oBAehB,EAAA,GAAA,OAAA;AAAW,cAbT,sBAaS,EAAA,SAAA,CAAA,8BAAA,EAAA,cAAA,EAAA,wBAAA,EAAA,4BAAA,EAAA,0BAAA,CAAA;AAWT,KAhBD,WAAA,GAgBC,CAAA,OAhBqB,sBAiBxB,CAAA,CAAA,MACC,CAAA;cAhBE,uCACA;;;GAC6B,qBAC/B;cAWE,wCACH,qBACC"}
@@ -0,0 +1,24 @@
1
+ import { studioGettingStartedTrack } from "../track.js";
2
+
3
+ //#region src/handlers/demo.handlers.ts
4
+ const studioOnboardingEvents = [
5
+ "studio.template.instantiated",
6
+ "spec.changed",
7
+ "regeneration.completed",
8
+ "playground.session.started",
9
+ "studio.evolution.applied"
10
+ ];
11
+ const emitStudioOnboardingEvent = (eventName, { learnerId, occurredAt = /* @__PURE__ */ new Date() }, record) => {
12
+ const event = {
13
+ learnerId,
14
+ name: eventName,
15
+ occurredAt,
16
+ trackId: studioGettingStartedTrack.id
17
+ };
18
+ return record ? record(event) : event;
19
+ };
20
+ const emitAllStudioOnboardingEvents = (params, record) => studioOnboardingEvents.map((name) => emitStudioOnboardingEvent(name, params, record));
21
+
22
+ //#endregion
23
+ export { emitAllStudioOnboardingEvents, emitStudioOnboardingEvent, studioOnboardingEvents };
24
+ //# sourceMappingURL=demo.handlers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"demo.handlers.js","names":["event: LearningJourneyEvent"],"sources":["../../src/handlers/demo.handlers.ts"],"sourcesContent":["import { studioGettingStartedTrack } from '../track';\n\ninterface EmitParams {\n learnerId: string;\n occurredAt?: Date;\n}\n\ninterface LearningJourneyEvent {\n learnerId: string;\n name: string;\n occurredAt: Date;\n trackId: string;\n payload?: Record<string, unknown>;\n}\n\ntype RecordEvent = (event: LearningJourneyEvent) => unknown;\n\nexport const studioOnboardingEvents = [\n 'studio.template.instantiated',\n 'spec.changed',\n 'regeneration.completed',\n 'playground.session.started',\n 'studio.evolution.applied',\n] as const;\n\nexport type StudioEvent = (typeof studioOnboardingEvents)[number];\n\nexport const emitStudioOnboardingEvent = (\n eventName: StudioEvent,\n { learnerId, occurredAt = new Date() }: EmitParams,\n record?: RecordEvent\n) => {\n const event: LearningJourneyEvent = {\n learnerId,\n name: eventName,\n occurredAt,\n trackId: studioGettingStartedTrack.id,\n };\n return record ? record(event) : event;\n};\n\nexport const emitAllStudioOnboardingEvents = (\n params: EmitParams,\n record?: RecordEvent\n) =>\n studioOnboardingEvents.map((name) =>\n emitStudioOnboardingEvent(name, params, record)\n );\n"],"mappings":";;;AAiBA,MAAa,yBAAyB;CACpC;CACA;CACA;CACA;CACA;CACD;AAID,MAAa,6BACX,WACA,EAAE,WAAW,6BAAa,IAAI,MAAM,IACpC,WACG;CACH,MAAMA,QAA8B;EAClC;EACA,MAAM;EACN;EACA,SAAS,0BAA0B;EACpC;AACD,QAAO,SAAS,OAAO,MAAM,GAAG;;AAGlC,MAAa,iCACX,QACA,WAEA,uBAAuB,KAAK,SAC1B,0BAA0B,MAAM,QAAQ,OAAO,CAChD"}
@@ -0,0 +1,7 @@
1
+ import example from "./example.js";
2
+ import { StudioEvent, emitAllStudioOnboardingEvents, emitStudioOnboardingEvent, studioOnboardingEvents } from "./handlers/demo.handlers.js";
3
+ import { studioGettingStartedTrack, studioLearningTracks } from "./track.js";
4
+ import { GetStudioOnboardingTrack, RecordStudioOnboardingEvent, StudioOnboardingTrackModel, studioOnboardingContracts } from "./operations/index.js";
5
+ import { StudioOnboardingTrackPresentation, StudioOnboardingWidgetPresentation, studioOnboardingPresentations } from "./presentations/index.js";
6
+ import { LearningJourneyStudioOnboardingFeature } from "./learning-journey-studio-onboarding.feature.js";
7
+ export { GetStudioOnboardingTrack, LearningJourneyStudioOnboardingFeature, RecordStudioOnboardingEvent, StudioEvent, StudioOnboardingTrackModel, StudioOnboardingTrackPresentation, StudioOnboardingWidgetPresentation, emitAllStudioOnboardingEvents, emitStudioOnboardingEvent, example, studioGettingStartedTrack, studioLearningTracks, studioOnboardingContracts, studioOnboardingEvents, studioOnboardingPresentations };
package/dist/index.js ADDED
@@ -0,0 +1,9 @@
1
+ import example_default from "./example.js";
2
+ import { studioGettingStartedTrack, studioLearningTracks } from "./track.js";
3
+ import "./docs/index.js";
4
+ import { GetStudioOnboardingTrack, RecordStudioOnboardingEvent, StudioOnboardingTrackModel, studioOnboardingContracts } from "./operations/index.js";
5
+ import { emitAllStudioOnboardingEvents, emitStudioOnboardingEvent, studioOnboardingEvents } from "./handlers/demo.handlers.js";
6
+ import { StudioOnboardingTrackPresentation, StudioOnboardingWidgetPresentation, studioOnboardingPresentations } from "./presentations/index.js";
7
+ import { LearningJourneyStudioOnboardingFeature } from "./learning-journey-studio-onboarding.feature.js";
8
+
9
+ export { GetStudioOnboardingTrack, LearningJourneyStudioOnboardingFeature, RecordStudioOnboardingEvent, StudioOnboardingTrackModel, StudioOnboardingTrackPresentation, StudioOnboardingWidgetPresentation, emitAllStudioOnboardingEvents, emitStudioOnboardingEvent, example_default as example, studioGettingStartedTrack, studioLearningTracks, studioOnboardingContracts, studioOnboardingEvents, studioOnboardingPresentations };
@@ -0,0 +1,12 @@
1
+ import { FeatureModuleSpec } from "@contractspec/lib.contracts";
2
+
3
+ //#region src/learning-journey-studio-onboarding.feature.d.ts
4
+
5
+ /**
6
+ * Learning Journey Studio Onboarding feature module that bundles
7
+ * Studio-specific onboarding track operations and presentations.
8
+ */
9
+ declare const LearningJourneyStudioOnboardingFeature: FeatureModuleSpec;
10
+ //#endregion
11
+ export { LearningJourneyStudioOnboardingFeature };
12
+ //# sourceMappingURL=learning-journey-studio-onboarding.feature.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"learning-journey-studio-onboarding.feature.d.ts","names":[],"sources":["../src/learning-journey-studio-onboarding.feature.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAWa,wCAAwC"}
@@ -0,0 +1,68 @@
1
+ //#region src/learning-journey-studio-onboarding.feature.ts
2
+ /**
3
+ * Learning Journey Studio Onboarding feature module that bundles
4
+ * Studio-specific onboarding track operations and presentations.
5
+ */
6
+ const LearningJourneyStudioOnboardingFeature = {
7
+ meta: {
8
+ key: "learning-journey-studio-onboarding",
9
+ title: "Learning Journey: Studio Onboarding",
10
+ description: "Studio onboarding journey for getting started with ContractSpec Studio",
11
+ domain: "learning-journey",
12
+ owners: ["@examples.learning-journey.studio-onboarding"],
13
+ tags: [
14
+ "learning",
15
+ "onboarding",
16
+ "studio",
17
+ "journey"
18
+ ],
19
+ stability: "experimental",
20
+ version: 1
21
+ },
22
+ operations: [{
23
+ key: "learningJourney.studioOnboarding.recordEvent",
24
+ version: 1
25
+ }, {
26
+ key: "learningJourney.studioOnboarding.getTrack",
27
+ version: 1
28
+ }],
29
+ events: [],
30
+ presentations: [{
31
+ key: "learning.journey.studio.track",
32
+ version: 1
33
+ }, {
34
+ key: "learning.journey.studio.widget",
35
+ version: 1
36
+ }],
37
+ opToPresentation: [{
38
+ op: {
39
+ key: "learningJourney.studioOnboarding.getTrack",
40
+ version: 1
41
+ },
42
+ pres: {
43
+ key: "learning.journey.studio.track",
44
+ version: 1
45
+ }
46
+ }],
47
+ presentationsTargets: [{
48
+ key: "learning.journey.studio.track",
49
+ version: 1,
50
+ targets: [
51
+ "react",
52
+ "markdown",
53
+ "application/json"
54
+ ]
55
+ }, {
56
+ key: "learning.journey.studio.widget",
57
+ version: 1,
58
+ targets: ["react"]
59
+ }],
60
+ capabilities: { requires: [{
61
+ key: "identity",
62
+ version: 1
63
+ }] }
64
+ };
65
+
66
+ //#endregion
67
+ export { LearningJourneyStudioOnboardingFeature };
68
+ //# sourceMappingURL=learning-journey-studio-onboarding.feature.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"learning-journey-studio-onboarding.feature.js","names":["LearningJourneyStudioOnboardingFeature: FeatureModuleSpec"],"sources":["../src/learning-journey-studio-onboarding.feature.ts"],"sourcesContent":["/**\n * Learning Journey Studio Onboarding Feature Module Specification\n *\n * Defines the feature module for Studio onboarding journey.\n */\nimport type { FeatureModuleSpec } from '@contractspec/lib.contracts';\n\n/**\n * Learning Journey Studio Onboarding feature module that bundles\n * Studio-specific onboarding track operations and presentations.\n */\nexport const LearningJourneyStudioOnboardingFeature: FeatureModuleSpec = {\n meta: {\n key: 'learning-journey-studio-onboarding',\n title: 'Learning Journey: Studio Onboarding',\n description:\n 'Studio onboarding journey for getting started with ContractSpec Studio',\n domain: 'learning-journey',\n owners: ['@examples.learning-journey.studio-onboarding'],\n tags: ['learning', 'onboarding', 'studio', 'journey'],\n stability: 'experimental',\n version: 1,\n },\n\n // All contract operations included in this feature\n operations: [\n { key: 'learningJourney.studioOnboarding.recordEvent', version: 1 },\n { key: 'learningJourney.studioOnboarding.getTrack', version: 1 },\n ],\n\n // Events emitted by this feature\n events: [],\n\n // Presentations associated with this feature\n presentations: [\n { key: 'learning.journey.studio.track', version: 1 },\n { key: 'learning.journey.studio.widget', version: 1 },\n ],\n\n // Link operations to their primary presentations\n opToPresentation: [\n {\n op: { key: 'learningJourney.studioOnboarding.getTrack', version: 1 },\n pres: { key: 'learning.journey.studio.track', version: 1 },\n },\n ],\n\n // Target requirements for multi-surface rendering\n presentationsTargets: [\n {\n key: 'learning.journey.studio.track',\n version: 1,\n targets: ['react', 'markdown', 'application/json'],\n },\n {\n key: 'learning.journey.studio.widget',\n version: 1,\n targets: ['react'],\n },\n ],\n\n // Capability requirements\n capabilities: {\n requires: [{ key: 'identity', version: 1 }],\n },\n};\n"],"mappings":";;;;;AAWA,MAAaA,yCAA4D;CACvE,MAAM;EACJ,KAAK;EACL,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,+CAA+C;EACxD,MAAM;GAAC;GAAY;GAAc;GAAU;GAAU;EACrD,WAAW;EACX,SAAS;EACV;CAGD,YAAY,CACV;EAAE,KAAK;EAAgD,SAAS;EAAG,EACnE;EAAE,KAAK;EAA6C,SAAS;EAAG,CACjE;CAGD,QAAQ,EAAE;CAGV,eAAe,CACb;EAAE,KAAK;EAAiC,SAAS;EAAG,EACpD;EAAE,KAAK;EAAkC,SAAS;EAAG,CACtD;CAGD,kBAAkB,CAChB;EACE,IAAI;GAAE,KAAK;GAA6C,SAAS;GAAG;EACpE,MAAM;GAAE,KAAK;GAAiC,SAAS;GAAG;EAC3D,CACF;CAGD,sBAAsB,CACpB;EACE,KAAK;EACL,SAAS;EACT,SAAS;GAAC;GAAS;GAAY;GAAmB;EACnD,EACD;EACE,KAAK;EACL,SAAS;EACT,SAAS,CAAC,QAAQ;EACnB,CACF;CAGD,cAAc,EACZ,UAAU,CAAC;EAAE,KAAK;EAAY,SAAS;EAAG,CAAC,EAC5C;CACF"}