@contractspec/example.saas-boilerplate 1.46.0 → 1.47.0

package/dist/ui/overlays/demo-overlays.js

@@ -0,0 +1,70 @@
+//#region src/ui/overlays/demo-overlays.ts
+/**
+* Free tier overlay - shows upgrade prompts and limits
+*/
+const saasFreeUserOverlay = {
+	overlayId: "saas-boilerplate.free-tier",
+	version: "1.0.0",
+	description: "Shows limitations for free tier users",
+	appliesTo: {
+		feature: "saas-boilerplate",
+		tier: "free"
+	},
+	modifications: [
+		{
+			type: "setLimit",
+			field: "projects",
+			max: 3,
+			message: "Upgrade to create more projects"
+		},
+		{
+			type: "hideField",
+			field: "advancedSettings",
+			reason: "Pro feature"
+		},
+		{
+			type: "addBadge",
+			position: "header",
+			label: "Free Plan",
+			variant: "default"
+		}
+	]
+};
+/**
+* Demo user overlay
+*/
+const saasDemoOverlay = {
+	overlayId: "saas-boilerplate.demo-user",
+	version: "1.0.0",
+	description: "Demo mode for SaaS boilerplate",
+	appliesTo: {
+		feature: "saas-boilerplate",
+		role: "demo"
+	},
+	modifications: [
+		{
+			type: "hideField",
+			field: "billingSection",
+			reason: "Demo users cannot access billing"
+		},
+		{
+			type: "hideField",
+			field: "deleteAccount",
+			reason: "Not available in demo"
+		},
+		{
+			type: "addBadge",
+			position: "header",
+			label: "Demo Mode",
+			variant: "warning"
+		}
+	]
+};
+/**
+* All overlays for saas-boilerplate
+*/
+const saasOverlays = [saasFreeUserOverlay, saasDemoOverlay];
+
+//#endregion
+export { saasDemoOverlay, saasFreeUserOverlay, saasOverlays };
+//# sourceMappingURL=demo-overlays.js.map

package/dist/ui/overlays/demo-overlays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-overlays.js","names":[],"sources":["../../../src/ui/overlays/demo-overlays.ts"],"sourcesContent":["/**\n * Demo Overlay Definitions for SaaS Boilerplate\n *\n * These overlays customize the presentation for different contexts\n * (e.g., demo users, different subscription tiers).\n */\nimport type { OverlayDefinition } from '../../shared/overlay-types';\n\n/**\n * Free tier overlay - shows upgrade prompts and limits\n */\nexport const saasFreeUserOverlay: OverlayDefinition = {\n  overlayId: 'saas-boilerplate.free-tier',\n  version: '1.0.0',\n  description: 'Shows limitations for free tier users',\n  appliesTo: {\n    feature: 'saas-boilerplate',\n    tier: 'free',\n  },\n  modifications: [\n    {\n      type: 'setLimit',\n      field: 'projects',\n      max: 3,\n      message: 'Upgrade to create more projects',\n    },\n    { type: 'hideField', field: 'advancedSettings', reason: 'Pro feature' },\n    {\n      type: 'addBadge',\n      position: 'header',\n      label: 'Free Plan',\n      variant: 'default',\n    },\n  ],\n};\n\n/**\n * Demo user overlay\n */\nexport const saasDemoOverlay: OverlayDefinition = {\n  overlayId: 'saas-boilerplate.demo-user',\n  version: '1.0.0',\n  description: 'Demo mode for SaaS boilerplate',\n  appliesTo: {\n    feature: 'saas-boilerplate',\n    role: 'demo',\n  },\n  modifications: [\n    {\n      type: 'hideField',\n      field: 'billingSection',\n      reason: 'Demo users cannot access billing',\n    },\n    {\n      type: 'hideField',\n      field: 'deleteAccount',\n      reason: 'Not available in demo',\n    },\n    {\n      type: 'addBadge',\n      position: 'header',\n      label: 'Demo Mode',\n      variant: 'warning',\n    },\n  ],\n};\n\n/**\n * All overlays for saas-boilerplate\n */\nexport const saasOverlays: OverlayDefinition[] = [\n  saasFreeUserOverlay,\n  saasDemoOverlay,\n];\n"],"mappings":";;;;AAWA,MAAa,sBAAyC;CACpD,WAAW;CACX,SAAS;CACT,aAAa;CACb,WAAW;EACT,SAAS;EACT,MAAM;EACP;CACD,eAAe;EACb;GACE,MAAM;GACN,OAAO;GACP,KAAK;GACL,SAAS;GACV;EACD;GAAE,MAAM;GAAa,OAAO;GAAoB,QAAQ;GAAe;EACvE;GACE,MAAM;GACN,UAAU;GACV,OAAO;GACP,SAAS;GACV;EACF;CACF;;;;AAKD,MAAa,kBAAqC;CAChD,WAAW;CACX,SAAS;CACT,aAAa;CACb,WAAW;EACT,SAAS;EACT,MAAM;EACP;CACD,eAAe;EACb;GACE,MAAM;GACN,OAAO;GACP,QAAQ;GACT;EACD;GACE,MAAM;GACN,OAAO;GACP,QAAQ;GACT;EACD;GACE,MAAM;GACN,UAAU;GACV,OAAO;GACP,SAAS;GACV;EACF;CACF;;;;AAKD,MAAa,eAAoC,CAC/C,qBACA,gBACD"}

