@contractspec/example.saas-boilerplate 1.56.1 → 1.58.0

package/dist/node/index.js

@@ -0,0 +1,3340 @@
+// src/billing/billing.entity.ts
+import {
+  defineEntity,
+  defineEntityEnum,
+  field,
+  index
+} from "@contractspec/lib.schema";
+var SubscriptionStatusEnum = defineEntityEnum({
+  name: "SubscriptionStatus",
+  values: ["TRIALING", "ACTIVE", "PAST_DUE", "CANCELED", "PAUSED"],
+  schema: "saas_app",
+  description: "Status of a subscription."
+});
+var SubscriptionEntity = defineEntity({
+  name: "Subscription",
+  description: "Organization subscription/plan information.",
+  schema: "saas_app",
+  map: "subscription",
+  fields: {
+    id: field.id(),
+    organizationId: field.foreignKey({ isUnique: true }),
+    planId: field.string({ description: "Plan identifier" }),
+    planName: field.string({ description: "Plan display name" }),
+    status: field.enum("SubscriptionStatus"),
+    currentPeriodStart: field.dateTime(),
+    currentPeriodEnd: field.dateTime(),
+    trialEndsAt: field.dateTime({ isOptional: true }),
+    cancelAtPeriodEnd: field.boolean({ default: false }),
+    canceledAt: field.dateTime({ isOptional: true }),
+    stripeSubscriptionId: field.string({ isOptional: true }),
+    stripeCustomerId: field.string({ isOptional: true }),
+    metadata: field.json({ isOptional: true }),
+    createdAt: field.createdAt(),
+    updatedAt: field.updatedAt()
+  },
+  enums: [SubscriptionStatusEnum]
+});
+var BillingUsageEntity = defineEntity({
+  name: "BillingUsage",
+  description: "Track usage of metered features.",
+  schema: "saas_app",
+  map: "billing_usage",
+  fields: {
+    id: field.id(),
+    organizationId: field.foreignKey(),
+    feature: field.string({
+      description: 'Feature being tracked (e.g., "api_calls", "storage_gb")'
+    }),
+    quantity: field.int({ description: "Usage quantity" }),
+    unit: field.string({
+      isOptional: true,
+      description: "Unit of measurement"
+    }),
+    billingPeriod: field.string({
+      description: 'Billing period (e.g., "2024-01")'
+    }),
+    recordedAt: field.dateTime({ description: "When usage was recorded" }),
+    sourceId: field.string({
+      isOptional: true,
+      description: "Source of usage (e.g., request ID)"
+    }),
+    sourceType: field.string({ isOptional: true }),
+    metadata: field.json({ isOptional: true })
+  },
+  indexes: [
+    index.on(["organizationId", "feature", "billingPeriod"]),
+    index.on(["organizationId", "recordedAt"])
+  ]
+});
+var UsageLimitEntity = defineEntity({
+  name: "UsageLimit",
+  description: "Usage limits per plan/organization.",
+  schema: "saas_app",
+  map: "usage_limit",
+  fields: {
+    id: field.id(),
+    planId: field.string({
+      isOptional: true,
+      description: "Plan this limit applies to"
+    }),
+    organizationId: field.string({
+      isOptional: true,
+      description: "Org-specific override"
+    }),
+    feature: field.string({ description: "Feature being limited" }),
+    limit: field.int({ description: "Maximum allowed usage" }),
+    resetPeriod: field.string({
+      default: '"monthly"',
+      description: "When limit resets"
+    }),
+    isSoftLimit: field.boolean({
+      default: false,
+      description: "Whether to warn vs block"
+    }),
+    overage: field.boolean({
+      default: false,
+      description: "Whether overage is allowed"
+    }),
+    overageRate: field.float({
+      isOptional: true,
+      description: "Cost per unit over limit"
+    }),
+    createdAt: field.createdAt(),
+    updatedAt: field.updatedAt()
+  },
+  indexes: [index.unique(["planId", "feature"])]
+});
+
+// src/billing/billing.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var SubscriptionStatusSchemaEnum = defineEnum("SubscriptionStatus", [
+  "TRIALING",
+  "ACTIVE",
+  "PAST_DUE",
+  "CANCELED",
+  "PAUSED"
+]);
+var FeatureAccessReasonEnum = defineEnum("FeatureAccessReason", [
+  "included",
+  "limit_available",
+  "limit_reached",
+  "not_in_plan"
+]);
+
+// src/billing/billing.event.ts
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineEvent } from "@contractspec/lib.contracts";
+var UsageRecordedPayload = defineSchemaModel({
+  name: "UsageRecordedPayload",
+  description: "Payload when feature usage is recorded",
+  fields: {
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    quantity: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    billingPeriod: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    recordedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var UsageLimitReachedPayload = defineSchemaModel({
+  name: "UsageLimitReachedPayload",
+  description: "Payload when usage limit is reached",
+  fields: {
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    currentUsage: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    reachedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var SubscriptionChangedPayload = defineSchemaModel({
+  name: "SubscriptionChangedPayload",
+  description: "Payload when subscription status changes",
+  fields: {
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    previousPlan: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    newPlan: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    previousStatus: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    newStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    changedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var UsageRecordedEvent = defineEvent({
+  meta: {
+    key: "billing.usage.recorded",
+    version: "1.0.0",
+    description: "Feature usage has been recorded.",
+    stability: "stable",
+    owners: ["@saas-team"],
+    tags: ["billing", "usage", "recorded"]
+  },
+  payload: UsageRecordedPayload
+});
+var UsageLimitReachedEvent = defineEvent({
+  meta: {
+    key: "billing.limit.reached",
+    version: "1.0.0",
+    description: "Usage limit has been reached for a feature.",
+    stability: "stable",
+    owners: ["@saas-team"],
+    tags: ["billing", "limit", "reached"]
+  },
+  payload: UsageLimitReachedPayload
+});
+var SubscriptionChangedEvent = defineEvent({
+  meta: {
+    key: "billing.subscription.changed",
+    version: "1.0.0",
+    description: "Subscription status has changed.",
+    stability: "stable",
+    owners: ["@saas-team"],
+    tags: ["billing", "subscription", "changed"]
+  },
+  payload: SubscriptionChangedPayload
+});
+
+// src/shared/mock-data.ts
+var MOCK_PROJECTS = [
+  {
+    id: "proj-1",
+    name: "Marketing Website",
+    description: "Main company website redesign project",
+    slug: "marketing-website",
+    organizationId: "demo-org",
+    createdBy: "user-1",
+    status: "ACTIVE",
+    isPublic: false,
+    tags: ["marketing", "website", "redesign"],
+    createdAt: new Date("2024-01-15T10:00:00Z"),
+    updatedAt: new Date("2024-03-20T14:30:00Z")
+  },
+  {
+    id: "proj-2",
+    name: "Mobile App v2",
+    description: "Next generation mobile application",
+    slug: "mobile-app-v2",
+    organizationId: "demo-org",
+    createdBy: "user-2",
+    status: "ACTIVE",
+    isPublic: false,
+    tags: ["mobile", "app", "v2"],
+    createdAt: new Date("2024-02-01T09:00:00Z"),
+    updatedAt: new Date("2024-04-05T11:15:00Z")
+  },
+  {
+    id: "proj-3",
+    name: "API Integration",
+    description: "Third-party API integration project",
+    slug: "api-integration",
+    organizationId: "demo-org",
+    createdBy: "user-1",
+    status: "DRAFT",
+    isPublic: false,
+    tags: ["api", "integration"],
+    createdAt: new Date("2024-03-10T08:00:00Z"),
+    updatedAt: new Date("2024-03-10T08:00:00Z")
+  },
+  {
+    id: "proj-4",
+    name: "Analytics Dashboard",
+    description: "Internal analytics and reporting dashboard",
+    slug: "analytics-dashboard",
+    organizationId: "demo-org",
+    createdBy: "user-3",
+    status: "ARCHIVED",
+    isPublic: true,
+    tags: ["analytics", "dashboard", "reporting"],
+    createdAt: new Date("2023-10-01T12:00:00Z"),
+    updatedAt: new Date("2024-02-28T16:45:00Z")
+  }
+];
+var MOCK_SUBSCRIPTION = {
+  id: "sub-1",
+  organizationId: "demo-org",
+  planId: "pro",
+  planName: "Professional",
+  status: "ACTIVE",
+  currentPeriodStart: new Date("2024-04-01T00:00:00Z"),
+  currentPeriodEnd: new Date("2024-05-01T00:00:00Z"),
+  limits: {
+    projects: 25,
+    users: 10,
+    storage: 50,
+    apiCalls: 1e5
+  },
+  usage: {
+    projects: 4,
+    users: 5,
+    storage: 12.5,
+    apiCalls: 45230
+  }
+};
+var MOCK_USAGE_SUMMARY = {
+  organizationId: "demo-org",
+  period: "current_month",
+  apiCalls: {
+    total: 45230,
+    limit: 1e5,
+    percentUsed: 45.23
+  },
+  storage: {
+    totalGb: 12.5,
+    limitGb: 50,
+    percentUsed: 25
+  },
+  activeProjects: 4,
+  activeUsers: 5,
+  breakdown: [
+    { date: "2024-04-01", apiCalls: 3200, storageGb: 12.1 },
+    { date: "2024-04-02", apiCalls: 2800, storageGb: 12.2 },
+    { date: "2024-04-03", apiCalls: 4100, storageGb: 12.3 },
+    { date: "2024-04-04", apiCalls: 3600, storageGb: 12.4 },
+    { date: "2024-04-05", apiCalls: 3800, storageGb: 12.5 }
+  ]
+};
+
+// src/billing/billing.handler.ts
+async function mockGetSubscriptionHandler() {
+  return MOCK_SUBSCRIPTION;
+}
+async function mockGetUsageSummaryHandler(input) {
+  return {
+    ...MOCK_USAGE_SUMMARY,
+    period: input.period ?? "current_month"
+  };
+}
+async function mockRecordUsageHandler(input) {
+  const currentUsage = MOCK_USAGE_SUMMARY.apiCalls.total;
+  const newTotal = currentUsage + input.quantity;
+  return {
+    recorded: true,
+    newTotal
+  };
+}
+async function mockCheckFeatureAccessHandler(input) {
+  const { feature } = input;
+  const featureMap = {
+    custom_domains: {
+      allowed: true
+    },
+    api_access: {
+      allowed: true,
+      currentUsage: MOCK_USAGE_SUMMARY.apiCalls.total,
+      limit: MOCK_USAGE_SUMMARY.apiCalls.limit
+    },
+    advanced_analytics: {
+      allowed: false,
+      reason: "FEATURE_NOT_INCLUDED"
+    },
+    unlimited_projects: {
+      allowed: false,
+      reason: "PLAN_LIMIT",
+      currentUsage: MOCK_SUBSCRIPTION.usage.projects,
+      limit: MOCK_SUBSCRIPTION.limits.projects
+    }
+  };
+  return featureMap[feature] ?? { allowed: true };
+}
+
+// src/billing/billing.schema.ts
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
+var SubscriptionModel = defineSchemaModel2({
+  name: "Subscription",
+  description: "Organization subscription details",
+  fields: {
+    id: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum2.String_unsecure(),
+      isOptional: false
+    },
+    planId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    planName: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    status: { type: SubscriptionStatusSchemaEnum, isOptional: false },
+    currentPeriodStart: { type: ScalarTypeEnum2.DateTime(), isOptional: false },
+    currentPeriodEnd: { type: ScalarTypeEnum2.DateTime(), isOptional: false },
+    trialEndsAt: { type: ScalarTypeEnum2.DateTime(), isOptional: true },
+    cancelAtPeriodEnd: { type: ScalarTypeEnum2.Boolean(), isOptional: false }
+  }
+});
+var UsageSummaryModel = defineSchemaModel2({
+  name: "UsageSummary",
+  description: "Usage summary for a feature",
+  fields: {
+    feature: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    used: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
+    limit: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: true },
+    unit: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
+    percentage: { type: ScalarTypeEnum2.Float_unsecure(), isOptional: true }
+  }
+});
+var RecordUsageInputModel = defineSchemaModel2({
+  name: "RecordUsageInput",
+  description: "Input for recording feature usage",
+  fields: {
+    feature: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    quantity: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
+    sourceId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
+    sourceType: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
+    metadata: { type: ScalarTypeEnum2.JSONObject(), isOptional: true }
+  }
+});
+var RecordUsageOutputModel = defineSchemaModel2({
+  name: "RecordUsageOutput",
+  description: "Output for recording feature usage",
+  fields: {
+    recorded: { type: ScalarTypeEnum2.Boolean(), isOptional: false },
+    currentUsage: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false },
+    limit: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: true },
+    limitReached: { type: ScalarTypeEnum2.Boolean(), isOptional: false }
+  }
+});
+var UsageRecordedPayloadModel = defineSchemaModel2({
+  name: "UsageRecordedPayload",
+  description: "Payload for usage.recorded event",
+  fields: {
+    feature: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    quantity: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false }
+  }
+});
+var GetUsageSummaryInputModel = defineSchemaModel2({
+  name: "GetUsageSummaryInput",
+  description: "Input for getting usage summary",
+  fields: {
+    billingPeriod: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true }
+  }
+});
+var GetUsageSummaryOutputModel = defineSchemaModel2({
+  name: "GetUsageSummaryOutput",
+  description: "Output for usage summary",
+  fields: {
+    billingPeriod: {
+      type: ScalarTypeEnum2.String_unsecure(),
+      isOptional: false
+    },
+    usage: { type: UsageSummaryModel, isArray: true, isOptional: false }
+  }
+});
+var CheckFeatureAccessInputModel = defineSchemaModel2({
+  name: "CheckFeatureAccessInput",
+  description: "Input for checking feature access",
+  fields: {
+    feature: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
+  }
+});
+var CheckFeatureAccessOutputModel = defineSchemaModel2({
+  name: "CheckFeatureAccessOutput",
+  description: "Output for feature access check",
+  fields: {
+    hasAccess: { type: ScalarTypeEnum2.Boolean(), isOptional: false },
+    reason: { type: FeatureAccessReasonEnum, isOptional: true },
+    upgradeUrl: { type: ScalarTypeEnum2.URL(), isOptional: true }
+  }
+});
+
+// src/billing/billing.operations.ts
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts";
+var OWNERS = ["@example.saas-boilerplate"];
+var GetSubscriptionContract = defineQuery({
+  meta: {
+    key: "saas.billing.subscription.get",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["saas", "billing", "subscription"],
+    description: "Get organization subscription status.",
+    goal: "Show current plan and billing status.",
+    context: "Billing page, plan upgrade prompts."
+  },
+  io: {
+    input: null,
+    output: SubscriptionModel
+  },
+  policy: {
+    auth: "user"
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "get-subscription-happy-path",
+        given: ["Organization has active subscription"],
+        when: ["User requests subscription status"],
+        then: ["Subscription details are returned"]
+      }
+    ],
+    examples: [
+      {
+        key: "get-basic",
+        input: null,
+        output: {
+          plan: "pro",
+          status: "active",
+          currentPeriodEnd: "2025-02-01T00:00:00Z"
+        }
+      }
+    ]
+  }
+});
+var RecordUsageContract = defineCommand({
+  meta: {
+    key: "saas.billing.usage.record",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["saas", "billing", "usage"],
+    description: "Record usage of a metered feature.",
+    goal: "Track feature usage for billing.",
+    context: "Called by services when metered features are used."
+  },
+  io: {
+    input: RecordUsageInputModel,
+    output: RecordUsageOutputModel
+  },
+  policy: {
+    auth: "user"
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: "billing.usage.recorded",
+        version: "1.0.0",
+        when: "Usage is recorded",
+        payload: UsageRecordedPayloadModel
+      }
+    ]
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "record-usage-happy-path",
+        given: ["Organization exists"],
+        when: ["System records feature usage"],
+        then: ["Usage is recorded"]
+      }
+    ],
+    examples: [
+      {
+        key: "record-api-call",
+        input: { feature: "api_calls", quantity: 1, idempotencyKey: "abc-123" },
+        output: { recorded: true, currentUsage: 100 }
+      }
+    ]
+  }
+});
+var GetUsageSummaryContract = defineQuery({
+  meta: {
+    key: "saas.billing.usage.summary",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["saas", "billing", "usage"],
+    description: "Get usage summary for the current billing period.",
+    goal: "Show usage vs limits.",
+    context: "Billing page, usage dashboards."
+  },
+  io: {
+    input: GetUsageSummaryInputModel,
+    output: GetUsageSummaryOutputModel
+  },
+  policy: {
+    auth: "user"
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "get-usage-happy-path",
+        given: ["Organization has usage history"],
+        when: ["User requests usage summary"],
+        then: ["Usage metrics are returned"]
+      }
+    ],
+    examples: [
+      {
+        key: "get-current-usage",
+        input: { period: "current" },
+        output: { features: [{ name: "api_calls", used: 100, limit: 1000 }] }
+      }
+    ]
+  }
+});
+var CheckFeatureAccessContract = defineQuery({
+  meta: {
+    key: "saas.billing.feature.check",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["saas", "billing", "feature"],
+    description: "Check if organization has access to a feature.",
+    goal: "Gate features based on plan/usage.",
+    context: "Feature access checks, upgrade prompts."
+  },
+  io: {
+    input: CheckFeatureAccessInputModel,
+    output: CheckFeatureAccessOutputModel
+  },
+  policy: {
+    auth: "user"
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "check-access-granted",
+        given: ["Organization is on Pro plan"],
+        when: ["User checks access to Pro feature"],
+        then: ["Access is granted"]
+      }
+    ],
+    examples: [
+      {
+        key: "check-advanced-reports",
+        input: { feature: "advanced_reports" },
+        output: { hasAccess: true, reason: "Included in Pro plan" }
+      }
+    ]
+  }
+});
+
+// src/billing/billing.presentation.ts
+import { definePresentation, StabilityEnum } from "@contractspec/lib.contracts";
+var SubscriptionPresentation = definePresentation({
+  meta: {
+    key: "saas.billing.subscription",
+    version: "1.0.0",
+    title: "Subscription Status",
+    description: "Subscription status with plan info, limits, and current usage",
+    domain: "saas-boilerplate",
+    owners: ["@saas-team"],
+    tags: ["billing", "subscription"],
+    stability: StabilityEnum.Beta,
+    goal: "View subscription plan and status",
+    context: "Billing section"
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "SubscriptionView"
+  },
+  targets: ["react", "markdown"],
+  policy: {
+    flags: ["saas.billing.enabled"]
+  }
+});
+var UsageDashboardPresentation = definePresentation({
+  meta: {
+    key: "saas.billing.usage",
+    version: "1.0.0",
+    title: "Usage Dashboard",
+    description: "Usage metrics and breakdown by resource type",
+    domain: "saas-boilerplate",
+    owners: ["@saas-team"],
+    tags: ["billing", "usage", "metrics"],
+    stability: StabilityEnum.Beta,
+    goal: "Monitor feature usage and limits",
+    context: "Billing section"
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "UsageDashboardView"
+  },
+  targets: ["react", "markdown"],
+  policy: {
+    flags: ["saas.billing.enabled"]
+  }
+});
+// src/dashboard/dashboard.presentation.ts
+import { definePresentation as definePresentation2, StabilityEnum as StabilityEnum2 } from "@contractspec/lib.contracts";
+var SaasDashboardPresentation = definePresentation2({
+  meta: {
+    key: "saas.dashboard",
+    version: "1.0.0",
+    title: "SaaS Dashboard",
+    description: "Main SaaS dashboard with project overview, usage stats, and quick actions",
+    domain: "saas-boilerplate",
+    owners: ["@saas-team"],
+    tags: ["dashboard", "overview"],
+    stability: StabilityEnum2.Beta,
+    goal: "Overview of SaaS activity and metrics",
+    context: "Main dashboard"
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "SaasDashboard"
+  },
+  targets: ["react", "markdown"],
+  policy: {
+    flags: ["saas.enabled"]
+  }
+});
+var SettingsPanelPresentation = definePresentation2({
+  meta: {
+    key: "saas.settings",
+    version: "1.0.0",
+    title: "Settings Panel",
+    description: "Organization and user settings panel",
+    domain: "saas-boilerplate",
+    owners: ["@saas-team"],
+    tags: ["settings", "config"],
+    stability: StabilityEnum2.Beta,
+    goal: "Configure organization and user settings",
+    context: "Settings section"
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "SettingsPanel"
+  },
+  targets: ["react"],
+  policy: {
+    flags: ["saas.enabled"]
+  }
+});
+// src/docs/saas-boilerplate.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var saasBoilerplateDocBlocks = [
+  {
+    id: "docs.examples.saas-boilerplate.goal",
+    title: "SaaS Boilerplate — Goal",
+    summary: "Multi-tenant SaaS foundation with orgs, members, projects, settings, and usage.",
+    kind: "goal",
+    visibility: "public",
+    route: "/docs/examples/saas-boilerplate/goal",
+    tags: ["saas", "goal"],
+    body: `## Why it matters
+- Provides a regenerable SaaS base: orgs, members, projects, settings, usage/billing.
+- Avoids drift across identity, settings, and usage capture.
+
+## Business/Product goal
+- Ship SaaS faster with tenant isolation, RBAC, and usage metering baked in.
+- Keep audit/notifications ready for compliance and customer comms.
+
+## Success criteria
+- Spec changes to org/project/settings/usage regenerate UI/API/events cleanly.
+- Tenant isolation and RBAC stay enforced; usage data is captured with PII scopes.`
+  },
+  {
+    id: "docs.examples.saas-boilerplate.usage",
+    title: "SaaS Boilerplate — Usage",
+    summary: "How to seed, extend, and regenerate the SaaS base.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/examples/saas-boilerplate/usage",
+    tags: ["saas", "usage"],
+    body: `## Setup
+1) Seed (if available) or create orgs, members, and projects via UI.
+2) Configure Notifications for invites and project events; set policy.pii for sensitive fields.
+
+## Extend & regenerate
+1) Adjust schemas (project metadata, settings, usage records) in spec.
+2) Regenerate to sync UI/API/events and usage metering.
+3) Use Feature Flags to roll out new settings or billing fields gradually.
+
+## Guardrails
+- Keep tenant/role context explicit in contracts and presentations.
+- Emit events for invites, project changes, and usage records; log in Audit Trail.
+- Redact sensitive user/org data in markdown/JSON outputs.`
+  },
+  {
+    id: "docs.examples.saas-boilerplate.reference",
+    title: "SaaS Boilerplate — Reference",
+    summary: "Entities, contracts, events, and presentations for the SaaS starter.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/saas-boilerplate",
+    tags: ["saas", "reference"],
+    body: `## Entities
+- Organization, Member, Role, Project, AppSettings, UserSettings, BillingUsage.
+
+## Contracts
+- org/project CRUD, invites, role assignment, usage recording.
+
+## Events
+- org.created, member.invited/accepted, project.created/updated, usage.recorded.
+
+## Presentations
+- Org/project dashboards, member management, settings screens, usage views.
+
+## Notes
+- Tenant isolation is mandatory; enforce via RBAC/policies.
+- Usage/Metering drives billing/limits; keep units explicit.`
+  },
+  {
+    id: "docs.examples.saas-boilerplate.constraints",
+    title: "SaaS Boilerplate — Constraints & Safety",
+    summary: "Internal guardrails for tenancy, RBAC, usage metering, and regeneration.",
+    kind: "reference",
+    visibility: "internal",
+    route: "/docs/examples/saas-boilerplate/constraints",
+    tags: ["saas", "constraints", "internal"],
+    body: `## Constraints
+- Tenant isolation and RBAC must remain explicit in spec; no implicit defaults in code.
+- Events to emit: org.created, member.invited/accepted, project.created/updated, usage.recorded.
+- Regeneration must not change billing/usage semantics without spec diffs.
+
+## PII & Settings
+- Mark PII (user emails, names) for redaction; keep settings scoped to org/member.
+- Avoid leaking secrets/config in markdown/JSON presentations.
+
+## Verification
+- Add fixtures for usage recording and role changes.
+- Ensure Audit/Notifications remain wired for invites/project updates.
+- Use Feature Flags for new settings/billing fields; default safe/off.`
+  }
+];
+registerDocBlocks(saasBoilerplateDocBlocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "saas-boilerplate",
+    version: "1.0.0",
+    title: "SaaS Boilerplate",
+    description: "Multi-tenant SaaS foundation with orgs, projects, settings, billing usage, and RBAC.",
+    kind: "template",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["saas", "multi-tenant", "billing", "rbac"]
+  },
+  docs: {
+    rootDocId: "docs.examples.saas-boilerplate"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.saas-boilerplate",
+    feature: "./feature",
+    contracts: "./contracts",
+    presentations: "./presentations",
+    handlers: "./handlers",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: {
+      enabled: true,
+      modes: ["playground", "specs", "builder", "markdown", "evolution"]
+    },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+
+// src/project/project.handler.ts
+async function mockListProjectsHandler(input) {
+  const { status, search, limit = 20, offset = 0 } = input;
+  let filtered = [...MOCK_PROJECTS];
+  if (status && status !== "all") {
+    filtered = filtered.filter((p) => p.status === status);
+  }
+  if (search) {
+    const q = search.toLowerCase();
+    filtered = filtered.filter((p) => p.name.toLowerCase().includes(q) || p.description?.toLowerCase().includes(q) || p.tags.some((t) => t.toLowerCase().includes(q)));
+  }
+  filtered.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+  const total = filtered.length;
+  const projects = filtered.slice(offset, offset + limit);
+  return {
+    projects,
+    total
+  };
+}
+async function mockGetProjectHandler(input) {
+  const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
+  if (!project) {
+    throw new Error("NOT_FOUND");
+  }
+  return project;
+}
+async function mockCreateProjectHandler(input, context) {
+  if (input.slug) {
+    const exists = MOCK_PROJECTS.some((p) => p.slug === input.slug);
+    if (exists) {
+      throw new Error("SLUG_EXISTS");
+    }
+  }
+  const now = new Date;
+  return {
+    id: `proj-${Date.now()}`,
+    name: input.name,
+    description: input.description,
+    slug: input.slug ?? input.name.toLowerCase().replace(/\s+/g, "-"),
+    organizationId: context.organizationId,
+    createdBy: context.userId,
+    status: "DRAFT",
+    isPublic: input.isPublic ?? false,
+    tags: input.tags ?? [],
+    createdAt: now,
+    updatedAt: now
+  };
+}
+async function mockUpdateProjectHandler(input) {
+  const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
+  if (!project) {
+    throw new Error("NOT_FOUND");
+  }
+  return {
+    ...project,
+    name: input.name ?? project.name,
+    description: input.description ?? project.description,
+    slug: input.slug ?? project.slug,
+    isPublic: input.isPublic ?? project.isPublic,
+    tags: input.tags ?? project.tags,
+    status: input.status ?? project.status,
+    updatedAt: new Date
+  };
+}
+async function mockDeleteProjectHandler(input) {
+  const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
+  if (!project) {
+    throw new Error("NOT_FOUND");
+  }
+  return { success: true };
+}
+
+// src/handlers/saas.handlers.ts
+import { web } from "@contractspec/lib.runtime-sandbox";
+var { generateId } = web;
+function rowToProject(row) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    organizationId: row.organizationId,
+    name: row.name,
+    description: row.description ?? undefined,
+    status: row.status,
+    tier: row.tier,
+    createdAt: new Date(row.createdAt),
+    updatedAt: new Date(row.updatedAt)
+  };
+}
+function rowToSubscription(row) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    organizationId: row.organizationId,
+    plan: row.plan,
+    status: row.status,
+    billingCycle: row.billingCycle,
+    currentPeriodStart: new Date(row.currentPeriodStart),
+    currentPeriodEnd: new Date(row.currentPeriodEnd),
+    cancelAtPeriodEnd: Boolean(row.cancelAtPeriodEnd)
+  };
+}
+function createSaasHandlers(db) {
+  async function listProjects(input) {
+    const {
+      projectId,
+      organizationId,
+      status,
+      search,
+      limit = 20,
+      offset = 0
+    } = input;
+    let whereClause = "WHERE projectId = ?";
+    const params = [projectId];
+    if (organizationId) {
+      whereClause += " AND organizationId = ?";
+      params.push(organizationId);
+    }
+    if (status && status !== "all") {
+      whereClause += " AND status = ?";
+      params.push(status);
+    }
+    if (search) {
+      whereClause += " AND (name LIKE ? OR description LIKE ?)";
+      params.push(`%${search}%`, `%${search}%`);
+    }
+    const countResult = (await db.query(`SELECT COUNT(*) as count FROM saas_project ${whereClause}`, params)).rows;
+    const total = countResult[0]?.count ?? 0;
+    const rows = (await db.query(`SELECT * FROM saas_project ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
+    return {
+      items: rows.map(rowToProject),
+      total,
+      hasMore: offset + rows.length < total
+    };
+  }
+  async function getProject(id) {
+    const rows = (await db.query(`SELECT * FROM saas_project WHERE id = ?`, [id])).rows;
+    return rows[0] ? rowToProject(rows[0]) : null;
+  }
+  async function createProject(input, context) {
+    const id = generateId("proj");
+    const now = new Date().toISOString();
+    await db.execute(`INSERT INTO saas_project (id, projectId, organizationId, name, description, status, tier, createdAt, updatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      context.projectId,
+      context.organizationId,
+      input.name,
+      input.description ?? null,
+      "DRAFT",
+      input.tier ?? "FREE",
+      now,
+      now
+    ]);
+    const rows = (await db.query(`SELECT * FROM saas_project WHERE id = ?`, [id])).rows;
+    return rowToProject(rows[0]);
+  }
+  async function updateProject(input) {
+    const now = new Date().toISOString();
+    const updates = ["updatedAt = ?"];
+    const params = [now];
+    if (input.name !== undefined) {
+      updates.push("name = ?");
+      params.push(input.name);
+    }
+    if (input.description !== undefined) {
+      updates.push("description = ?");
+      params.push(input.description);
+    }
+    if (input.status !== undefined) {
+      updates.push("status = ?");
+      params.push(input.status);
+    }
+    params.push(input.id);
+    await db.execute(`UPDATE saas_project SET ${updates.join(", ")} WHERE id = ?`, params);
+    const rows = (await db.query(`SELECT * FROM saas_project WHERE id = ?`, [input.id])).rows;
+    if (!rows[0]) {
+      throw new Error("NOT_FOUND");
+    }
+    return rowToProject(rows[0]);
+  }
+  async function deleteProject(id) {
+    await db.execute(`DELETE FROM saas_project WHERE id = ?`, [id]);
+  }
+  async function getSubscription(input) {
+    let query = `SELECT * FROM saas_subscription WHERE projectId = ?`;
+    const params = [input.projectId];
+    if (input.organizationId) {
+      query += " AND organizationId = ?";
+      params.push(input.organizationId);
+    }
+    query += " LIMIT 1";
+    const rows = (await db.query(query, params)).rows;
+    return rows[0] ? rowToSubscription(rows[0]) : null;
+  }
+  return {
+    listProjects,
+    getProject,
+    createProject,
+    updateProject,
+    deleteProject,
+    getSubscription
+  };
+}
+// src/project/project.enum.ts
+import { defineEnum as defineEnum2 } from "@contractspec/lib.schema";
+var ProjectStatusSchemaEnum = defineEnum2("ProjectStatus", [
+  "DRAFT",
+  "ACTIVE",
+  "ARCHIVED",
+  "DELETED"
+]);
+var ProjectStatusFilterEnum = defineEnum2("ProjectStatusFilter", [
+  "DRAFT",
+  "ACTIVE",
+  "ARCHIVED",
+  "all"
+]);
+
+// src/project/project.schema.ts
+import { defineSchemaModel as defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
+var ProjectModel = defineSchemaModel3({
+  name: "Project",
+  description: "A project within an organization",
+  fields: {
+    id: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum3.String_unsecure(), isOptional: true },
+    slug: { type: ScalarTypeEnum3.String_unsecure(), isOptional: true },
+    organizationId: {
+      type: ScalarTypeEnum3.String_unsecure(),
+      isOptional: false
+    },
+    createdBy: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
+    status: { type: ProjectStatusSchemaEnum, isOptional: false },
+    isPublic: { type: ScalarTypeEnum3.Boolean(), isOptional: false },
+    tags: {
+      type: ScalarTypeEnum3.String_unsecure(),
+      isArray: true,
+      isOptional: false
+    },
+    createdAt: { type: ScalarTypeEnum3.DateTime(), isOptional: false },
+    updatedAt: { type: ScalarTypeEnum3.DateTime(), isOptional: false }
+  }
+});
+var CreateProjectInputModel = defineSchemaModel3({
+  name: "CreateProjectInput",
+  description: "Input for creating a project",
+  fields: {
+    name: { type: ScalarTypeEnum3.NonEmptyString(), isOptional: false },
+    description: { type: ScalarTypeEnum3.String_unsecure(), isOptional: true },
+    slug: { type: ScalarTypeEnum3.String_unsecure(), isOptional: true },
+    isPublic: { type: ScalarTypeEnum3.Boolean(), isOptional: true },
+    tags: {
+      type: ScalarTypeEnum3.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    }
+  }
+});
+var UpdateProjectInputModel = defineSchemaModel3({
+  name: "UpdateProjectInput",
+  description: "Input for updating a project",
+  fields: {
+    projectId: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum3.String_unsecure(), isOptional: true },
+    description: { type: ScalarTypeEnum3.String_unsecure(), isOptional: true },
+    slug: { type: ScalarTypeEnum3.String_unsecure(), isOptional: true },
+    isPublic: { type: ScalarTypeEnum3.Boolean(), isOptional: true },
+    tags: {
+      type: ScalarTypeEnum3.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    status: { type: ProjectStatusSchemaEnum, isOptional: true }
+  }
+});
+var GetProjectInputModel = defineSchemaModel3({
+  name: "GetProjectInput",
+  fields: {
+    projectId: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false }
+  }
+});
+var DeleteProjectInputModel = defineSchemaModel3({
+  name: "DeleteProjectInput",
+  fields: {
+    projectId: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false }
+  }
+});
+var DeleteProjectOutputModel = defineSchemaModel3({
+  name: "DeleteProjectOutput",
+  fields: {
+    success: { type: ScalarTypeEnum3.Boolean(), isOptional: false }
+  }
+});
+var ProjectDeletedPayloadModel = defineSchemaModel3({
+  name: "ProjectDeletedPayload",
+  fields: {
+    projectId: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false }
+  }
+});
+var ListProjectsInputModel = defineSchemaModel3({
+  name: "ListProjectsInput",
+  description: "Input for listing projects",
+  fields: {
+    status: { type: ProjectStatusFilterEnum, isOptional: true },
+    search: { type: ScalarTypeEnum3.String_unsecure(), isOptional: true },
+    limit: {
+      type: ScalarTypeEnum3.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 20
+    },
+    offset: {
+      type: ScalarTypeEnum3.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 0
+    }
+  }
+});
+var ListProjectsOutputModel = defineSchemaModel3({
+  name: "ListProjectsOutput",
+  description: "Output for listing projects",
+  fields: {
+    projects: { type: ProjectModel, isArray: true, isOptional: false },
+    total: { type: ScalarTypeEnum3.Int_unsecure(), isOptional: false }
+  }
+});
+
+// src/project/project.operations.ts
+import {
+  defineCommand as defineCommand2,
+  defineQuery as defineQuery2
+} from "@contractspec/lib.contracts/operations";
+var OWNERS2 = ["example.saas-boilerplate"];
+var CreateProjectContract = defineCommand2({
+  meta: {
+    key: "saas.project.create",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS2],
+    tags: ["saas", "project", "create"],
+    description: "Create a new project in the organization.",
+    goal: "Allow users to create projects for organizing work.",
+    context: "Called from project creation UI or API."
+  },
+  io: {
+    input: CreateProjectInputModel,
+    output: ProjectModel,
+    errors: {
+      SLUG_EXISTS: {
+        description: "A project with this slug already exists",
+        http: 409,
+        gqlCode: "SLUG_EXISTS",
+        when: "Slug is already taken in the organization"
+      },
+      LIMIT_REACHED: {
+        description: "Project limit reached for this plan",
+        http: 403,
+        gqlCode: "LIMIT_REACHED",
+        when: "Organization has reached project limit"
+      }
+    }
+  },
+  policy: {
+    auth: "user"
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: "project.created",
+        version: "1.0.0",
+        when: "Project is created",
+        payload: ProjectModel
+      }
+    ],
+    audit: ["project.created"]
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "create-project-happy-path",
+        given: ["User is authenticated"],
+        when: ["User creates project"],
+        then: ["Project is created", "ProjectCreated event is emitted"]
+      }
+    ],
+    examples: [
+      {
+        key: "create-basic",
+        input: { name: "Website Redesign", slug: "website-redesign" },
+        output: { id: "proj-123", name: "Website Redesign", isArchived: false }
+      }
+    ]
+  }
+});
+var GetProjectContract = defineQuery2({
+  meta: {
+    key: "saas.project.get",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS2],
+    tags: ["saas", "project", "get"],
+    description: "Get a project by ID.",
+    goal: "Retrieve project details.",
+    context: "Project detail page, API calls."
+  },
+  io: {
+    input: GetProjectInputModel,
+    output: ProjectModel,
+    errors: {
+      NOT_FOUND: {
+        description: "Project not found",
+        http: 404,
+        gqlCode: "NOT_FOUND",
+        when: "Project ID is invalid or user lacks access"
+      }
+    }
+  },
+  policy: {
+    auth: "user"
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "get-project-happy-path",
+        given: ["Project exists"],
+        when: ["User requests project"],
+        then: ["Project details are returned"]
+      }
+    ],
+    examples: [
+      {
+        key: "get-existing",
+        input: { projectId: "proj-123" },
+        output: { id: "proj-123", name: "Website Redesign" }
+      }
+    ]
+  }
+});
+var UpdateProjectContract = defineCommand2({
+  meta: {
+    key: "saas.project.update",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS2],
+    tags: ["saas", "project", "update"],
+    description: "Update project details.",
+    goal: "Allow project owners/editors to modify project.",
+    context: "Project settings page."
+  },
+  io: {
+    input: UpdateProjectInputModel,
+    output: ProjectModel
+  },
+  policy: {
+    auth: "user"
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: "project.updated",
+        version: "1.0.0",
+        when: "Project is updated",
+        payload: ProjectModel
+      }
+    ],
+    audit: ["project.updated"]
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "update-project-happy-path",
+        given: ["Project exists"],
+        when: ["User updates description"],
+        then: ["Project is updated", "ProjectUpdated event is emitted"]
+      }
+    ],
+    examples: [
+      {
+        key: "update-desc",
+        input: { projectId: "proj-123", description: "New description" },
+        output: { id: "proj-123", description: "New description" }
+      }
+    ]
+  }
+});
+var DeleteProjectContract = defineCommand2({
+  meta: {
+    key: "saas.project.delete",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS2],
+    tags: ["saas", "project", "delete"],
+    description: "Delete a project (soft delete).",
+    goal: "Allow project owners to remove projects.",
+    context: "Project settings page."
+  },
+  io: {
+    input: DeleteProjectInputModel,
+    output: DeleteProjectOutputModel
+  },
+  policy: {
+    auth: "user"
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: "project.deleted",
+        version: "1.0.0",
+        when: "Project is deleted",
+        payload: ProjectDeletedPayloadModel
+      }
+    ],
+    audit: ["project.deleted"]
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "delete-project-happy-path",
+        given: ["Project exists"],
+        when: ["User deletes project"],
+        then: ["Project is deleted", "ProjectDeleted event is emitted"]
+      }
+    ],
+    examples: [
+      {
+        key: "delete-existing",
+        input: { projectId: "proj-123" },
+        output: { success: true }
+      }
+    ]
+  }
+});
+var ListProjectsContract = defineQuery2({
+  meta: {
+    key: "saas.project.list",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS2],
+    tags: ["saas", "project", "list"],
+    description: "List projects in the organization.",
+    goal: "Show all projects user has access to.",
+    context: "Project list page, dashboard."
+  },
+  io: {
+    input: ListProjectsInputModel,
+    output: ListProjectsOutputModel
+  },
+  policy: {
+    auth: "user"
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "list-projects-happy-path",
+        given: ["Projects exist"],
+        when: ["User lists projects"],
+        then: ["List of projects is returned"]
+      }
+    ],
+    examples: [
+      {
+        key: "list-all",
+        input: { limit: 10 },
+        output: { items: [], total: 5 }
+      }
+    ]
+  }
+});
+
+// src/project/project.event.ts
+import { ScalarTypeEnum as ScalarTypeEnum4, defineSchemaModel as defineSchemaModel4 } from "@contractspec/lib.schema";
+import { defineEvent as defineEvent2 } from "@contractspec/lib.contracts";
+var ProjectCreatedPayload = defineSchemaModel4({
+  name: "ProjectCreatedPayload",
+  description: "Payload when a project is created",
+  fields: {
+    projectId: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum4.String_unsecure(),
+      isOptional: false
+    },
+    createdBy: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum4.DateTime(), isOptional: false }
+  }
+});
+var ProjectUpdatedPayload = defineSchemaModel4({
+  name: "ProjectUpdatedPayload",
+  description: "Payload when a project is updated",
+  fields: {
+    projectId: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false },
+    updatedFields: {
+      type: ScalarTypeEnum4.String_unsecure(),
+      isArray: true,
+      isOptional: false
+    },
+    updatedBy: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false },
+    updatedAt: { type: ScalarTypeEnum4.DateTime(), isOptional: false }
+  }
+});
+var ProjectDeletedPayload = defineSchemaModel4({
+  name: "ProjectDeletedPayload",
+  description: "Payload when a project is deleted",
+  fields: {
+    projectId: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum4.String_unsecure(),
+      isOptional: false
+    },
+    deletedBy: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false },
+    deletedAt: { type: ScalarTypeEnum4.DateTime(), isOptional: false }
+  }
+});
+var ProjectArchivedPayload = defineSchemaModel4({
+  name: "ProjectArchivedPayload",
+  description: "Payload when a project is archived",
+  fields: {
+    projectId: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false },
+    archivedBy: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false },
+    archivedAt: { type: ScalarTypeEnum4.DateTime(), isOptional: false }
+  }
+});
+var ProjectCreatedEvent = defineEvent2({
+  meta: {
+    key: "project.created",
+    version: "1.0.0",
+    description: "A new project has been created.",
+    stability: "stable",
+    owners: ["@saas-team"],
+    tags: ["project", "created"]
+  },
+  payload: ProjectCreatedPayload
+});
+var ProjectUpdatedEvent = defineEvent2({
+  meta: {
+    key: "project.updated",
+    version: "1.0.0",
+    description: "A project has been updated.",
+    stability: "stable",
+    owners: ["@saas-team"],
+    tags: ["project", "updated"]
+  },
+  payload: ProjectUpdatedPayload
+});
+var ProjectDeletedEvent = defineEvent2({
+  meta: {
+    key: "project.deleted",
+    version: "1.0.0",
+    description: "A project has been deleted.",
+    stability: "stable",
+    owners: ["@saas-team"],
+    tags: ["project", "deleted"]
+  },
+  payload: ProjectDeletedPayload
+});
+var ProjectArchivedEvent = defineEvent2({
+  meta: {
+    key: "project.archived",
+    version: "1.0.0",
+    description: "A project has been archived.",
+    stability: "stable",
+    owners: ["@saas-team"],
+    tags: ["project", "archived"]
+  },
+  payload: ProjectArchivedPayload
+});
+
+// src/project/project.entity.ts
+import {
+  defineEntity as defineEntity2,
+  defineEntityEnum as defineEntityEnum2,
+  field as field2,
+  index as index2
+} from "@contractspec/lib.schema";
+var ProjectStatusEnum = defineEntityEnum2({
+  name: "ProjectStatus",
+  values: ["DRAFT", "ACTIVE", "ARCHIVED", "DELETED"],
+  schema: "saas_app",
+  description: "Status of a project."
+});
+var ProjectEntity = defineEntity2({
+  name: "Project",
+  description: "A project belonging to an organization.",
+  schema: "saas_app",
+  map: "project",
+  fields: {
+    id: field2.id({ description: "Unique project ID" }),
+    name: field2.string({ description: "Project name" }),
+    description: field2.string({
+      isOptional: true,
+      description: "Project description"
+    }),
+    slug: field2.string({
+      isOptional: true,
+      description: "URL-friendly identifier"
+    }),
+    organizationId: field2.foreignKey({ description: "Owning organization" }),
+    createdBy: field2.foreignKey({
+      description: "User who created the project"
+    }),
+    status: field2.enum("ProjectStatus", { default: "DRAFT" }),
+    isPublic: field2.boolean({
+      default: false,
+      description: "Whether project is publicly visible"
+    }),
+    settings: field2.json({
+      isOptional: true,
+      description: "Project-specific settings"
+    }),
+    tags: field2.string({ isArray: true, description: "Project tags" }),
+    metadata: field2.json({ isOptional: true }),
+    createdAt: field2.createdAt(),
+    updatedAt: field2.updatedAt(),
+    archivedAt: field2.dateTime({ isOptional: true })
+  },
+  indexes: [
+    index2.on(["organizationId", "status"]),
+    index2.on(["organizationId", "createdAt"]),
+    index2.unique(["organizationId", "slug"])
+  ],
+  enums: [ProjectStatusEnum]
+});
+var ProjectMemberEntity = defineEntity2({
+  name: "ProjectMember",
+  description: "User access to a specific project.",
+  schema: "saas_app",
+  map: "project_member",
+  fields: {
+    id: field2.id(),
+    projectId: field2.foreignKey(),
+    userId: field2.foreignKey(),
+    role: field2.string({
+      description: "Role in project (owner, editor, viewer)"
+    }),
+    addedBy: field2.string({ isOptional: true }),
+    createdAt: field2.createdAt()
+  },
+  indexes: [index2.unique(["projectId", "userId"])]
+});
+
+// src/project/project.presentation.ts
+import { definePresentation as definePresentation3, StabilityEnum as StabilityEnum3 } from "@contractspec/lib.contracts";
+var ProjectListPresentation = definePresentation3({
+  meta: {
+    key: "saas.project.list",
+    version: "1.0.0",
+    title: "Project List",
+    description: "List view of projects with status, tags, and last updated info",
+    domain: "saas-boilerplate",
+    owners: ["@saas-team"],
+    tags: ["project", "list", "dashboard"],
+    stability: StabilityEnum3.Beta,
+    goal: "Browse and manage projects",
+    context: "Project list page"
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "ProjectListView",
+    props: ProjectModel
+  },
+  targets: ["react", "markdown", "application/json"],
+  policy: {
+    flags: ["saas.projects.enabled"]
+  }
+});
+var ProjectDetailPresentation = definePresentation3({
+  meta: {
+    key: "saas.project.detail",
+    version: "1.0.0",
+    title: "Project Details",
+    description: "Detailed view of a project with settings and activity",
+    domain: "saas-boilerplate",
+    owners: ["@saas-team"],
+    tags: ["project", "detail"],
+    stability: StabilityEnum3.Beta,
+    goal: "View and edit project details",
+    context: "Project detail page"
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "ProjectDetailView"
+  },
+  targets: ["react", "markdown"],
+  policy: {
+    flags: ["saas.projects.enabled"]
+  }
+});
+// src/settings/settings.enum.ts
+import { defineEntityEnum as defineEntityEnum3 } from "@contractspec/lib.schema";
+var SettingsScopeEnum = defineEntityEnum3({
+  name: "SettingsScope",
+  values: ["APP", "ORG", "USER", "PROJECT"],
+  schema: "saas_app",
+  description: "Scope of a setting."
+});
+
+// src/settings/settings.entity.ts
+import { defineEntity as defineEntity3, field as field3, index as index3 } from "@contractspec/lib.schema";
+var SettingsEntity = defineEntity3({
+  name: "Settings",
+  description: "Application, organization, or user settings.",
+  schema: "saas_app",
+  map: "settings",
+  fields: {
+    id: field3.id(),
+    key: field3.string({
+      description: 'Setting key (e.g., "theme", "notifications.email")'
+    }),
+    scope: field3.enum("SettingsScope"),
+    scopeId: field3.string({
+      isOptional: true,
+      description: "ID of scoped entity (org, user, project)"
+    }),
+    value: field3.json({ description: "Setting value" }),
+    valueType: field3.string({
+      default: '"string"',
+      description: "Type hint for value"
+    }),
+    schema: field3.json({
+      isOptional: true,
+      description: "JSON schema for validation"
+    }),
+    description: field3.string({ isOptional: true }),
+    isSecret: field3.boolean({
+      default: false,
+      description: "Whether value should be encrypted"
+    }),
+    createdAt: field3.createdAt(),
+    updatedAt: field3.updatedAt()
+  },
+  indexes: [
+    index3.unique(["scope", "scopeId", "key"]),
+    index3.on(["scope", "key"])
+  ],
+  enums: [SettingsScopeEnum]
+});
+var FeatureFlagEntity = defineEntity3({
+  name: "FeatureFlag",
+  description: "Feature flags for progressive rollout.",
+  schema: "saas_app",
+  map: "feature_flag",
+  fields: {
+    id: field3.id(),
+    key: field3.string({ isUnique: true, description: "Feature flag key" }),
+    name: field3.string({ description: "Human-readable name" }),
+    description: field3.string({ isOptional: true }),
+    enabled: field3.boolean({ default: false }),
+    defaultValue: field3.boolean({ default: false }),
+    rules: field3.json({ isOptional: true, description: "Targeting rules" }),
+    rolloutPercentage: field3.int({
+      default: 0,
+      description: "Percentage rollout (0-100)"
+    }),
+    createdAt: field3.createdAt(),
+    updatedAt: field3.updatedAt()
+  }
+});
+// src/saas-boilerplate.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts";
+var SaasBoilerplateFeature = defineFeature({
+  meta: {
+    key: "saas-boilerplate",
+    title: "SaaS Boilerplate",
+    description: "SaaS application foundation with projects, billing, and settings",
+    domain: "saas",
+    owners: ["@saas-team"],
+    tags: ["saas", "projects", "billing"],
+    stability: "experimental",
+    version: "1.0.0"
+  },
+  operations: [
+    { key: "saas.project.create", version: "1.0.0" },
+    { key: "saas.project.get", version: "1.0.0" },
+    { key: "saas.project.update", version: "1.0.0" },
+    { key: "saas.project.delete", version: "1.0.0" },
+    { key: "saas.project.list", version: "1.0.0" },
+    { key: "saas.billing.subscription.get", version: "1.0.0" },
+    { key: "saas.billing.usage.record", version: "1.0.0" },
+    { key: "saas.billing.usage.summary", version: "1.0.0" },
+    { key: "saas.billing.feature.check", version: "1.0.0" }
+  ],
+  events: [
+    { key: "project.created", version: "1.0.0" },
+    { key: "project.updated", version: "1.0.0" },
+    { key: "project.deleted", version: "1.0.0" },
+    { key: "project.archived", version: "1.0.0" },
+    { key: "billing.usage.recorded", version: "1.0.0" },
+    { key: "billing.subscription.changed", version: "1.0.0" },
+    { key: "billing.limit.reached", version: "1.0.0" }
+  ],
+  presentations: [
+    { key: "saas.dashboard", version: "1.0.0" },
+    { key: "saas.project.list", version: "1.0.0" },
+    { key: "saas.project.detail", version: "1.0.0" },
+    { key: "saas.billing.subscription", version: "1.0.0" },
+    { key: "saas.billing.usage", version: "1.0.0" },
+    { key: "saas.settings", version: "1.0.0" }
+  ],
+  opToPresentation: [
+    {
+      op: { key: "saas.project.list", version: "1.0.0" },
+      pres: { key: "saas.project.list", version: "1.0.0" }
+    },
+    {
+      op: { key: "saas.project.get", version: "1.0.0" },
+      pres: { key: "saas.project.detail", version: "1.0.0" }
+    },
+    {
+      op: { key: "saas.billing.subscription.get", version: "1.0.0" },
+      pres: { key: "saas.billing.subscription", version: "1.0.0" }
+    },
+    {
+      op: { key: "saas.billing.usage.summary", version: "1.0.0" },
+      pres: { key: "saas.billing.usage", version: "1.0.0" }
+    }
+  ],
+  presentationsTargets: [
+    { key: "saas.dashboard", version: "1.0.0", targets: ["react", "markdown"] },
+    {
+      key: "saas.project.list",
+      version: "1.0.0",
+      targets: ["react", "markdown", "application/json"]
+    },
+    {
+      key: "saas.billing.subscription",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    },
+    {
+      key: "saas.billing.usage",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    }
+  ],
+  capabilities: {
+    requires: [
+      { key: "identity", version: "1.0.0" },
+      { key: "audit-trail", version: "1.0.0" },
+      { key: "notifications", version: "1.0.0" }
+    ]
+  }
+});
+
+// src/ui/hooks/useProjectList.ts
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+function useProjectList(options = {}) {
+  const { handlers, projectId } = useTemplateRuntime();
+  const { saas: saas2 } = handlers;
+  const [data, setData] = useState(null);
+  const [subscription, setSubscription] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const [page, setPage] = useState(1);
+  const fetchData = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const [projectsResult, subscriptionResult] = await Promise.all([
+        saas2.listProjects({
+          projectId,
+          status: options.status === "all" ? undefined : options.status,
+          search: options.search,
+          limit: options.limit ?? 20,
+          offset: (page - 1) * (options.limit ?? 20)
+        }),
+        saas2.getSubscription({ projectId })
+      ]);
+      setData({
+        items: projectsResult.items,
+        total: projectsResult.total
+      });
+      setSubscription(subscriptionResult);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error("Unknown error"));
+    } finally {
+      setLoading(false);
+    }
+  }, [saas2, projectId, options.status, options.search, options.limit, page]);
+  useEffect(() => {
+    fetchData();
+  }, [fetchData]);
+  const stats = useMemo(() => {
+    if (!data)
+      return null;
+    const items = data.items;
+    return {
+      total: data.total,
+      activeCount: items.filter((p) => p.status === "ACTIVE").length,
+      draftCount: items.filter((p) => p.status === "DRAFT").length,
+      projectLimit: 10,
+      usagePercent: Math.min(data.total / 10 * 100, 100)
+    };
+  }, [data]);
+  return {
+    data,
+    subscription,
+    loading,
+    error,
+    stats,
+    page,
+    refetch: fetchData,
+    nextPage: () => setPage((p) => p + 1),
+    prevPage: () => page > 1 && setPage((p) => p - 1)
+  };
+}
+
+// src/ui/hooks/useProjectMutations.ts
+import { useCallback as useCallback2, useState as useState2 } from "react";
+import { useTemplateRuntime as useTemplateRuntime2 } from "@contractspec/lib.example-shared-ui";
+function useProjectMutations(options = {}) {
+  const { handlers, projectId } = useTemplateRuntime2();
+  const { saas: saas2 } = handlers;
+  const [createState, setCreateState] = useState2({
+    loading: false,
+    error: null,
+    data: null
+  });
+  const [updateState, setUpdateState] = useState2({
+    loading: false,
+    error: null,
+    data: null
+  });
+  const [deleteState, setDeleteState] = useState2({
+    loading: false,
+    error: null,
+    data: null
+  });
+  const createProject = useCallback2(async (input) => {
+    setCreateState({ loading: true, error: null, data: null });
+    try {
+      const result = await saas2.createProject(input, {
+        projectId,
+        organizationId: "demo-org"
+      });
+      setCreateState({ loading: false, error: null, data: result });
+      options.onSuccess?.();
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to create project");
+      setCreateState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return null;
+    }
+  }, [saas2, projectId, options]);
+  const updateProject = useCallback2(async (input) => {
+    setUpdateState({ loading: true, error: null, data: null });
+    try {
+      const result = await saas2.updateProject(input);
+      setUpdateState({ loading: false, error: null, data: result });
+      options.onSuccess?.();
+      return result;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to update project");
+      setUpdateState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return null;
+    }
+  }, [saas2, options]);
+  const deleteProject = useCallback2(async (id) => {
+    setDeleteState({ loading: true, error: null, data: null });
+    try {
+      await saas2.deleteProject(id);
+      setDeleteState({
+        loading: false,
+        error: null,
+        data: { success: true }
+      });
+      options.onSuccess?.();
+      return true;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error("Failed to delete project");
+      setDeleteState({ loading: false, error, data: null });
+      options.onError?.(error);
+      return false;
+    }
+  }, [saas2, options]);
+  const archiveProject = useCallback2(async (id) => {
+    return updateProject({ id, status: "ARCHIVED" });
+  }, [updateProject]);
+  const activateProject = useCallback2(async (id) => {
+    return updateProject({ id, status: "ACTIVE" });
+  }, [updateProject]);
+  return {
+    createProject,
+    updateProject,
+    deleteProject,
+    archiveProject,
+    activateProject,
+    createState,
+    updateState,
+    deleteState,
+    isLoading: createState.loading || updateState.loading || deleteState.loading
+  };
+}
+
+// src/ui/modals/CreateProjectModal.tsx
+import { useState as useState3 } from "react";
+import { Button, Input } from "@contractspec/lib.design-system";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+var TIERS = [
+  { value: "FREE", label: "Free" },
+  { value: "PRO", label: "Pro" },
+  { value: "ENTERPRISE", label: "Enterprise" }
+];
+function CreateProjectModal({
+  isOpen,
+  onClose,
+  onSubmit,
+  isLoading = false
+}) {
+  const [name, setName] = useState3("");
+  const [description, setDescription] = useState3("");
+  const [tier, setTier] = useState3("FREE");
+  const [error, setError] = useState3(null);
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    setError(null);
+    if (!name.trim()) {
+      setError("Project name is required");
+      return;
+    }
+    try {
+      await onSubmit({
+        name: name.trim(),
+        description: description.trim() || undefined,
+        tier
+      });
+      setName("");
+      setDescription("");
+      setTier("FREE");
+      onClose();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Failed to create project");
+    }
+  };
+  if (!isOpen)
+    return null;
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "fixed inset-0 z-50 flex items-center justify-center",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "bg-background/80 absolute inset-0 backdrop-blur-sm",
+        onClick: onClose,
+        role: "button",
+        tabIndex: 0,
+        onKeyDown: (e) => {
+          if (e.key === "Enter" || e.key === " ")
+            onClose();
+        },
+        "aria-label": "Close modal"
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "bg-card border-border relative z-10 w-full max-w-md rounded-xl border p-6 shadow-xl",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "mb-4 text-xl font-semibold",
+            children: "Create New Project"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("form", {
+            onSubmit: handleSubmit,
+            className: "space-y-4",
+            children: [
+              /* @__PURE__ */ jsxDEV("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("label", {
+                    htmlFor: "project-name",
+                    className: "text-muted-foreground mb-1 block text-sm font-medium",
+                    children: "Project Name *"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV(Input, {
+                    id: "project-name",
+                    value: name,
+                    onChange: (e) => setName(e.target.value),
+                    placeholder: "e.g., My Awesome Project",
+                    disabled: isLoading
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("label", {
+                    htmlFor: "project-description",
+                    className: "text-muted-foreground mb-1 block text-sm font-medium",
+                    children: "Description"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("textarea", {
+                    id: "project-description",
+                    value: description,
+                    onChange: (e) => setDescription(e.target.value),
+                    placeholder: "Describe what this project is about...",
+                    rows: 3,
+                    disabled: isLoading,
+                    className: "border-input bg-background focus:ring-ring w-full rounded-md border px-3 py-2 text-sm focus:ring-2 focus:outline-none disabled:opacity-50"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("label", {
+                    htmlFor: "project-tier",
+                    className: "text-muted-foreground mb-1 block text-sm font-medium",
+                    children: "Tier"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("select", {
+                    id: "project-tier",
+                    value: tier,
+                    onChange: (e) => setTier(e.target.value),
+                    disabled: isLoading,
+                    className: "border-input bg-background focus:ring-ring h-10 w-full rounded-md border px-3 py-2 text-sm focus:ring-2 focus:outline-none disabled:opacity-50",
+                    children: TIERS.map((t) => /* @__PURE__ */ jsxDEV("option", {
+                      value: t.value,
+                      children: t.label
+                    }, t.value, false, undefined, this))
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              error && /* @__PURE__ */ jsxDEV("div", {
+                className: "bg-destructive/10 text-destructive rounded-md p-3 text-sm",
+                children: error
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                className: "flex justify-end gap-3 pt-2",
+                children: [
+                  /* @__PURE__ */ jsxDEV(Button, {
+                    type: "button",
+                    variant: "ghost",
+                    onPress: onClose,
+                    disabled: isLoading,
+                    children: "Cancel"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV(Button, {
+                    type: "submit",
+                    disabled: isLoading,
+                    children: isLoading ? "Creating..." : "Create Project"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/ui/modals/ProjectActionsModal.tsx
+import { useEffect as useEffect2, useState as useState4 } from "react";
+import { Button as Button2, Input as Input2 } from "@contractspec/lib.design-system";
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+"use client";
+function ProjectActionsModal({
+  isOpen,
+  project,
+  onClose,
+  onUpdate,
+  onArchive,
+  onActivate,
+  onDelete,
+  isLoading = false
+}) {
+  const [mode, setMode] = useState4("menu");
+  const [name, setName] = useState4("");
+  const [description, setDescription] = useState4("");
+  const [error, setError] = useState4(null);
+  const resetForm = () => {
+    setMode("menu");
+    setError(null);
+    if (project) {
+      setName(project.name);
+      setDescription(project.description ?? "");
+    }
+  };
+  const handleClose = () => {
+    resetForm();
+    onClose();
+  };
+  useEffect2(() => {
+    if (project) {
+      setName(project.name);
+      setDescription(project.description ?? "");
+    }
+  }, [project]);
+  const handleEdit = async () => {
+    if (!project)
+      return;
+    setError(null);
+    if (!name.trim()) {
+      setError("Project name is required");
+      return;
+    }
+    try {
+      await onUpdate({
+        id: project.id,
+        name: name.trim(),
+        description: description.trim() || undefined
+      });
+      handleClose();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Failed to update project");
+    }
+  };
+  const handleArchive = async () => {
+    if (!project)
+      return;
+    setError(null);
+    try {
+      await onArchive(project.id);
+      handleClose();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Failed to archive project");
+    }
+  };
+  const handleActivate = async () => {
+    if (!project)
+      return;
+    setError(null);
+    try {
+      await onActivate(project.id);
+      handleClose();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Failed to activate project");
+    }
+  };
+  const handleDelete = async () => {
+    if (!project)
+      return;
+    setError(null);
+    try {
+      await onDelete(project.id);
+      handleClose();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Failed to delete project");
+    }
+  };
+  if (!isOpen || !project)
+    return null;
+  return /* @__PURE__ */ jsxDEV2("div", {
+    className: "fixed inset-0 z-50 flex items-center justify-center",
+    children: [
+      /* @__PURE__ */ jsxDEV2("div", {
+        className: "bg-background/80 absolute inset-0 backdrop-blur-sm",
+        onClick: handleClose,
+        role: "button",
+        tabIndex: 0,
+        onKeyDown: (e) => {
+          if (e.key === "Enter" || e.key === " ")
+            handleClose();
+        },
+        "aria-label": "Close modal"
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV2("div", {
+        className: "bg-card border-border relative z-10 w-full max-w-md rounded-xl border p-6 shadow-xl",
+        children: [
+          /* @__PURE__ */ jsxDEV2("div", {
+            className: "border-border mb-4 border-b pb-4",
+            children: [
+              /* @__PURE__ */ jsxDEV2("h2", {
+                className: "text-xl font-semibold",
+                children: project.name
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("p", {
+                className: "text-muted-foreground text-sm",
+                children: [
+                  project.tier,
+                  " · ",
+                  project.status
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          mode === "menu" && /* @__PURE__ */ jsxDEV2("div", {
+            className: "space-y-3",
+            children: [
+              /* @__PURE__ */ jsxDEV2(Button2, {
+                className: "w-full justify-start",
+                variant: "ghost",
+                onPress: () => setMode("edit"),
+                children: [
+                  /* @__PURE__ */ jsxDEV2("span", {
+                    className: "mr-2",
+                    children: "✏️"
+                  }, undefined, false, undefined, this),
+                  " Edit Project"
+                ]
+              }, undefined, true, undefined, this),
+              project.status === "ACTIVE" || project.status === "DRAFT" ? /* @__PURE__ */ jsxDEV2(Button2, {
+                className: "w-full justify-start",
+                variant: "ghost",
+                onPress: () => setMode("archive"),
+                children: [
+                  /* @__PURE__ */ jsxDEV2("span", {
+                    className: "mr-2",
+                    children: "\uD83D\uDCE6"
+                  }, undefined, false, undefined, this),
+                  " Archive Project"
+                ]
+              }, undefined, true, undefined, this) : project.status === "ARCHIVED" ? /* @__PURE__ */ jsxDEV2(Button2, {
+                className: "w-full justify-start",
+                variant: "ghost",
+                onPress: handleActivate,
+                disabled: isLoading,
+                children: [
+                  /* @__PURE__ */ jsxDEV2("span", {
+                    className: "mr-2",
+                    children: "\uD83D\uDD04"
+                  }, undefined, false, undefined, this),
+                  " Restore Project"
+                ]
+              }, undefined, true, undefined, this) : null,
+              /* @__PURE__ */ jsxDEV2(Button2, {
+                className: "w-full justify-start text-red-500 hover:text-red-600",
+                variant: "ghost",
+                onPress: () => setMode("delete"),
+                children: [
+                  /* @__PURE__ */ jsxDEV2("span", {
+                    className: "mr-2",
+                    children: "\uD83D\uDDD1️"
+                  }, undefined, false, undefined, this),
+                  " Delete Project"
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV2("div", {
+                className: "border-border border-t pt-3",
+                children: /* @__PURE__ */ jsxDEV2(Button2, {
+                  className: "w-full",
+                  variant: "outline",
+                  onPress: handleClose,
+                  children: "Close"
+                }, undefined, false, undefined, this)
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          mode === "edit" && /* @__PURE__ */ jsxDEV2("div", {
+            className: "space-y-4",
+            children: [
+              /* @__PURE__ */ jsxDEV2("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV2("label", {
+                    htmlFor: "edit-name",
+                    className: "text-muted-foreground mb-1 block text-sm font-medium",
+                    children: "Project Name *"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV2(Input2, {
+                    id: "edit-name",
+                    value: name,
+                    onChange: (e) => setName(e.target.value),
+                    disabled: isLoading
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV2("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV2("label", {
+                    htmlFor: "edit-description",
+                    className: "text-muted-foreground mb-1 block text-sm font-medium",
+                    children: "Description"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV2("textarea", {
+                    id: "edit-description",
+                    value: description,
+                    onChange: (e) => setDescription(e.target.value),
+                    rows: 3,
+                    disabled: isLoading,
+                    className: "border-input bg-background focus:ring-ring w-full rounded-md border px-3 py-2 text-sm focus:ring-2 focus:outline-none disabled:opacity-50"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              error && /* @__PURE__ */ jsxDEV2("div", {
+                className: "bg-destructive/10 text-destructive rounded-md p-3 text-sm",
+                children: error
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("div", {
+                className: "flex justify-end gap-3 pt-2",
+                children: [
+                  /* @__PURE__ */ jsxDEV2(Button2, {
+                    variant: "ghost",
+                    onPress: () => setMode("menu"),
+                    disabled: isLoading,
+                    children: "Back"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV2(Button2, {
+                    onPress: handleEdit,
+                    disabled: isLoading,
+                    children: isLoading ? "Saving..." : "Save Changes"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          mode === "archive" && /* @__PURE__ */ jsxDEV2("div", {
+            className: "space-y-4",
+            children: [
+              /* @__PURE__ */ jsxDEV2("p", {
+                className: "text-muted-foreground",
+                children: [
+                  "Are you sure you want to archive",
+                  " ",
+                  /* @__PURE__ */ jsxDEV2("span", {
+                    className: "text-foreground font-medium",
+                    children: project.name
+                  }, undefined, false, undefined, this),
+                  "?"
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV2("p", {
+                className: "text-muted-foreground text-sm",
+                children: "Archived projects can be restored later."
+              }, undefined, false, undefined, this),
+              error && /* @__PURE__ */ jsxDEV2("div", {
+                className: "bg-destructive/10 text-destructive rounded-md p-3 text-sm",
+                children: error
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("div", {
+                className: "flex justify-end gap-3 pt-2",
+                children: [
+                  /* @__PURE__ */ jsxDEV2(Button2, {
+                    variant: "ghost",
+                    onPress: () => setMode("menu"),
+                    disabled: isLoading,
+                    children: "Cancel"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV2(Button2, {
+                    onPress: handleArchive,
+                    disabled: isLoading,
+                    children: isLoading ? "Archiving..." : "\uD83D\uDCE6 Archive"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          mode === "delete" && /* @__PURE__ */ jsxDEV2("div", {
+            className: "space-y-4",
+            children: [
+              /* @__PURE__ */ jsxDEV2("p", {
+                className: "text-muted-foreground",
+                children: [
+                  "Are you sure you want to delete",
+                  " ",
+                  /* @__PURE__ */ jsxDEV2("span", {
+                    className: "text-foreground font-medium",
+                    children: project.name
+                  }, undefined, false, undefined, this),
+                  "?"
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV2("p", {
+                className: "text-destructive text-sm",
+                children: "This action cannot be undone."
+              }, undefined, false, undefined, this),
+              error && /* @__PURE__ */ jsxDEV2("div", {
+                className: "bg-destructive/10 text-destructive rounded-md p-3 text-sm",
+                children: error
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("div", {
+                className: "flex justify-end gap-3 pt-2",
+                children: [
+                  /* @__PURE__ */ jsxDEV2(Button2, {
+                    variant: "ghost",
+                    onPress: () => setMode("menu"),
+                    disabled: isLoading,
+                    children: "Cancel"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV2(Button2, {
+                    variant: "destructive",
+                    onPress: handleDelete,
+                    disabled: isLoading,
+                    children: isLoading ? "Deleting..." : "\uD83D\uDDD1️ Delete"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/ui/SaasDashboard.tsx
+import { useState as useState5, useCallback as useCallback3 } from "react";
+import {
+  StatCard,
+  StatCardGroup,
+  StatusChip,
+  EntityCard,
+  EmptyState,
+  LoaderBlock,
+  ErrorState,
+  Button as Button3
+} from "@contractspec/lib.design-system";
+import { jsxDEV as jsxDEV3 } from "react/jsx-dev-runtime";
+"use client";
+function getStatusTone(status) {
+  switch (status) {
+    case "ACTIVE":
+      return "success";
+    case "DRAFT":
+      return "neutral";
+    case "ARCHIVED":
+      return "warning";
+    default:
+      return "neutral";
+  }
+}
+function SaasDashboard() {
+  const [activeTab, setActiveTab] = useState5("projects");
+  const [isCreateModalOpen, setIsCreateModalOpen] = useState5(false);
+  const [selectedProject, setSelectedProject] = useState5(null);
+  const [isProjectActionsOpen, setIsProjectActionsOpen] = useState5(false);
+  const { data, subscription, loading, error, stats, refetch } = useProjectList();
+  const mutations = useProjectMutations({
+    onSuccess: () => {
+      refetch();
+    }
+  });
+  const handleProjectClick = useCallback3((project) => {
+    setSelectedProject(project);
+    setIsProjectActionsOpen(true);
+  }, []);
+  const tabs = [
+    { id: "projects", label: "Projects", icon: "\uD83D\uDCC1" },
+    { id: "billing", label: "Billing", icon: "\uD83D\uDCB3" },
+    { id: "settings", label: "Settings", icon: "⚙️" }
+  ];
+  if (loading && !data) {
+    return /* @__PURE__ */ jsxDEV3(LoaderBlock, {
+      label: "Loading dashboard..."
+    }, undefined, false, undefined, this);
+  }
+  if (error) {
+    return /* @__PURE__ */ jsxDEV3(ErrorState, {
+      title: "Failed to load dashboard",
+      description: error.message,
+      onRetry: refetch,
+      retryLabel: "Retry"
+    }, undefined, false, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV3("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV3("div", {
+        className: "flex items-center justify-between",
+        children: [
+          /* @__PURE__ */ jsxDEV3("h2", {
+            className: "text-2xl font-bold",
+            children: "SaaS Dashboard"
+          }, undefined, false, undefined, this),
+          activeTab === "projects" && /* @__PURE__ */ jsxDEV3(Button3, {
+            onPress: () => setIsCreateModalOpen(true),
+            children: [
+              /* @__PURE__ */ jsxDEV3("span", {
+                className: "mr-2",
+                children: "+"
+              }, undefined, false, undefined, this),
+              " New Project"
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      stats && subscription && /* @__PURE__ */ jsxDEV3(StatCardGroup, {
+        children: [
+          /* @__PURE__ */ jsxDEV3(StatCard, {
+            label: "Projects",
+            value: stats.total.toString()
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV3(StatCard, {
+            label: "Active",
+            value: stats.activeCount.toString()
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV3(StatCard, {
+            label: "Draft",
+            value: stats.draftCount.toString()
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV3(StatCard, {
+            label: "Plan",
+            value: subscription.plan,
+            hint: subscription.status
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV3("nav", {
+        className: "bg-muted flex gap-1 rounded-lg p-1",
+        role: "tablist",
+        children: tabs.map((tab) => /* @__PURE__ */ jsxDEV3("button", {
+          type: "button",
+          role: "tab",
+          "aria-selected": activeTab === tab.id,
+          onClick: () => setActiveTab(tab.id),
+          className: `flex flex-1 items-center justify-center gap-2 rounded-md px-4 py-2 text-sm font-medium transition-colors ${activeTab === tab.id ? "bg-background text-foreground shadow-sm" : "text-muted-foreground hover:text-foreground"}`,
+          children: [
+            /* @__PURE__ */ jsxDEV3("span", {
+              children: tab.icon
+            }, undefined, false, undefined, this),
+            tab.label
+          ]
+        }, tab.id, true, undefined, this))
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV3("div", {
+        className: "min-h-[400px]",
+        role: "tabpanel",
+        children: [
+          activeTab === "projects" && /* @__PURE__ */ jsxDEV3(ProjectsTab, {
+            data,
+            onProjectClick: handleProjectClick
+          }, undefined, false, undefined, this),
+          activeTab === "billing" && /* @__PURE__ */ jsxDEV3(BillingTab, {
+            subscription
+          }, undefined, false, undefined, this),
+          activeTab === "settings" && /* @__PURE__ */ jsxDEV3(SettingsTab, {}, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV3(CreateProjectModal, {
+        isOpen: isCreateModalOpen,
+        onClose: () => setIsCreateModalOpen(false),
+        onSubmit: async (input) => {
+          await mutations.createProject(input);
+        },
+        isLoading: mutations.createState.loading
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV3(ProjectActionsModal, {
+        isOpen: isProjectActionsOpen,
+        project: selectedProject,
+        onClose: () => {
+          setIsProjectActionsOpen(false);
+          setSelectedProject(null);
+        },
+        onUpdate: async (input) => {
+          await mutations.updateProject(input);
+        },
+        onArchive: async (projectId) => {
+          await mutations.archiveProject(projectId);
+        },
+        onActivate: async (projectId) => {
+          await mutations.activateProject(projectId);
+        },
+        onDelete: async (projectId) => {
+          await mutations.deleteProject(projectId);
+        },
+        isLoading: mutations.isLoading
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+function ProjectsTab({ data, onProjectClick }) {
+  if (!data?.items.length) {
+    return /* @__PURE__ */ jsxDEV3(EmptyState, {
+      title: "No projects yet",
+      description: "Create your first project to get started."
+    }, undefined, false, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV3("div", {
+    className: "space-y-4",
+    children: /* @__PURE__ */ jsxDEV3("div", {
+      className: "grid gap-4 md:grid-cols-2 lg:grid-cols-3",
+      children: data.items.map((project) => /* @__PURE__ */ jsxDEV3(EntityCard, {
+        cardTitle: project.name,
+        cardSubtitle: project.tier,
+        meta: /* @__PURE__ */ jsxDEV3("p", {
+          className: "text-muted-foreground text-sm",
+          children: project.description
+        }, undefined, false, undefined, this),
+        chips: /* @__PURE__ */ jsxDEV3(StatusChip, {
+          tone: getStatusTone(project.status),
+          label: project.status
+        }, undefined, false, undefined, this),
+        footer: /* @__PURE__ */ jsxDEV3("div", {
+          className: "flex w-full items-center justify-between",
+          children: [
+            /* @__PURE__ */ jsxDEV3("span", {
+              className: "text-muted-foreground text-xs",
+              children: project.updatedAt.toLocaleDateString()
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV3(Button3, {
+              variant: "ghost",
+              size: "sm",
+              onPress: () => onProjectClick?.(project),
+              children: "Actions"
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this)
+      }, project.id, false, undefined, this))
+    }, undefined, false, undefined, this)
+  }, undefined, false, undefined, this);
+}
+function BillingTab({ subscription }) {
+  if (!subscription)
+    return null;
+  return /* @__PURE__ */ jsxDEV3("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV3("div", {
+        className: "border-border bg-card rounded-xl border p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV3("div", {
+            className: "flex items-start justify-between",
+            children: [
+              /* @__PURE__ */ jsxDEV3("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV3("h3", {
+                    className: "text-lg font-semibold",
+                    children: [
+                      subscription.plan,
+                      " Plan"
+                    ]
+                  }, undefined, true, undefined, this),
+                  /* @__PURE__ */ jsxDEV3("p", {
+                    className: "text-muted-foreground text-sm",
+                    children: [
+                      "Current period:",
+                      " ",
+                      subscription.currentPeriodStart.toLocaleDateString(),
+                      " -",
+                      " ",
+                      subscription.currentPeriodEnd.toLocaleDateString()
+                    ]
+                  }, undefined, true, undefined, this),
+                  /* @__PURE__ */ jsxDEV3("p", {
+                    className: "text-muted-foreground text-sm",
+                    children: [
+                      "Billing cycle: ",
+                      subscription.billingCycle
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV3(StatusChip, {
+                tone: "success",
+                label: subscription.status
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV3("div", {
+            className: "mt-4 flex gap-3",
+            children: [
+              /* @__PURE__ */ jsxDEV3(Button3, {
+                variant: "outline",
+                onPress: () => alert("Upgrade clicked!"),
+                children: "Upgrade Plan"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV3(Button3, {
+                variant: "ghost",
+                onPress: () => alert("Manage Billing clicked!"),
+                children: "Manage Billing"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      subscription.cancelAtPeriodEnd && /* @__PURE__ */ jsxDEV3("div", {
+        className: "border-border bg-destructive/10 text-destructive rounded-xl border p-4",
+        children: /* @__PURE__ */ jsxDEV3("p", {
+          className: "text-sm font-medium",
+          children: "⚠️ Your subscription will be cancelled at the end of the current period."
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+function SettingsTab() {
+  return /* @__PURE__ */ jsxDEV3("div", {
+    className: "space-y-6",
+    children: /* @__PURE__ */ jsxDEV3("div", {
+      className: "border-border bg-card rounded-xl border p-6",
+      children: [
+        /* @__PURE__ */ jsxDEV3("h3", {
+          className: "mb-4 text-lg font-semibold",
+          children: "Organization Settings"
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV3("div", {
+          className: "space-y-4",
+          children: [
+            /* @__PURE__ */ jsxDEV3("div", {
+              children: [
+                /* @__PURE__ */ jsxDEV3("label", {
+                  htmlFor: "org-name",
+                  className: "text-sm font-medium",
+                  children: "Organization Name"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV3("input", {
+                  id: "org-name",
+                  type: "text",
+                  defaultValue: "Demo Organization",
+                  className: "border-input bg-background mt-1 block w-full rounded-md border px-3 py-2"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this),
+            /* @__PURE__ */ jsxDEV3("div", {
+              children: [
+                /* @__PURE__ */ jsxDEV3("label", {
+                  htmlFor: "timezone",
+                  className: "text-sm font-medium",
+                  children: "Default Timezone"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV3("select", {
+                  id: "timezone",
+                  className: "border-input bg-background mt-1 block w-full rounded-md border px-3 py-2",
+                  children: [
+                    /* @__PURE__ */ jsxDEV3("option", {
+                      children: "UTC"
+                    }, undefined, false, undefined, this),
+                    /* @__PURE__ */ jsxDEV3("option", {
+                      children: "America/New_York"
+                    }, undefined, false, undefined, this),
+                    /* @__PURE__ */ jsxDEV3("option", {
+                      children: "Europe/London"
+                    }, undefined, false, undefined, this),
+                    /* @__PURE__ */ jsxDEV3("option", {
+                      children: "Asia/Tokyo"
+                    }, undefined, false, undefined, this)
+                  ]
+                }, undefined, true, undefined, this)
+              ]
+            }, undefined, true, undefined, this),
+            /* @__PURE__ */ jsxDEV3("div", {
+              className: "pt-2",
+              children: /* @__PURE__ */ jsxDEV3(Button3, {
+                onPress: () => alert("Settings saved!"),
+                children: "Save Settings"
+              }, undefined, false, undefined, this)
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this)
+      ]
+    }, undefined, true, undefined, this)
+  }, undefined, false, undefined, this);
+}
+
+// src/ui/SaasProjectList.tsx
+import {
+  StatCard as StatCard2,
+  StatCardGroup as StatCardGroup2,
+  StatusChip as StatusChip2,
+  EntityCard as EntityCard2,
+  EmptyState as EmptyState2,
+  LoaderBlock as LoaderBlock2,
+  ErrorState as ErrorState2,
+  Button as Button4
+} from "@contractspec/lib.design-system";
+import { jsxDEV as jsxDEV4 } from "react/jsx-dev-runtime";
+"use client";
+function getStatusTone2(status) {
+  switch (status) {
+    case "ACTIVE":
+      return "success";
+    case "DRAFT":
+      return "neutral";
+    case "ARCHIVED":
+      return "danger";
+    default:
+      return "neutral";
+  }
+}
+function SaasProjectList({
+  onProjectClick,
+  onCreateProject
+}) {
+  const { data, loading, error, stats, refetch } = useProjectList();
+  if (loading && !data) {
+    return /* @__PURE__ */ jsxDEV4(LoaderBlock2, {
+      label: "Loading projects..."
+    }, undefined, false, undefined, this);
+  }
+  if (error) {
+    return /* @__PURE__ */ jsxDEV4(ErrorState2, {
+      title: "Failed to load projects",
+      description: error.message,
+      onRetry: refetch,
+      retryLabel: "Retry"
+    }, undefined, false, undefined, this);
+  }
+  if (!data?.items.length) {
+    return /* @__PURE__ */ jsxDEV4(EmptyState2, {
+      title: "No projects found",
+      description: "Create your first project to get started.",
+      primaryAction: onCreateProject ? /* @__PURE__ */ jsxDEV4(Button4, {
+        onPress: onCreateProject,
+        children: "Create Project"
+      }, undefined, false, undefined, this) : undefined
+    }, undefined, false, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV4("div", {
+    className: "space-y-6",
+    children: [
+      stats && /* @__PURE__ */ jsxDEV4(StatCardGroup2, {
+        children: [
+          /* @__PURE__ */ jsxDEV4(StatCard2, {
+            label: "Total Projects",
+            value: stats.total.toString()
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV4(StatCard2, {
+            label: "Active",
+            value: stats.activeCount.toString()
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV4(StatCard2, {
+            label: "Draft",
+            value: stats.draftCount.toString()
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV4("div", {
+        className: "grid gap-4 md:grid-cols-2 lg:grid-cols-3",
+        children: data.items.map((project) => /* @__PURE__ */ jsxDEV4(EntityCard2, {
+          cardTitle: project.name,
+          cardSubtitle: project.tier,
+          meta: /* @__PURE__ */ jsxDEV4("p", {
+            className: "text-muted-foreground text-sm",
+            children: project.description
+          }, undefined, false, undefined, this),
+          chips: /* @__PURE__ */ jsxDEV4(StatusChip2, {
+            tone: getStatusTone2(project.status),
+            label: project.status
+          }, undefined, false, undefined, this),
+          footer: /* @__PURE__ */ jsxDEV4("span", {
+            className: "text-muted-foreground text-xs",
+            children: project.updatedAt.toLocaleDateString()
+          }, undefined, false, undefined, this),
+          onClick: onProjectClick ? () => onProjectClick(project.id) : undefined
+        }, project.id, false, undefined, this))
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/ui/SaasSettingsPanel.tsx
+import { useState as useState6 } from "react";
+import { Button as Button5 } from "@contractspec/lib.design-system";
+import { jsxDEV as jsxDEV5 } from "react/jsx-dev-runtime";
+"use client";
+function SaasSettingsPanel() {
+  const [orgName, setOrgName] = useState6("Demo Organization");
+  const [timezone, setTimezone] = useState6("UTC");
+  return /* @__PURE__ */ jsxDEV5("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV5("div", {
+        className: "border-border bg-card rounded-xl border p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV5("h3", {
+            className: "mb-4 text-lg font-semibold",
+            children: "Organization Settings"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV5("div", {
+            className: "space-y-4",
+            children: [
+              /* @__PURE__ */ jsxDEV5("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV5("label", {
+                    htmlFor: "setting-org-name",
+                    className: "block text-sm font-medium",
+                    children: "Organization Name"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV5("input", {
+                    id: "setting-org-name",
+                    type: "text",
+                    value: orgName,
+                    onChange: (e) => setOrgName(e.target.value),
+                    className: "border-input bg-background mt-1 block w-full rounded-md border px-3 py-2"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV5("div", {
+                children: [
+                  /* @__PURE__ */ jsxDEV5("label", {
+                    htmlFor: "setting-timezone",
+                    className: "block text-sm font-medium",
+                    children: "Default Timezone"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV5("select", {
+                    id: "setting-timezone",
+                    value: timezone,
+                    onChange: (e) => setTimezone(e.target.value),
+                    className: "border-input bg-background mt-1 block w-full rounded-md border px-3 py-2",
+                    children: [
+                      /* @__PURE__ */ jsxDEV5("option", {
+                        value: "UTC",
+                        children: "UTC"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV5("option", {
+                        value: "America/New_York",
+                        children: "America/New_York"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV5("option", {
+                        value: "Europe/London",
+                        children: "Europe/London"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV5("option", {
+                        value: "Asia/Tokyo",
+                        children: "Asia/Tokyo"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV5("div", {
+            className: "mt-6",
+            children: /* @__PURE__ */ jsxDEV5(Button5, {
+              variant: "default",
+              children: "Save Changes"
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV5("div", {
+        className: "border-border bg-card rounded-xl border p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV5("h3", {
+            className: "mb-4 text-lg font-semibold",
+            children: "Notifications"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV5("div", {
+            className: "space-y-3",
+            children: [
+              { label: "Email notifications", defaultChecked: true },
+              { label: "Usage alerts", defaultChecked: true },
+              { label: "Weekly digest", defaultChecked: false }
+            ].map((item) => /* @__PURE__ */ jsxDEV5("label", {
+              className: "flex items-center gap-3",
+              children: [
+                /* @__PURE__ */ jsxDEV5("input", {
+                  type: "checkbox",
+                  defaultChecked: item.defaultChecked,
+                  className: "border-input h-4 w-4 rounded"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV5("span", {
+                  className: "text-sm",
+                  children: item.label
+                }, undefined, false, undefined, this)
+              ]
+            }, item.label, true, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV5("div", {
+        className: "rounded-xl border border-red-200 bg-red-50 p-6 dark:border-red-900 dark:bg-red-950/20",
+        children: [
+          /* @__PURE__ */ jsxDEV5("h3", {
+            className: "mb-2 text-lg font-semibold text-red-700 dark:text-red-400",
+            children: "Danger Zone"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV5("p", {
+            className: "mb-4 text-sm text-red-600 dark:text-red-300",
+            children: "These actions are irreversible. Please proceed with caution."
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV5("div", {
+            className: "flex gap-3",
+            children: [
+              /* @__PURE__ */ jsxDEV5(Button5, {
+                variant: "secondary",
+                size: "sm",
+                children: "Export Data"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV5(Button5, {
+                variant: "secondary",
+                size: "sm",
+                children: "Delete Organization"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+// src/ui/hooks/index.ts
+"use client";
+
+// src/ui/renderers/project-list.renderer.tsx
+import { jsxDEV as jsxDEV6 } from "react/jsx-dev-runtime";
+var 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__ */ jsxDEV6(SaasProjectList, {}, undefined, false, undefined, this);
+  }
+};
+
+// src/ui/renderers/project-list.markdown.ts
+var 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" ? "\uD83D\uDCE6" : "⏸️";
+        lines.push(`| ${status} | **${project.name}** | ${project.description ?? "-"} |`);
+      }
+    }
+    return {
+      mimeType: "text/markdown",
+      body: lines.join(`
+`)
+    };
+  }
+};
+var 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" ? "\uD83D\uDCE6" : "⏸️";
+        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(`
+`)
+    };
+  }
+};
+var 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(`
+`)
+    };
+  }
+};
+// src/ui/overlays/demo-overlays.ts
+var 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"
+    }
+  ]
+};
+var 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"
+    }
+  ]
+};
+var saasOverlays = [
+  saasFreeUserOverlay,
+  saasDemoOverlay
+];
+// src/index.ts
+import { identityRbacSchemaContribution } from "@contractspec/lib.identity-rbac";
+import { jobsSchemaContribution } from "@contractspec/lib.jobs";
+import { auditTrailSchemaContribution } from "@contractspec/module.audit-trail";
+import { notificationsSchemaContribution } from "@contractspec/module.notifications";
+var saasBoilerplateSchemaContribution = {
+  moduleId: "@contractspec/example.saas-boilerplate",
+  entities: [
+    ProjectEntity,
+    ProjectMemberEntity,
+    SettingsEntity,
+    FeatureFlagEntity,
+    SubscriptionEntity,
+    BillingUsageEntity,
+    UsageLimitEntity
+  ],
+  enums: [ProjectStatusEnum, SettingsScopeEnum, SubscriptionStatusEnum]
+};
+var schemaComposition = {
+  modules: [
+    identityRbacSchemaContribution,
+    jobsSchemaContribution,
+    auditTrailSchemaContribution,
+    notificationsSchemaContribution,
+    saasBoilerplateSchemaContribution
+  ],
+  provider: "postgresql",
+  outputPath: "./prisma/schema/generated.prisma"
+};
+export {
+  useProjectMutations,
+  useProjectList,
+  schemaComposition,
+  saasOverlays,
+  saasFreeUserOverlay,
+  saasDemoOverlay,
+  saasDashboardMarkdownRenderer,
+  saasBoilerplateSchemaContribution,
+  saasBillingMarkdownRenderer,
+  projectListReactRenderer,
+  projectListMarkdownRenderer,
+  mockUpdateProjectHandler,
+  mockRecordUsageHandler,
+  mockListProjectsHandler,
+  mockGetUsageSummaryHandler,
+  mockGetSubscriptionHandler,
+  mockGetProjectHandler,
+  mockDeleteProjectHandler,
+  mockCreateProjectHandler,
+  mockCheckFeatureAccessHandler,
+  example_default as example,
+  createSaasHandlers,
+  UsageSummaryModel,
+  UsageRecordedPayloadModel,
+  UsageRecordedEvent,
+  UsageLimitReachedEvent,
+  UsageLimitEntity,
+  UsageDashboardPresentation,
+  UpdateProjectInputModel,
+  UpdateProjectContract,
+  SubscriptionStatusSchemaEnum,
+  SubscriptionStatusEnum,
+  SubscriptionPresentation,
+  SubscriptionModel,
+  SubscriptionEntity,
+  SubscriptionChangedEvent,
+  SettingsScopeEnum,
+  SettingsPanelPresentation,
+  SettingsEntity,
+  SaasSettingsPanel,
+  SaasProjectList,
+  SaasDashboardPresentation,
+  SaasDashboard,
+  SaasBoilerplateFeature,
+  RecordUsageOutputModel,
+  RecordUsageInputModel,
+  RecordUsageContract,
+  ProjectUpdatedEvent,
+  ProjectStatusSchemaEnum,
+  ProjectStatusFilterEnum,
+  ProjectStatusEnum,
+  ProjectModel,
+  ProjectMemberEntity,
+  ProjectListPresentation,
+  ProjectEntity,
+  ProjectDetailPresentation,
+  ProjectDeletedPayloadModel,
+  ProjectDeletedEvent,
+  ProjectCreatedEvent,
+  ProjectArchivedEvent,
+  ProjectActionsModal,
+  ListProjectsOutputModel,
+  ListProjectsInputModel,
+  ListProjectsContract,
+  GetUsageSummaryOutputModel,
+  GetUsageSummaryInputModel,
+  GetUsageSummaryContract,
+  GetSubscriptionContract,
+  GetProjectInputModel,
+  GetProjectContract,
+  FeatureFlagEntity,
+  FeatureAccessReasonEnum,
+  DeleteProjectOutputModel,
+  DeleteProjectInputModel,
+  DeleteProjectContract,
+  CreateProjectModal,
+  CreateProjectInputModel,
+  CreateProjectContract,
+  CheckFeatureAccessOutputModel,
+  CheckFeatureAccessInputModel,
+  CheckFeatureAccessContract,
+  BillingUsageEntity
+};