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

package/dist/presentations/index.js

@@ -1,57 +1,251 @@
-import { StudioOnboardingTrackModel } from "../operations/index.js";
-import { StabilityEnum, definePresentation } from "@contractspec/lib.contracts";
+// @bun
+// 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
+];
 
-//#region src/presentations/index.ts
-const baseMeta = {
-	domain: "learning-journey",
-	title: "Studio Onboarding",
-	owners: ["@examples.learning-journey.studio-onboarding"],
-	tags: [
-		"learning",
-		"onboarding",
-		"studio"
-	],
-	stability: StabilityEnum.Experimental
+// src/operations/index.ts
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts";
+var OWNERS = ["examples.learning-journey.studio-onboarding"];
+var StepModel = defineSchemaModel({
+  name: "StudioOnboardingStep",
+  description: "Step metadata for Studio onboarding journey",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    completionEvent: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    sourceModule: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    xpReward: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    order: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true }
+  }
+});
+var StudioOnboardingTrackModel = defineSchemaModel({
+  name: "StudioOnboardingTrack",
+  description: "Studio onboarding track definition",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    totalXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    completionXpBonus: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true
+    },
+    completionBadgeKey: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    streakHoursWindow: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true
+    },
+    streakBonusXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    steps: { type: StepModel, isArray: true, isOptional: false }
+  }
+});
+var TrackResponseModel = defineSchemaModel({
+  name: "StudioOnboardingTrackResponse",
+  description: "Response wrapper for studio onboarding track",
+  fields: {
+    track: { type: StudioOnboardingTrackModel, isOptional: false }
+  }
+});
+var RecordDemoEventInput = defineSchemaModel({
+  name: "StudioOnboardingRecordEventInput",
+  description: "Emit a demo event to advance Studio onboarding steps",
+  fields: {
+    learnerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    eventName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    payload: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    occurredAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
+  }
+});
+var SuccessModel = defineSchemaModel({
+  name: "StudioOnboardingSuccess",
+  description: "Generic success response",
+  fields: {
+    success: { type: ScalarTypeEnum.Boolean(), isOptional: false }
+  }
+});
+var GetStudioOnboardingTrack = defineQuery({
+  meta: {
+    key: "learningJourney.studioOnboarding.getTrack",
+    version: "1.0.0",
+    stability: "experimental",
+    owners: [...OWNERS],
+    tags: ["learning", "onboarding", "studio"],
+    description: "Fetch the Studio onboarding track definition.",
+    goal: "Expose track metadata to UIs and templates.",
+    context: "Called by Studio/Playground to render journey steps."
+  },
+  io: {
+    input: defineSchemaModel({
+      name: "StudioOnboardingTrackInput",
+      description: "Track input",
+      fields: {}
+    }),
+    output: TrackResponseModel
+  },
+  policy: { auth: "user" }
+});
+var RecordStudioOnboardingEvent = defineCommand({
+  meta: {
+    key: "learningJourney.studioOnboarding.recordEvent",
+    version: "1.0.0",
+    stability: "experimental",
+    owners: [...OWNERS],
+    tags: ["learning", "onboarding", "studio"],
+    description: "Record an event to advance Studio onboarding progress.",
+    goal: "Advance steps via domain events in demo/sandbox contexts.",
+    context: "Called by handlers or demo scripts to emit step completion events."
+  },
+  io: {
+    input: RecordDemoEventInput,
+    output: SuccessModel
+  },
+  policy: { auth: "user" }
+});
+var studioOnboardingContracts = {
+  GetStudioOnboardingTrack,
+  RecordStudioOnboardingEvent,
+  track: studioGettingStartedTrack
 };
-const StudioOnboardingTrackPresentation = definePresentation({
-	meta: {
-		key: "learning.journey.studio.track",
-		version: "1.0.0",
-		description: "Studio onboarding track detail",
-		goal: "Visualize the onboarding track for the user.",
-		context: "Displayed in the Studio dashboard.",
-		...baseMeta
-	},
-	source: {
-		type: "component",
-		framework: "react",
-		componentKey: "LearningTrackDetail",
-		props: StudioOnboardingTrackModel
-	},
-	targets: [
-		"react",
-		"markdown",
-		"application/json"
-	]
-});
-const StudioOnboardingWidgetPresentation = definePresentation({
-	meta: {
-		key: "learning.journey.studio.widget",
-		version: "1.0.0",
-		description: "Compact widget for Studio onboarding progress",
-		goal: "Show quick progress summary.",
-		context: "Displayed in the Studio sidebar or header.",
-		...baseMeta
-	},
-	source: {
-		type: "component",
-		framework: "react",
-		componentKey: "LearningTrackProgressWidget"
-	},
-	targets: ["react"]
-});
-const studioOnboardingPresentations = [StudioOnboardingTrackPresentation, StudioOnboardingWidgetPresentation];
 
