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

package/dist/operations/index.js

@@ -1,176 +1,202 @@
-import { studioGettingStartedTrack } from "../track.js";
-import { defineCommand, defineQuery } from "@contractspec/lib.contracts";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+// @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/operations/index.ts
-const OWNERS = ["examples.learning-journey.studio-onboarding"];
-const 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
-		}
-	}
+// 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 }
+  }
 });
-const 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 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 }
+  }
 });
-const TrackResponseModel = defineSchemaModel({
-	name: "StudioOnboardingTrackResponse",
-	description: "Response wrapper for studio onboarding track",
-	fields: { track: {
-		type: StudioOnboardingTrackModel,
-		isOptional: false
-	} }
+var TrackResponseModel = defineSchemaModel({
+  name: "StudioOnboardingTrackResponse",
+  description: "Response wrapper for studio onboarding track",
+  fields: {
+    track: { type: StudioOnboardingTrackModel, isOptional: false }
+  }
 });
-const 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 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 }
+  }
 });
-const SuccessModel = defineSchemaModel({
-	name: "StudioOnboardingSuccess",
-	description: "Generic success response",
-	fields: { success: {
-		type: ScalarTypeEnum.Boolean(),
-		isOptional: false
-	} }
+var SuccessModel = defineSchemaModel({
+  name: "StudioOnboardingSuccess",
+  description: "Generic success response",
+  fields: {
+    success: { type: ScalarTypeEnum.Boolean(), isOptional: false }
+  }
 });
-const 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 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" }
 });
-const 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 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" }
 });
-const studioOnboardingContracts = {
-	GetStudioOnboardingTrack,
-	RecordStudioOnboardingEvent,
-	track: studioGettingStartedTrack
+var studioOnboardingContracts = {
+  GetStudioOnboardingTrack,
+  RecordStudioOnboardingEvent,
+  track: studioGettingStartedTrack
+};
+export {
+  studioOnboardingContracts,
+  StudioOnboardingTrackModel,
+  RecordStudioOnboardingEvent,
+  GetStudioOnboardingTrack
 };
-
-//#endregion
-export { GetStudioOnboardingTrack, RecordStudioOnboardingEvent, StudioOnboardingTrackModel, studioOnboardingContracts };
-//# sourceMappingURL=index.js.map

package/dist/operations/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/operations/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/operations/index.test.ts"],"names":[],"mappings":""}

package/dist/presentations/index.d.ts

@@ -1,9 +1,4 @@
-import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
-
-//#region src/presentations/index.d.ts
-declare const StudioOnboardingTrackPresentation: _contractspec_lib_contracts0.PresentationSpec;
-declare const StudioOnboardingWidgetPresentation: _contractspec_lib_contracts0.PresentationSpec;
-declare const studioOnboardingPresentations: _contractspec_lib_contracts0.PresentationSpec[];
-//#endregion
-export { StudioOnboardingTrackPresentation, StudioOnboardingWidgetPresentation, studioOnboardingPresentations };
+export declare const StudioOnboardingTrackPresentation: import("@contractspec/lib.contracts").PresentationSpec;
+export declare const StudioOnboardingWidgetPresentation: import("@contractspec/lib.contracts").PresentationSpec;
+export declare const studioOnboardingPresentations: import("@contractspec/lib.contracts").PresentationSpec[];
 //# sourceMappingURL=index.d.ts.map

package/dist/presentations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/presentations/index.ts"],"mappings":";;;cAkBa,iCAAA,EAgBX,4BAAA,CAhB4C,gBAAA;AAAA,cAkBjC,kCAAA,EAeX,4BAAA,CAf6C,gBAAA;AAAA,cAiBlC,6BAAA,EAGZ,4BAAA,CAHyC,gBAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presentations/index.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,iCAAiC,wDAgB5C,CAAC;AAEH,eAAO,MAAM,kCAAkC,wDAe7C,CAAC;AAEH,eAAO,MAAM,6BAA6B,0DAGzC,CAAC"}