package/dist/ui/overlays/index.d.ts

@@ -0,0 +1,2 @@
+import { saasDemoOverlay, saasFreeUserOverlay, saasOverlays } from "./demo-overlays.js";
+export { saasDemoOverlay, saasFreeUserOverlay, saasOverlays };

package/dist/ui/overlays/index.js

@@ -0,0 +1,3 @@
+import { saasDemoOverlay, saasFreeUserOverlay, saasOverlays } from "./demo-overlays.js";
+
+export { saasDemoOverlay, saasFreeUserOverlay, saasOverlays };

package/dist/ui/renderers/index.d.ts

@@ -0,0 +1,3 @@
+import { projectListReactRenderer } from "./project-list.renderer.js";
+import { projectListMarkdownRenderer, saasBillingMarkdownRenderer, saasDashboardMarkdownRenderer } from "./project-list.markdown.js";
+export { projectListMarkdownRenderer, projectListReactRenderer, saasBillingMarkdownRenderer, saasDashboardMarkdownRenderer };

package/dist/ui/renderers/index.js

@@ -0,0 +1,4 @@
+import { projectListReactRenderer } from "./project-list.renderer.js";
+import { projectListMarkdownRenderer, saasBillingMarkdownRenderer, saasDashboardMarkdownRenderer } from "./project-list.markdown.js";
+
+export { projectListMarkdownRenderer, projectListReactRenderer, saasBillingMarkdownRenderer, saasDashboardMarkdownRenderer };

package/dist/ui/renderers/project-list.markdown.d.ts

@@ -0,0 +1,31 @@
+import { PresentationRenderer } from "@contractspec/lib.contracts";
+
+//#region src/ui/renderers/project-list.markdown.d.ts
+
+/**
+ * Markdown renderer for saas-boilerplate.project.list presentation
+ * Only handles ProjectListView component
+ */
+declare const projectListMarkdownRenderer: PresentationRenderer<{
+  mimeType: string;
+  body: string;
+}>;
+/**
+ * Markdown renderer for saas-boilerplate.dashboard presentation
+ * Only handles SaasDashboard component
+ */
+declare const saasDashboardMarkdownRenderer: PresentationRenderer<{
+  mimeType: string;
+  body: string;
+}>;
+/**
+ * Markdown renderer for saas-boilerplate.billing.settings presentation
+ * Only handles SubscriptionView component
+ */
+declare const saasBillingMarkdownRenderer: PresentationRenderer<{
+  mimeType: string;
+  body: string;
+}>;
+//#endregion
+export { projectListMarkdownRenderer, saasBillingMarkdownRenderer, saasDashboardMarkdownRenderer };
+//# sourceMappingURL=project-list.markdown.d.ts.map

package/dist/ui/renderers/project-list.markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-list.markdown.d.ts","names":[],"sources":["../../../src/ui/renderers/project-list.markdown.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAsBa,6BAA6B;;;;;;;;cA6D7B,+BAA+B;;;;;;;;cA0F/B,6BAA6B"}