-//#endregion
-export { StudioOnboardingTrackPresentation, StudioOnboardingWidgetPresentation, studioOnboardingPresentations };
-//# sourceMappingURL=index.js.map
+// src/presentations/index.ts
+import {
+  definePresentation,
+  StabilityEnum
+} from "@contractspec/lib.contracts";
+var baseMeta = {
+  domain: "learning-journey",
+  title: "Studio Onboarding",
+  owners: ["@examples.learning-journey.studio-onboarding"],
+  tags: ["learning", "onboarding", "studio"],
+  stability: StabilityEnum.Experimental
+};
+var StudioOnboardingTrackPresentation = definePresentation({
+  meta: {
+    key: "learning.journey.studio.track",
+    version: "1.0.0",
+    description: "Studio onboarding track detail",
+    goal: "Visualize the onboarding track for the user.",
+    context: "Displayed in the Studio dashboard.",
+    ...baseMeta
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "LearningTrackDetail",
+    props: StudioOnboardingTrackModel
+  },
+  targets: ["react", "markdown", "application/json"]
+});
+var StudioOnboardingWidgetPresentation = definePresentation({
+  meta: {
+    key: "learning.journey.studio.widget",
+    version: "1.0.0",
+    description: "Compact widget for Studio onboarding progress",
+    goal: "Show quick progress summary.",
+    context: "Displayed in the Studio sidebar or header.",
+    ...baseMeta
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "LearningTrackProgressWidget"
+  },
+  targets: ["react"]
+});
+var studioOnboardingPresentations = [
+  StudioOnboardingTrackPresentation,
+  StudioOnboardingWidgetPresentation
+];
+export {
+  studioOnboardingPresentations,
+  StudioOnboardingWidgetPresentation,
+  StudioOnboardingTrackPresentation
+};

package/dist/tests/operations.test-spec.d.ts

@@ -1,7 +1,2 @@
-import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
-
-//#region src/tests/operations.test-spec.d.ts
-declare const GetTrackTest: _contractspec_lib_contracts0.TestSpec;
-//#endregion
-export { GetTrackTest };
+export declare const GetTrackTest: import("@contractspec/lib.contracts").TestSpec;
 //# sourceMappingURL=operations.test-spec.d.ts.map

package/dist/tests/operations.test-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations.test-spec.d.ts","names":[],"sources":["../../src/tests/operations.test-spec.ts"],"mappings":";;;cAEa,YAAA,EA4BX,4BAAA,CA5BuB,QAAA"}
+{"version":3,"file":"operations.test-spec.d.ts","sourceRoot":"","sources":["../../src/tests/operations.test-spec.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,gDA4BvB,CAAC"}

package/dist/tests/operations.test-spec.js

@@ -1,36 +1,35 @@
+// @bun
+// src/tests/operations.test-spec.ts
 import { defineTestSpec } from "@contractspec/lib.contracts";
-
-//#region src/tests/operations.test-spec.ts
-const GetTrackTest = defineTestSpec({
-	meta: {
-		key: "learningJourney.studioOnboarding.getTrack.test",
-		version: "1.0.0",
-		stability: "experimental",
-		owners: ["@example.learning-journey-studio-onboarding"],
-		description: "Test for getting studio onboarding track",
-		tags: ["test"]
-	},
-	target: {
-		type: "operation",
-		operation: {
-			key: "learningJourney.studioOnboarding.getTrack",
-			version: "1.0.0"
-		}
-	},
-	scenarios: [{
-		key: "success",
-		when: { operation: { key: "learningJourney.studioOnboarding.getTrack" } },
-		then: [{
-			type: "expectOutput",
-			match: {}
-		}]
-	}, {
-		key: "error",
-		when: { operation: { key: "learningJourney.studioOnboarding.getTrack" } },
-		then: [{ type: "expectError" }]
-	}]
+var GetTrackTest = defineTestSpec({
+  meta: {
+    key: "learningJourney.studioOnboarding.getTrack.test",
+    version: "1.0.0",
+    stability: "experimental",
+    owners: ["@example.learning-journey-studio-onboarding"],
+    description: "Test for getting studio onboarding track",
+    tags: ["test"]
+  },
+  target: {
+    type: "operation",
+    operation: {
+      key: "learningJourney.studioOnboarding.getTrack",
+      version: "1.0.0"
+    }
+  },
+  scenarios: [
+    {
+      key: "success",
+      when: { operation: { key: "learningJourney.studioOnboarding.getTrack" } },
+      then: [{ type: "expectOutput", match: {} }]
+    },
+    {
+      key: "error",
+      when: { operation: { key: "learningJourney.studioOnboarding.getTrack" } },
+      then: [{ type: "expectError" }]
+    }
+  ]
 });
-
-//#endregion
-export { GetTrackTest };
-//# sourceMappingURL=operations.test-spec.js.map
+export {
+  GetTrackTest
+};

package/dist/track.d.ts

@@ -1,8 +1,4 @@
-import { LearningJourneyTrackSpec } from "@contractspec/module.learning-journey/track-spec";
-
-//#region src/track.d.ts
-declare const studioGettingStartedTrack: LearningJourneyTrackSpec;
-declare const studioLearningTracks: LearningJourneyTrackSpec[];
-//#endregion
-export { studioGettingStartedTrack, studioLearningTracks };
+import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';
+export declare const studioGettingStartedTrack: LearningJourneyTrackSpec;
+export declare const studioLearningTracks: LearningJourneyTrackSpec[];
 //# sourceMappingURL=track.d.ts.map

package/dist/track.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"track.d.ts","names":[],"sources":["../src/track.ts"],"mappings":";;;cAEa,yBAAA,EAA2B,wBAAA;AAAA,cAiF3B,oBAAA,EAAsB,wBAAA"}
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../src/track.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AAEjG,eAAO,MAAM,yBAAyB,EAAE,wBA+EvC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,wBAAwB,EAE1D,CAAC"}

package/dist/track.js

@@ -1,91 +1,88 @@
-//#region src/track.ts
-const 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"]
-	}
+// @bun
+// 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
+];
+export {
+  studioLearningTracks,
+  studioGettingStartedTrack
 };
-const studioLearningTracks = [studioGettingStartedTrack];
-
-//#endregion
-export { studioGettingStartedTrack, studioLearningTracks };
-//# sourceMappingURL=track.js.map