package/dist/ui/renderers/project-list.markdown.js

@@ -0,0 +1,148 @@
+import { mockGetSubscriptionHandler, mockListProjectsHandler } from "@contractspec/example.saas-boilerplate/handlers";
+
+//#region src/ui/renderers/project-list.markdown.ts
+/**
+* Markdown renderer for saas-boilerplate.project.list presentation
+* Only handles ProjectListView component
+*/
+const projectListMarkdownRenderer = {
+	target: "markdown",
+	render: async (desc, _ctx) => {
+		if (desc.source.type !== "component" || desc.source.componentKey !== "ProjectListView") throw new Error("projectListMarkdownRenderer: not ProjectListView");
+		const data = await mockListProjectsHandler({
+			limit: 20,
+			offset: 0
+		});
+		const items = data.projects ?? data.items ?? [];
+		const lines = [
+			"# Projects",
+			"",
+			`**Total**: ${data.total} projects`,
+			""
+		];
+		if (items.length === 0) lines.push("_No projects found._");
+		else {
+			lines.push("| Status | Project | Description |");
+			lines.push("|--------|---------|-------------|");
+			for (const project of items) {
+				const status = project.status === "ACTIVE" ? "✅" : project.status === "ARCHIVED" ? "📦" : "⏸️";
+				lines.push(`| ${status} | **${project.name}** | ${project.description ?? "-"} |`);
+			}
+		}
+		return {
+			mimeType: "text/markdown",
+			body: lines.join("\n")
+		};
+	}
+};
+/**
+* Markdown renderer for saas-boilerplate.dashboard presentation
+* Only handles SaasDashboard component
+*/
+const saasDashboardMarkdownRenderer = {
+	target: "markdown",
+	render: async (desc, _ctx) => {
+		if (desc.source.type !== "component" || desc.source.componentKey !== "SaasDashboard") throw new Error("saasDashboardMarkdownRenderer: not SaasDashboard");
+		const [projectsData, subscription] = await Promise.all([mockListProjectsHandler({ limit: 50 }), mockGetSubscriptionHandler()]);
+		const projects = projectsData.projects ?? [];
+		const activeProjects = projects.filter((p) => p.status === "ACTIVE").length;
+		const archivedProjects = projects.filter((p) => p.status === "ARCHIVED").length;
+		const lines = [
+			"# SaaS Dashboard",
+			"",
+			"> Organization overview and usage summary",
+			"",
+			"## Summary",
+			"",
+			"| Metric | Value |",
+			"|--------|-------|",
+			`| Total Projects | ${projectsData.total} |`,
+			`| Active Projects | ${activeProjects} |`,
+			`| Archived Projects | ${archivedProjects} |`,
+			`| Subscription Plan | ${subscription.planName} |`,
+			`| Subscription Status | ${subscription.status} |`,
+			"",
+			"## Projects",
+			""
+		];
+		if (projects.length === 0) lines.push("_No projects yet._");
+		else {
+			lines.push("| Status | Project | Description |");
+			lines.push("|--------|---------|-------------|");
+			for (const project of projects.slice(0, 10)) {
+				const status = project.status === "ACTIVE" ? "✅" : project.status === "ARCHIVED" ? "📦" : "⏸️";
+				lines.push(`| ${status} | **${project.name}** | ${project.description ?? "-"} |`);
+			}
+			if (projects.length > 10) lines.push(`| ... | ... | _${projectsData.total - 10} more projects_ |`);
+		}
+		lines.push("");
+		lines.push("## Subscription");
+		lines.push("");
+		lines.push(`- **Plan**: ${subscription.planName}`);
+		lines.push(`- **Status**: ${subscription.status}`);
+		if (subscription.currentPeriodEnd) lines.push(`- **Period End**: ${new Date(subscription.currentPeriodEnd).toLocaleDateString()}`);
+		return {
+			mimeType: "text/markdown",
+			body: lines.join("\n")
+		};
+	}
+};
+/**
+* Markdown renderer for saas-boilerplate.billing.settings presentation
+* Only handles SubscriptionView component
+*/
+const saasBillingMarkdownRenderer = {
+	target: "markdown",
+	render: async (desc, _ctx) => {
+		if (desc.source.type !== "component" || desc.source.componentKey !== "SubscriptionView") throw new Error("saasBillingMarkdownRenderer: not SubscriptionView");
+		const subscription = await mockGetSubscriptionHandler();
+		const lines = [
+			"# Billing & Subscription",
+			"",
+			"> Current subscription details and billing information",
+			"",
+			"## Subscription Details",
+			"",
+			"| Property | Value |",
+			"|----------|-------|",
+			`| Plan | ${subscription.planName} |`,
+			`| Status | ${subscription.status} |`,
+			`| ID | ${subscription.id} |`,
+			`| Period Start | ${new Date(subscription.currentPeriodStart).toLocaleDateString()} |`,
+			`| Period End | ${new Date(subscription.currentPeriodEnd).toLocaleDateString()} |`
+		];
+		lines.push("");
+		lines.push("## Plan Limits");
+		lines.push("");
+		lines.push(`- **Projects**: ${subscription.limits.projects}`);
+		lines.push(`- **Users**: ${subscription.limits.users}`);
+		lines.push("");
+		lines.push("## Plan Features");
+		lines.push("");
+		if (subscription.planName.toLowerCase().includes("free")) {
+			lines.push("- ✅ Up to 3 projects");
+			lines.push("- ✅ Basic support");
+			lines.push("- ❌ Priority support");
+			lines.push("- ❌ Advanced analytics");
+		} else if (subscription.planName.toLowerCase().includes("pro")) {
+			lines.push("- ✅ Unlimited projects");
+			lines.push("- ✅ Priority support");
+			lines.push("- ✅ Advanced analytics");
+			lines.push("- ❌ Custom integrations");
+		} else {
+			lines.push("- ✅ Unlimited projects");
+			lines.push("- ✅ Priority support");
+			lines.push("- ✅ Advanced analytics");
+			lines.push("- ✅ Custom integrations");
+			lines.push("- ✅ Dedicated support");
+		}
+		return {
+			mimeType: "text/markdown",
+			body: lines.join("\n")
+		};
+	}
+};
+
+//#endregion
+export { projectListMarkdownRenderer, saasBillingMarkdownRenderer, saasDashboardMarkdownRenderer };
+//# sourceMappingURL=project-list.markdown.js.map

package/dist/ui/renderers/project-list.markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-list.markdown.js","names":[],"sources":["../../../src/ui/renderers/project-list.markdown.ts"],"sourcesContent":["/**\n * Markdown renderer for SaaS Project List presentation\n *\n * Uses dynamic import to ensure correct build order.\n */\nimport type { PresentationRenderer } from '@contractspec/lib.contracts';\nimport {\n  mockListProjectsHandler,\n  mockGetSubscriptionHandler,\n} from '@contractspec/example.saas-boilerplate/handlers';\n\ninterface ProjectItem {\n  id: string;\n  name: string;\n  status: string;\n  description?: string;\n}\n\n/**\n * Markdown renderer for saas-boilerplate.project.list presentation\n * Only handles ProjectListView component\n */\nexport const projectListMarkdownRenderer: PresentationRenderer<{\n  mimeType: string;\n  body: string;\n}> = {\n  target: 'markdown',\n  render: async (desc, _ctx) => {\n    // Only handle ProjectListView\n    if (\n      desc.source.type !== 'component' ||\n      desc.source.componentKey !== 'ProjectListView'\n    ) {\n      throw new Error('projectListMarkdownRenderer: not ProjectListView');\n    }\n\n    const data = await mockListProjectsHandler({\n      limit: 20,\n      offset: 0,\n    });\n\n    // The example handler returns 'projects', not 'items'\n    const items =\n      (data as { projects?: ProjectItem[]; items?: ProjectItem[] }).projects ??\n      (data as { items?: ProjectItem[] }).items ??\n      [];\n\n    const lines: string[] = [\n      '# Projects',\n      '',\n      `**Total**: ${data.total} projects`,\n      '',\n    ];\n\n    if (items.length === 0) {\n      lines.push('_No projects found._');\n    } else {\n      lines.push('| Status | Project | Description |');\n      lines.push('|--------|---------|-------------|');\n      for (const project of items) {\n        const status =\n          project.status === 'ACTIVE'\n            ? '✅'\n            : project.status === 'ARCHIVED'\n              ? '📦'\n              : '⏸️';\n        lines.push(\n          `| ${status} | **${project.name}** | ${project.description ?? '-'} |`\n        );\n      }\n    }\n\n    return {\n      mimeType: 'text/markdown',\n      body: lines.join('\\n'),\n    };\n  },\n};\n\n/**\n * Markdown renderer for saas-boilerplate.dashboard presentation\n * Only handles SaasDashboard component\n */\nexport const saasDashboardMarkdownRenderer: PresentationRenderer<{\n  mimeType: string;\n  body: string;\n}> = {\n  target: 'markdown',\n  render: async (desc, _ctx) => {\n    // Only handle SaasDashboard\n    if (\n      desc.source.type !== 'component' ||\n      desc.source.componentKey !== 'SaasDashboard'\n    ) {\n      throw new Error('saasDashboardMarkdownRenderer: not SaasDashboard');\n    }\n\n    const [projectsData, subscription] = await Promise.all([\n      mockListProjectsHandler({ limit: 50 }),\n      mockGetSubscriptionHandler(),\n    ]);\n\n    const projects =\n      (projectsData as { projects?: ProjectItem[] }).projects ?? [];\n    const activeProjects = projects.filter((p) => p.status === 'ACTIVE').length;\n    const archivedProjects = projects.filter(\n      (p) => p.status === 'ARCHIVED'\n    ).length;\n\n    const lines: string[] = [\n      '# SaaS Dashboard',\n      '',\n      '> Organization overview and usage summary',\n      '',\n      '## Summary',\n      '',\n      '| Metric | Value |',\n      '|--------|-------|',\n      `| Total Projects | ${projectsData.total} |`,\n      `| Active Projects | ${activeProjects} |`,\n      `| Archived Projects | ${archivedProjects} |`,\n      `| Subscription Plan | ${subscription.planName} |`,\n      `| Subscription Status | ${subscription.status} |`,\n      '',\n      '## Projects',\n      '',\n    ];\n\n    if (projects.length === 0) {\n      lines.push('_No projects yet._');\n    } else {\n      lines.push('| Status | Project | Description |');\n      lines.push('|--------|---------|-------------|');\n      for (const project of projects.slice(0, 10)) {\n        const status =\n          project.status === 'ACTIVE'\n            ? '✅'\n            : project.status === 'ARCHIVED'\n              ? '📦'\n              : '⏸️';\n        lines.push(\n          `| ${status} | **${project.name}** | ${project.description ?? '-'} |`\n        );\n      }\n      if (projects.length > 10) {\n        lines.push(\n          `| ... | ... | _${projectsData.total - 10} more projects_ |`\n        );\n      }\n    }\n\n    lines.push('');\n    lines.push('## Subscription');\n    lines.push('');\n    lines.push(`- **Plan**: ${subscription.planName}`);\n    lines.push(`- **Status**: ${subscription.status}`);\n    if (subscription.currentPeriodEnd) {\n      lines.push(\n        `- **Period End**: ${new Date(subscription.currentPeriodEnd).toLocaleDateString()}`\n      );\n    }\n\n    return {\n      mimeType: 'text/markdown',\n      body: lines.join('\\n'),\n    };\n  },\n};\n\n/**\n * Markdown renderer for saas-boilerplate.billing.settings presentation\n * Only handles SubscriptionView component\n */\nexport const saasBillingMarkdownRenderer: PresentationRenderer<{\n  mimeType: string;\n  body: string;\n}> = {\n  target: 'markdown',\n  render: async (desc, _ctx) => {\n    // Only handle SubscriptionView\n    if (\n      desc.source.type !== 'component' ||\n      desc.source.componentKey !== 'SubscriptionView'\n    ) {\n      throw new Error('saasBillingMarkdownRenderer: not SubscriptionView');\n    }\n\n    const subscription = await mockGetSubscriptionHandler();\n\n    const lines: string[] = [\n      '# Billing & Subscription',\n      '',\n      '> Current subscription details and billing information',\n      '',\n      '## Subscription Details',\n      '',\n      '| Property | Value |',\n      '|----------|-------|',\n      `| Plan | ${subscription.planName} |`,\n      `| Status | ${subscription.status} |`,\n      `| ID | ${subscription.id} |`,\n      `| Period Start | ${new Date(subscription.currentPeriodStart).toLocaleDateString()} |`,\n      `| Period End | ${new Date(subscription.currentPeriodEnd).toLocaleDateString()} |`,\n    ];\n\n    lines.push('');\n    lines.push('## Plan Limits');\n    lines.push('');\n    lines.push(`- **Projects**: ${subscription.limits.projects}`);\n    lines.push(`- **Users**: ${subscription.limits.users}`);\n\n    lines.push('');\n    lines.push('## Plan Features');\n    lines.push('');\n\n    if (subscription.planName.toLowerCase().includes('free')) {\n      lines.push('- ✅ Up to 3 projects');\n      lines.push('- ✅ Basic support');\n      lines.push('- ❌ Priority support');\n      lines.push('- ❌ Advanced analytics');\n    } else if (subscription.planName.toLowerCase().includes('pro')) {\n      lines.push('- ✅ Unlimited projects');\n      lines.push('- ✅ Priority support');\n      lines.push('- ✅ Advanced analytics');\n      lines.push('- ❌ Custom integrations');\n    } else {\n      lines.push('- ✅ Unlimited projects');\n      lines.push('- ✅ Priority support');\n      lines.push('- ✅ Advanced analytics');\n      lines.push('- ✅ Custom integrations');\n      lines.push('- ✅ Dedicated support');\n    }\n\n    return {\n      mimeType: 'text/markdown',\n      body: lines.join('\\n'),\n    };\n  },\n};\n"],"mappings":"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"}

package/dist/ui/renderers/project-list.renderer.d.ts

@@ -0,0 +1,9 @@
+import { PresentationRenderer } from "@contractspec/lib.contracts";
+import * as React from "react";
+
+//#region src/ui/renderers/project-list.renderer.d.ts
+
+declare const projectListReactRenderer: PresentationRenderer<React.ReactElement>;
+//#endregion
+export { projectListReactRenderer };
+//# sourceMappingURL=project-list.renderer.d.ts.map

package/dist/ui/renderers/project-list.renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-list.renderer.d.ts","names":[],"sources":["../../../src/ui/renderers/project-list.renderer.tsx"],"sourcesContent":[],"mappings":";;;;;cAOa,0BAA0B,qBAAqB,KAAA,CAAM"}

package/dist/ui/renderers/project-list.renderer.js

@@ -0,0 +1,17 @@
+import { SaasProjectList } from "../SaasProjectList.js";
+import "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/ui/renderers/project-list.renderer.tsx
+const projectListReactRenderer = {
+	target: "react",
+	render: async (desc, _ctx) => {
+		if (desc.source.type !== "component") throw new Error("Invalid source type");
+		if (desc.source.componentKey !== "SaasProjectListView") throw new Error(`Unknown component: ${desc.source.componentKey}`);
+		return /* @__PURE__ */ jsx(SaasProjectList, {});
+	}
+};
+
+//#endregion
+export { projectListReactRenderer };
+//# sourceMappingURL=project-list.renderer.js.map

package/dist/ui/renderers/project-list.renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-list.renderer.js","names":[],"sources":["../../../src/ui/renderers/project-list.renderer.tsx"],"sourcesContent":["/**\n * React renderer for SaaS Project List presentation\n */\nimport * as React from 'react';\nimport type { PresentationRenderer } from '@contractspec/lib.contracts';\nimport { SaasProjectList } from '../SaasProjectList';\n\nexport const projectListReactRenderer: PresentationRenderer<React.ReactElement> =\n  {\n    target: 'react',\n    render: async (desc, _ctx) => {\n      if (desc.source.type !== 'component') {\n        throw new Error('Invalid source type');\n      }\n\n      if (desc.source.componentKey !== 'SaasProjectListView') {\n        throw new Error(`Unknown component: ${desc.source.componentKey}`);\n      }\n\n      return <SaasProjectList />;\n    },\n  };\n"],"mappings":";;;;;AAOA,MAAa,2BACX;CACE,QAAQ;CACR,QAAQ,OAAO,MAAM,SAAS;AAC5B,MAAI,KAAK,OAAO,SAAS,YACvB,OAAM,IAAI,MAAM,sBAAsB;AAGxC,MAAI,KAAK,OAAO,iBAAiB,sBAC/B,OAAM,IAAI,MAAM,sBAAsB,KAAK,OAAO,eAAe;AAGnE,SAAO,oBAAC,oBAAkB;;CAE7B"}

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@contractspec/example.saas-boilerplate",
-  "version": "1.46.0",
+  "version": "1.47.0",
   "description": "SaaS Boilerplate - Users, Orgs, Projects, Billing, Settings",
   "type": "module",
-  "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js",
@@ -21,6 +20,7 @@
     "./docs/saas-boilerplate.docblock": "./dist/docs/saas-boilerplate.docblock.js",
     "./example": "./dist/example.js",
     "./handlers": "./dist/handlers/index.js",
+    "./handlers/saas.handlers": "./dist/handlers/saas.handlers.js",
     "./presentations": "./dist/presentations/index.js",
     "./project": "./dist/project/index.js",
     "./project/project.entity": "./dist/project/project.entity.js",
@@ -31,10 +31,28 @@
     "./project/project.presentation": "./dist/project/project.presentation.js",
     "./project/project.schema": "./dist/project/project.schema.js",
     "./saas-boilerplate.feature": "./dist/saas-boilerplate.feature.js",
+    "./seeders": "./dist/seeders/index.js",
     "./settings": "./dist/settings/index.js",
     "./settings/settings.entity": "./dist/settings/settings.entity.js",
     "./settings/settings.enum": "./dist/settings/settings.enum.js",
     "./shared/mock-data": "./dist/shared/mock-data.js",
+    "./shared/overlay-types": "./dist/shared/overlay-types.js",
+    "./tests/operations.test-spec": "./dist/tests/operations.test-spec.js",
+    "./ui": "./dist/ui/index.js",
+    "./ui/hooks": "./dist/ui/hooks/index.js",
+    "./ui/hooks/useProjectList": "./dist/ui/hooks/useProjectList.js",
+    "./ui/hooks/useProjectMutations": "./dist/ui/hooks/useProjectMutations.js",
+    "./ui/modals": "./dist/ui/modals/index.js",
+    "./ui/modals/CreateProjectModal": "./dist/ui/modals/CreateProjectModal.js",
+    "./ui/modals/ProjectActionsModal": "./dist/ui/modals/ProjectActionsModal.js",
+    "./ui/overlays": "./dist/ui/overlays/index.js",
+    "./ui/overlays/demo-overlays": "./dist/ui/overlays/demo-overlays.js",
+    "./ui/renderers": "./dist/ui/renderers/index.js",
+    "./ui/renderers/project-list.markdown": "./dist/ui/renderers/project-list.markdown.js",
+    "./ui/renderers/project-list.renderer": "./dist/ui/renderers/project-list.renderer.js",
+    "./ui/SaasDashboard": "./dist/ui/SaasDashboard.js",
+    "./ui/SaasProjectList": "./dist/ui/SaasProjectList.js",
+    "./ui/SaasSettingsPanel": "./dist/ui/SaasSettingsPanel.js",
     "./*": "./*"
   },
   "scripts": {
@@ -48,23 +66,29 @@
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun run"
+    "test": "bun test"
   },
   "dependencies": {
-    "@contractspec/lib.identity-rbac": "1.46.0",
-    "@contractspec/lib.jobs": "1.46.0",
-    "@contractspec/module.audit-trail": "1.46.0",
-    "@contractspec/module.notifications": "1.46.0",
-    "@contractspec/lib.contracts": "1.46.0",
-    "@contractspec/lib.schema": "1.46.0"
+    "@contractspec/lib.identity-rbac": "1.47.0",
+    "@contractspec/lib.jobs": "1.47.0",
+    "@contractspec/module.audit-trail": "1.47.0",
+    "@contractspec/module.notifications": "1.47.0",
+    "@contractspec/lib.contracts": "1.47.0",
+    "@contractspec/lib.schema": "1.47.0",
+    "@contractspec/lib.example-shared-ui": "1.1.0",
+    "@contractspec/lib.design-system": "1.47.0",
+    "@contractspec/lib.runtime-sandbox": "0.2.0",
+    "react": "19.2.3",
+    "react-dom": "19.2.3"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.46.0",
-    "@contractspec/tool.typescript": "1.46.0",
-    "tsdown": "^0.18.3",
-    "typescript": "^5.9.3"
+    "@contractspec/tool.tsdown": "1.47.0",
+    "@contractspec/tool.typescript": "1.47.0",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3",
+    "@types/react": "^19.2.8",
+    "@types/react-dom": "^19.2.2"
   },
-  "module": "./dist/index.js",
   "publishConfig": {
     "exports": {
       ".": "./dist/index.js",

package/src/billing/billing.presentation.ts

@@ -1,10 +1,9 @@
-import type { PresentationSpec } from '@contractspec/lib.contracts';
-import { StabilityEnum } from '@contractspec/lib.contracts';
+import { definePresentation, StabilityEnum } from '@contractspec/lib.contracts';
 
 /**
  * Presentation for subscription overview.
  */
-export const SubscriptionPresentation: PresentationSpec = {
+export const SubscriptionPresentation = definePresentation({
   meta: {
     key: 'saas.billing.subscription',
     version: '1.0.0',
@@ -27,12 +26,12 @@ export const SubscriptionPresentation: PresentationSpec = {
   policy: {
     flags: ['saas.billing.enabled'],
   },
-};
+});
 
 /**
  * Presentation for usage dashboard.
  */
-export const UsageDashboardPresentation: PresentationSpec = {
+export const UsageDashboardPresentation = definePresentation({
   meta: {
     key: 'saas.billing.usage',
     version: '1.0.0',
@@ -54,4 +53,4 @@ export const UsageDashboardPresentation: PresentationSpec = {
   policy: {
     flags: ['saas.billing.enabled'],
   },
-};
+});

package/src/dashboard/dashboard.presentation.ts

@@ -1,10 +1,9 @@
-import type { PresentationSpec } from '@contractspec/lib.contracts';
-import { StabilityEnum } from '@contractspec/lib.contracts';
+import { definePresentation, StabilityEnum } from '@contractspec/lib.contracts';
 
 /**
  * Main dashboard presentation for the SaaS application.
  */
-export const SaasDashboardPresentation: PresentationSpec = {
+export const SaasDashboardPresentation = definePresentation({
   meta: {
     key: 'saas.dashboard',
     version: '1.0.0',
@@ -27,12 +26,12 @@ export const SaasDashboardPresentation: PresentationSpec = {
   policy: {
     flags: ['saas.enabled'],
   },
-};
+});
 
 /**
  * Settings panel presentation.
  */
-export const SettingsPanelPresentation: PresentationSpec = {
+export const SettingsPanelPresentation = definePresentation({
   meta: {
     key: 'saas.settings',
     version: '1.0.0',
@@ -54,4 +53,4 @@ export const SettingsPanelPresentation: PresentationSpec = {
   policy: {
     flags: ['saas.enabled'],
   },
-};
+});

package/src/example.ts

@@ -1,6 +1,6 @@
-import type { ExampleSpec } from '@contractspec/lib.contracts';
+import { defineExample } from '@contractspec/lib.contracts';
 
-const example: ExampleSpec = {
+const example = defineExample({
   meta: {
     key: 'saas-boilerplate',
     version: '1.0.0',
@@ -33,6 +33,6 @@ const example: ExampleSpec = {
     studio: { enabled: true, installable: true },
     mcp: { enabled: true },
   },
-};
+});
 
 export default example;

package/src/handlers/index.ts

@@ -18,3 +18,6 @@ export {
   mockUpdateProjectHandler,
   mockDeleteProjectHandler,
 } from '../project/project.handler';
+
+// Runtime handlers (PGLite)
+export * from './saas.handlers';