@contractspec/example.saas-boilerplate 3.7.7 → 3.8.4

package/dist/node/index.js

@@ -1632,6 +1632,213 @@ var ProjectDetailPresentation = definePresentation3({
     flags: ["saas.projects.enabled"]
   }
 });
+// src/visualizations/catalog.ts
+import {
+  defineVisualization,
+  VisualizationRegistry
+} from "@contractspec/lib.contracts-spec/visualizations";
+var PROJECT_LIST_REF = {
+  key: "saas.project.list",
+  version: "1.0.0"
+};
+var META = {
+  version: "1.0.0",
+  domain: "saas",
+  stability: "experimental",
+  owners: ["@example.saas-boilerplate"],
+  tags: ["saas", "visualization", "projects"]
+};
+var SaasProjectUsageVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "saas-boilerplate.visualization.project-usage",
+    title: "Project Capacity",
+    description: "Current project count against the current plan limit.",
+    goal: "Show usage against the active plan allowance.",
+    context: "SaaS account overview."
+  },
+  source: { primary: PROJECT_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "metric",
+    measure: "totalProjects",
+    comparisonMeasure: "projectLimit",
+    measures: [
+      {
+        key: "totalProjects",
+        label: "Projects",
+        dataPath: "totalProjects",
+        format: "number"
+      },
+      {
+        key: "projectLimit",
+        label: "Plan Limit",
+        dataPath: "projectLimit",
+        format: "number"
+      }
+    ],
+    table: { caption: "Current project count and plan limit." }
+  }
+});
+var SaasProjectStatusVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "saas-boilerplate.visualization.project-status",
+    title: "Project Status",
+    description: "Distribution of project states.",
+    goal: "Show the mix of active, draft, and archived projects.",
+    context: "Project portfolio overview."
+  },
+  source: { primary: PROJECT_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "pie",
+    nameDimension: "status",
+    valueMeasure: "projects",
+    dimensions: [
+      { key: "status", label: "Status", dataPath: "status", type: "category" }
+    ],
+    measures: [
+      {
+        key: "projects",
+        label: "Projects",
+        dataPath: "projects",
+        format: "number"
+      }
+    ],
+    table: { caption: "Project counts by status." }
+  }
+});
+var SaasProjectTierVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "saas-boilerplate.visualization.project-tiers",
+    title: "Tier Comparison",
+    description: "Distribution of projects across tiers.",
+    goal: "Compare how the current portfolio is distributed by tier.",
+    context: "Plan and packaging overview."
+  },
+  source: { primary: PROJECT_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "bar",
+    xDimension: "tier",
+    yMeasures: ["projects"],
+    dimensions: [
+      { key: "tier", label: "Tier", dataPath: "tier", type: "category" }
+    ],
+    measures: [
+      {
+        key: "projects",
+        label: "Projects",
+        dataPath: "projects",
+        format: "number",
+        color: "#1d4ed8"
+      }
+    ],
+    table: { caption: "Project counts by tier." }
+  }
+});
+var SaasProjectActivityVisualization = defineVisualization({
+  meta: {
+    ...META,
+    key: "saas-boilerplate.visualization.project-activity",
+    title: "Recent Project Activity",
+    description: "Daily project creation activity.",
+    goal: "Show recent project activity over time.",
+    context: "Project portfolio trend view."
+  },
+  source: { primary: PROJECT_LIST_REF, resultPath: "data" },
+  visualization: {
+    kind: "cartesian",
+    variant: "line",
+    xDimension: "day",
+    yMeasures: ["projects"],
+    dimensions: [{ key: "day", label: "Day", dataPath: "day", type: "time" }],
+    measures: [
+      {
+        key: "projects",
+        label: "Projects",
+        dataPath: "projects",
+        format: "number",
+        color: "#0f766e"
+      }
+    ],
+    table: { caption: "Daily project creation counts." }
+  }
+});
+var SaasVisualizationSpecs = [
+  SaasProjectUsageVisualization,
+  SaasProjectStatusVisualization,
+  SaasProjectTierVisualization,
+  SaasProjectActivityVisualization
+];
+var SaasVisualizationRegistry = new VisualizationRegistry([
+  ...SaasVisualizationSpecs
+]);
+var SaasVisualizationRefs = SaasVisualizationSpecs.map((spec) => ({
+  key: spec.meta.key,
+  version: spec.meta.version
+}));
+
+// src/visualizations/selectors.ts
+function toDayKey(value) {
+  const date = value instanceof Date ? value : new Date(value);
+  return date.toISOString().slice(0, 10);
+}
+function createSaasVisualizationItems(projects, projectLimit = 10) {
+  const statusCounts = new Map;
+  const tierCounts = new Map;
+  const activityCounts = new Map;
+  for (const project of projects) {
+    statusCounts.set(project.status, (statusCounts.get(project.status) ?? 0) + 1);
+    tierCounts.set(project.tier, (tierCounts.get(project.tier) ?? 0) + 1);
+    const day = toDayKey(project.createdAt);
+    activityCounts.set(day, (activityCounts.get(day) ?? 0) + 1);
+  }
+  return [
+    {
+      key: "saas-capacity",
+      spec: SaasProjectUsageVisualization,
+      data: { data: [{ totalProjects: projects.length, projectLimit }] },
+      title: "Project Capacity",
+      description: "Current project count compared to the active limit.",
+      height: 220
+    },
+    {
+      key: "saas-status",
+      spec: SaasProjectStatusVisualization,
+      data: {
+        data: Array.from(statusCounts.entries()).map(([status, count]) => ({
+          status,
+          projects: count
+        }))
+      },
+      title: "Project Status",
+      description: "Status mix across the current project portfolio.",
+      height: 260
+    },
+    {
+      key: "saas-tier",
+      spec: SaasProjectTierVisualization,
+      data: {
+        data: Array.from(tierCounts.entries()).map(([tier, count]) => ({
+          tier,
+          projects: count
+        }))
+      },
+      title: "Tier Comparison",
+      description: "How projects are distributed across tiers."
+    },
+    {
+      key: "saas-activity",
+      spec: SaasProjectActivityVisualization,
+      data: {
+        data: Array.from(activityCounts.entries()).sort(([left], [right]) => left.localeCompare(right)).map(([day, count]) => ({ day, projects: count }))
+      },
+      title: "Recent Project Activity",
+      description: "Daily project creation activity."
+    }
+  ];
+}
 // src/saas-boilerplate.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts-spec";
 var SaasBoilerplateFeature = defineFeature({
@@ -1709,6 +1916,7 @@ var SaasBoilerplateFeature = defineFeature({
       targets: ["react", "markdown"]
     }
   ],
+  visualizations: SaasVisualizationRefs,
   capabilities: {
     requires: [
       { key: "identity", version: "1.0.0" },
@@ -2492,6 +2700,18 @@ var saasOverlays = [
   saasDemoOverlay
 ];
 // src/ui/renderers/project-list.markdown.ts
+var PROJECT_TIERS = [
+  "FREE",
+  "PRO",
+  "ENTERPRISE"
+];
+function toVisualizationProject(project, index4) {
+  return {
+    status: project.status === "DELETED" ? "ARCHIVED" : project.status,
+    tier: PROJECT_TIERS[index4 % PROJECT_TIERS.length] ?? "FREE",
+    createdAt: project.createdAt
+  };
+}
 var projectListMarkdownRenderer = {
   target: "markdown",
   render: async (desc, _ctx) => {
@@ -2502,7 +2722,7 @@ var projectListMarkdownRenderer = {
       limit: 20,
       offset: 0
     });
-    const items = data.projects ?? data.items ?? [];
+    const items = data.projects ?? [];
     const lines = [
       "# Projects",
       "",
@@ -2539,6 +2759,7 @@ var saasDashboardMarkdownRenderer = {
     const projects = projectsData.projects ?? [];
     const activeProjects = projects.filter((p) => p.status === "ACTIVE").length;
     const archivedProjects = projects.filter((p) => p.status === "ARCHIVED").length;
+    const visualizations = createSaasVisualizationItems(projects.map(toVisualizationProject), 10);
     const lines = [
       "# SaaS Dashboard",
       "",
@@ -2553,10 +2774,16 @@ var saasDashboardMarkdownRenderer = {
       `| Archived Projects | ${archivedProjects} |`,
       `| Subscription Plan | ${subscription.planName} |`,
       `| Subscription Status | ${subscription.status} |`,
-      "",
-      "## Projects",
       ""
     ];
+    lines.push("## Visualization Overview");
+    lines.push("");
+    for (const item of visualizations) {
+      lines.push(`- **${item.title}** via \`${item.spec.meta.key}\``);
+    }
+    lines.push("");
+    lines.push("## Projects");
+    lines.push("");
     if (projects.length === 0) {
       lines.push("_No projects yet._");
     } else {
@@ -2750,6 +2977,46 @@ var projectListReactRenderer = {
     return /* @__PURE__ */ jsxDEV4(SaasProjectList, {}, undefined, false, undefined, this);
   }
 };
+// src/ui/SaasDashboard.visualizations.tsx
+import {
+  VisualizationCard,
+  VisualizationGrid
+} from "@contractspec/lib.design-system";
+import { jsxDEV as jsxDEV5 } from "react/jsx-dev-runtime";
+"use client";
+function SaasVisualizationOverview({
+  projects,
+  projectLimit
+}) {
+  const items = createSaasVisualizationItems(projects, projectLimit);
+  return /* @__PURE__ */ jsxDEV5("section", {
+    className: "space-y-3",
+    children: [
+      /* @__PURE__ */ jsxDEV5("div", {
+        children: [
+          /* @__PURE__ */ jsxDEV5("h3", {
+            className: "font-semibold text-lg",
+            children: "Portfolio Visualizations"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV5("p", {
+            className: "text-muted-foreground text-sm",
+            children: "Contract-backed charts for project mix, capacity, and activity."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV5(VisualizationGrid, {
+        children: items.map((item) => /* @__PURE__ */ jsxDEV5(VisualizationCard, {
+          data: item.data,
+          description: item.description,
+          height: item.height,
+          spec: item.spec,
+          title: item.title
+        }, item.key, false, undefined, this))
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
 // src/ui/SaasDashboard.tsx
 import {
   Button as Button4,
@@ -2762,7 +3029,7 @@ import {
   StatusChip as StatusChip2
 } from "@contractspec/lib.design-system";
 import { useCallback as useCallback3, useState as useState5 } from "react";
-import { jsxDEV as jsxDEV5 } from "react/jsx-dev-runtime";
+import { jsxDEV as jsxDEV6 } from "react/jsx-dev-runtime";
 "use client";
 function getStatusTone2(status) {
   switch (status) {
@@ -2797,32 +3064,32 @@ function SaasDashboard() {
     { id: "settings", label: "Settings", icon: "⚙️" }
   ];
   if (loading && !data) {
-    return /* @__PURE__ */ jsxDEV5(LoaderBlock2, {
+    return /* @__PURE__ */ jsxDEV6(LoaderBlock2, {
       label: "Loading dashboard..."
     }, undefined, false, undefined, this);
   }
   if (error) {
-    return /* @__PURE__ */ jsxDEV5(ErrorState2, {
+    return /* @__PURE__ */ jsxDEV6(ErrorState2, {
       title: "Failed to load dashboard",
       description: error.message,
       onRetry: refetch,
       retryLabel: "Retry"
     }, undefined, false, undefined, this);
   }
-  return /* @__PURE__ */ jsxDEV5("div", {
+  return /* @__PURE__ */ jsxDEV6("div", {
     className: "space-y-6",
     children: [
-      /* @__PURE__ */ jsxDEV5("div", {
+      /* @__PURE__ */ jsxDEV6("div", {
         className: "flex items-center justify-between",
         children: [
-          /* @__PURE__ */ jsxDEV5("h2", {
+          /* @__PURE__ */ jsxDEV6("h2", {
             className: "font-bold text-2xl",
             children: "SaaS Dashboard"
           }, undefined, false, undefined, this),
-          activeTab === "projects" && /* @__PURE__ */ jsxDEV5(Button4, {
+          activeTab === "projects" && /* @__PURE__ */ jsxDEV6(Button4, {
             onPress: () => setIsCreateModalOpen(true),
             children: [
-              /* @__PURE__ */ jsxDEV5("span", {
+              /* @__PURE__ */ jsxDEV6("span", {
                 className: "mr-2",
                 children: "+"
               }, undefined, false, undefined, this),
@@ -2831,59 +3098,63 @@ function SaasDashboard() {
           }, undefined, true, undefined, this)
         ]
       }, undefined, true, undefined, this),
-      stats && subscription && /* @__PURE__ */ jsxDEV5(StatCardGroup2, {
+      stats && subscription && /* @__PURE__ */ jsxDEV6(StatCardGroup2, {
         children: [
-          /* @__PURE__ */ jsxDEV5(StatCard2, {
+          /* @__PURE__ */ jsxDEV6(StatCard2, {
             label: "Projects",
             value: stats.total.toString()
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV5(StatCard2, {
+          /* @__PURE__ */ jsxDEV6(StatCard2, {
             label: "Active",
             value: stats.activeCount.toString()
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV5(StatCard2, {
+          /* @__PURE__ */ jsxDEV6(StatCard2, {
             label: "Draft",
             value: stats.draftCount.toString()
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV5(StatCard2, {
+          /* @__PURE__ */ jsxDEV6(StatCard2, {
             label: "Plan",
             value: subscription.plan,
             hint: subscription.status
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV5("nav", {
+      data && stats && /* @__PURE__ */ jsxDEV6(SaasVisualizationOverview, {
+        projectLimit: stats.projectLimit,
+        projects: data.items
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV6("nav", {
         className: "flex gap-1 rounded-lg bg-muted p-1",
         role: "tablist",
-        children: tabs.map((tab) => /* @__PURE__ */ jsxDEV5("button", {
+        children: tabs.map((tab) => /* @__PURE__ */ jsxDEV6("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 font-medium text-sm transition-colors ${activeTab === tab.id ? "bg-background text-foreground shadow-sm" : "text-muted-foreground hover:text-foreground"}`,
           children: [
-            /* @__PURE__ */ jsxDEV5("span", {
+            /* @__PURE__ */ jsxDEV6("span", {
               children: tab.icon
             }, undefined, false, undefined, this),
             tab.label
           ]
         }, tab.id, true, undefined, this))
       }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV5("div", {
+      /* @__PURE__ */ jsxDEV6("div", {
         className: "min-h-[400px]",
         role: "tabpanel",
         children: [
-          activeTab === "projects" && /* @__PURE__ */ jsxDEV5(ProjectsTab, {
+          activeTab === "projects" && /* @__PURE__ */ jsxDEV6(ProjectsTab, {
             data,
             onProjectClick: handleProjectClick
           }, undefined, false, undefined, this),
-          activeTab === "billing" && /* @__PURE__ */ jsxDEV5(BillingTab, {
+          activeTab === "billing" && /* @__PURE__ */ jsxDEV6(BillingTab, {
             subscription
           }, undefined, false, undefined, this),
-          activeTab === "settings" && /* @__PURE__ */ jsxDEV5(SettingsTab, {}, undefined, false, undefined, this)
+          activeTab === "settings" && /* @__PURE__ */ jsxDEV6(SettingsTab, {}, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV5(CreateProjectModal, {
+      /* @__PURE__ */ jsxDEV6(CreateProjectModal, {
         isOpen: isCreateModalOpen,
         onClose: () => setIsCreateModalOpen(false),
         onSubmit: async (input) => {
@@ -2891,7 +3162,7 @@ function SaasDashboard() {
         },
         isLoading: mutations.createState.loading
       }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV5(ProjectActionsModal, {
+      /* @__PURE__ */ jsxDEV6(ProjectActionsModal, {
         isOpen: isProjectActionsOpen,
         project: selectedProject,
         onClose: () => {
@@ -2917,34 +3188,34 @@ function SaasDashboard() {
 }
 function ProjectsTab({ data, onProjectClick }) {
   if (!data?.items.length) {
-    return /* @__PURE__ */ jsxDEV5(EmptyState2, {
+    return /* @__PURE__ */ jsxDEV6(EmptyState2, {
       title: "No projects yet",
       description: "Create your first project to get started."
     }, undefined, false, undefined, this);
   }
-  return /* @__PURE__ */ jsxDEV5("div", {
+  return /* @__PURE__ */ jsxDEV6("div", {
     className: "space-y-4",
-    children: /* @__PURE__ */ jsxDEV5("div", {
+    children: /* @__PURE__ */ jsxDEV6("div", {
       className: "grid gap-4 md:grid-cols-2 lg:grid-cols-3",
-      children: data.items.map((project) => /* @__PURE__ */ jsxDEV5(EntityCard2, {
+      children: data.items.map((project) => /* @__PURE__ */ jsxDEV6(EntityCard2, {
         cardTitle: project.name,
         cardSubtitle: project.tier,
-        meta: /* @__PURE__ */ jsxDEV5("p", {
+        meta: /* @__PURE__ */ jsxDEV6("p", {
           className: "text-muted-foreground text-sm",
           children: project.description
         }, undefined, false, undefined, this),
-        chips: /* @__PURE__ */ jsxDEV5(StatusChip2, {
+        chips: /* @__PURE__ */ jsxDEV6(StatusChip2, {
           tone: getStatusTone2(project.status),
           label: project.status
         }, undefined, false, undefined, this),
-        footer: /* @__PURE__ */ jsxDEV5("div", {
+        footer: /* @__PURE__ */ jsxDEV6("div", {
           className: "flex w-full items-center justify-between",
           children: [
-            /* @__PURE__ */ jsxDEV5("span", {
+            /* @__PURE__ */ jsxDEV6("span", {
               className: "text-muted-foreground text-xs",
               children: project.updatedAt.toLocaleDateString()
             }, undefined, false, undefined, this),
-            /* @__PURE__ */ jsxDEV5(Button4, {
+            /* @__PURE__ */ jsxDEV6(Button4, {
               variant: "ghost",
               size: "sm",
               onPress: () => onProjectClick?.(project),
@@ -2959,25 +3230,25 @@ function ProjectsTab({ data, onProjectClick }) {
 function BillingTab({ subscription }) {
   if (!subscription)
     return null;
-  return /* @__PURE__ */ jsxDEV5("div", {
+  return /* @__PURE__ */ jsxDEV6("div", {
     className: "space-y-6",
     children: [
-      /* @__PURE__ */ jsxDEV5("div", {
+      /* @__PURE__ */ jsxDEV6("div", {
         className: "rounded-xl border border-border bg-card p-6",
         children: [
-          /* @__PURE__ */ jsxDEV5("div", {
+          /* @__PURE__ */ jsxDEV6("div", {
             className: "flex items-start justify-between",
             children: [
-              /* @__PURE__ */ jsxDEV5("div", {
+              /* @__PURE__ */ jsxDEV6("div", {
                 children: [
-                  /* @__PURE__ */ jsxDEV5("h3", {
+                  /* @__PURE__ */ jsxDEV6("h3", {
                     className: "font-semibold text-lg",
                     children: [
                       subscription.plan,
                       " Plan"
                     ]
                   }, undefined, true, undefined, this),
-                  /* @__PURE__ */ jsxDEV5("p", {
+                  /* @__PURE__ */ jsxDEV6("p", {
                     className: "text-muted-foreground text-sm",
                     children: [
                       "Current period:",
@@ -2988,7 +3259,7 @@ function BillingTab({ subscription }) {
                       subscription.currentPeriodEnd.toLocaleDateString()
                     ]
                   }, undefined, true, undefined, this),
-                  /* @__PURE__ */ jsxDEV5("p", {
+                  /* @__PURE__ */ jsxDEV6("p", {
                     className: "text-muted-foreground text-sm",
                     children: [
                       "Billing cycle: ",
@@ -2997,21 +3268,21 @@ function BillingTab({ subscription }) {
                   }, undefined, true, undefined, this)
                 ]
               }, undefined, true, undefined, this),
-              /* @__PURE__ */ jsxDEV5(StatusChip2, {
+              /* @__PURE__ */ jsxDEV6(StatusChip2, {
                 tone: "success",
                 label: subscription.status
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this),
-          /* @__PURE__ */ jsxDEV5("div", {
+          /* @__PURE__ */ jsxDEV6("div", {
             className: "mt-4 flex gap-3",
             children: [
-              /* @__PURE__ */ jsxDEV5(Button4, {
+              /* @__PURE__ */ jsxDEV6(Button4, {
                 variant: "outline",
                 onPress: () => alert("Upgrade clicked!"),
                 children: "Upgrade Plan"
               }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV5(Button4, {
+              /* @__PURE__ */ jsxDEV6(Button4, {
                 variant: "ghost",
                 onPress: () => alert("Manage Billing clicked!"),
                 children: "Manage Billing"
@@ -3020,9 +3291,9 @@ function BillingTab({ subscription }) {
           }, undefined, true, undefined, this)
         ]
       }, undefined, true, undefined, this),
-      subscription.cancelAtPeriodEnd && /* @__PURE__ */ jsxDEV5("div", {
+      subscription.cancelAtPeriodEnd && /* @__PURE__ */ jsxDEV6("div", {
         className: "rounded-xl border border-border bg-destructive/10 p-4 text-destructive",
-        children: /* @__PURE__ */ jsxDEV5("p", {
+        children: /* @__PURE__ */ jsxDEV6("p", {
           className: "font-medium text-sm",
           children: "⚠️ Your subscription will be cancelled at the end of the current period."
         }, undefined, false, undefined, this)
@@ -3031,26 +3302,26 @@ function BillingTab({ subscription }) {
   }, undefined, true, undefined, this);
 }
 function SettingsTab() {
-  return /* @__PURE__ */ jsxDEV5("div", {
+  return /* @__PURE__ */ jsxDEV6("div", {
     className: "space-y-6",
-    children: /* @__PURE__ */ jsxDEV5("div", {
+    children: /* @__PURE__ */ jsxDEV6("div", {
       className: "rounded-xl border border-border bg-card p-6",
       children: [
-        /* @__PURE__ */ jsxDEV5("h3", {
+        /* @__PURE__ */ jsxDEV6("h3", {
           className: "mb-4 font-semibold text-lg",
           children: "Organization Settings"
         }, undefined, false, undefined, this),
-        /* @__PURE__ */ jsxDEV5("div", {
+        /* @__PURE__ */ jsxDEV6("div", {
           className: "space-y-4",
           children: [
-            /* @__PURE__ */ jsxDEV5("div", {
+            /* @__PURE__ */ jsxDEV6("div", {
               children: [
-                /* @__PURE__ */ jsxDEV5("label", {
+                /* @__PURE__ */ jsxDEV6("label", {
                   htmlFor: "org-name",
                   className: "font-medium text-sm",
                   children: "Organization Name"
                 }, undefined, false, undefined, this),
-                /* @__PURE__ */ jsxDEV5("input", {
+                /* @__PURE__ */ jsxDEV6("input", {
                   id: "org-name",
                   type: "text",
                   defaultValue: "Demo Organization",
@@ -3058,36 +3329,36 @@ function SettingsTab() {
                 }, undefined, false, undefined, this)
               ]
             }, undefined, true, undefined, this),
-            /* @__PURE__ */ jsxDEV5("div", {
+            /* @__PURE__ */ jsxDEV6("div", {
               children: [
-                /* @__PURE__ */ jsxDEV5("label", {
+                /* @__PURE__ */ jsxDEV6("label", {
                   htmlFor: "timezone",
                   className: "font-medium text-sm",
                   children: "Default Timezone"
                 }, undefined, false, undefined, this),
-                /* @__PURE__ */ jsxDEV5("select", {
+                /* @__PURE__ */ jsxDEV6("select", {
                   id: "timezone",
                   className: "mt-1 block w-full rounded-md border border-input bg-background px-3 py-2",
                   children: [
-                    /* @__PURE__ */ jsxDEV5("option", {
+                    /* @__PURE__ */ jsxDEV6("option", {
                       children: "UTC"
                     }, undefined, false, undefined, this),
-                    /* @__PURE__ */ jsxDEV5("option", {
+                    /* @__PURE__ */ jsxDEV6("option", {
                       children: "America/New_York"
                     }, undefined, false, undefined, this),
-                    /* @__PURE__ */ jsxDEV5("option", {
+                    /* @__PURE__ */ jsxDEV6("option", {
                       children: "Europe/London"
                     }, undefined, false, undefined, this),
-                    /* @__PURE__ */ jsxDEV5("option", {
+                    /* @__PURE__ */ jsxDEV6("option", {
                       children: "Asia/Tokyo"
                     }, undefined, false, undefined, this)
                   ]
                 }, undefined, true, undefined, this)
               ]
             }, undefined, true, undefined, this),
-            /* @__PURE__ */ jsxDEV5("div", {
+            /* @__PURE__ */ jsxDEV6("div", {
               className: "pt-2",
-              children: /* @__PURE__ */ jsxDEV5(Button4, {
+              children: /* @__PURE__ */ jsxDEV6(Button4, {
                 onPress: () => alert("Settings saved!"),
                 children: "Save Settings"
               }, undefined, false, undefined, this)
@@ -3102,32 +3373,32 @@ function SettingsTab() {
 // src/ui/SaasSettingsPanel.tsx
 import { Button as Button5 } from "@contractspec/lib.design-system";
 import { useState as useState6 } from "react";
-import { jsxDEV as jsxDEV6 } from "react/jsx-dev-runtime";
+import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
 "use client";
 function SaasSettingsPanel() {
   const [orgName, setOrgName] = useState6("Demo Organization");
   const [timezone, setTimezone] = useState6("UTC");
-  return /* @__PURE__ */ jsxDEV6("div", {
+  return /* @__PURE__ */ jsxDEV7("div", {
     className: "space-y-6",
     children: [
-      /* @__PURE__ */ jsxDEV6("div", {
+      /* @__PURE__ */ jsxDEV7("div", {
         className: "rounded-xl border border-border bg-card p-6",
         children: [
-          /* @__PURE__ */ jsxDEV6("h3", {
+          /* @__PURE__ */ jsxDEV7("h3", {
             className: "mb-4 font-semibold text-lg",
             children: "Organization Settings"
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV6("div", {
+          /* @__PURE__ */ jsxDEV7("div", {
             className: "space-y-4",
             children: [
-              /* @__PURE__ */ jsxDEV6("div", {
+              /* @__PURE__ */ jsxDEV7("div", {
                 children: [
-                  /* @__PURE__ */ jsxDEV6("label", {
+                  /* @__PURE__ */ jsxDEV7("label", {
                     htmlFor: "setting-org-name",
                     className: "block font-medium text-sm",
                     children: "Organization Name"
                   }, undefined, false, undefined, this),
-                  /* @__PURE__ */ jsxDEV6("input", {
+                  /* @__PURE__ */ jsxDEV7("input", {
                     id: "setting-org-name",
                     type: "text",
                     value: orgName,
@@ -3136,32 +3407,32 @@ function SaasSettingsPanel() {
                   }, undefined, false, undefined, this)
                 ]
               }, undefined, true, undefined, this),
-              /* @__PURE__ */ jsxDEV6("div", {
+              /* @__PURE__ */ jsxDEV7("div", {
                 children: [
-                  /* @__PURE__ */ jsxDEV6("label", {
+                  /* @__PURE__ */ jsxDEV7("label", {
                     htmlFor: "setting-timezone",
                     className: "block font-medium text-sm",
                     children: "Default Timezone"
                   }, undefined, false, undefined, this),
-                  /* @__PURE__ */ jsxDEV6("select", {
+                  /* @__PURE__ */ jsxDEV7("select", {
                     id: "setting-timezone",
                     value: timezone,
                     onChange: (e) => setTimezone(e.target.value),
                     className: "mt-1 block w-full rounded-md border border-input bg-background px-3 py-2",
                     children: [
-                      /* @__PURE__ */ jsxDEV6("option", {
+                      /* @__PURE__ */ jsxDEV7("option", {
                         value: "UTC",
                         children: "UTC"
                       }, undefined, false, undefined, this),
-                      /* @__PURE__ */ jsxDEV6("option", {
+                      /* @__PURE__ */ jsxDEV7("option", {
                         value: "America/New_York",
                         children: "America/New_York"
                       }, undefined, false, undefined, this),
-                      /* @__PURE__ */ jsxDEV6("option", {
+                      /* @__PURE__ */ jsxDEV7("option", {
                         value: "Europe/London",
                         children: "Europe/London"
                       }, undefined, false, undefined, this),
-                      /* @__PURE__ */ jsxDEV6("option", {
+                      /* @__PURE__ */ jsxDEV7("option", {
                         value: "Asia/Tokyo",
                         children: "Asia/Tokyo"
                       }, undefined, false, undefined, this)
@@ -3171,37 +3442,37 @@ function SaasSettingsPanel() {
               }, undefined, true, undefined, this)
             ]
           }, undefined, true, undefined, this),
-          /* @__PURE__ */ jsxDEV6("div", {
+          /* @__PURE__ */ jsxDEV7("div", {
             className: "mt-6",
-            children: /* @__PURE__ */ jsxDEV6(Button5, {
+            children: /* @__PURE__ */ jsxDEV7(Button5, {
               variant: "default",
               children: "Save Changes"
             }, undefined, false, undefined, this)
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV6("div", {
+      /* @__PURE__ */ jsxDEV7("div", {
         className: "rounded-xl border border-border bg-card p-6",
         children: [
-          /* @__PURE__ */ jsxDEV6("h3", {
+          /* @__PURE__ */ jsxDEV7("h3", {
             className: "mb-4 font-semibold text-lg",
             children: "Notifications"
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV6("div", {
+          /* @__PURE__ */ jsxDEV7("div", {
             className: "space-y-3",
             children: [
               { label: "Email notifications", defaultChecked: true },
               { label: "Usage alerts", defaultChecked: true },
               { label: "Weekly digest", defaultChecked: false }
-            ].map((item) => /* @__PURE__ */ jsxDEV6("label", {
+            ].map((item) => /* @__PURE__ */ jsxDEV7("label", {
               className: "flex items-center gap-3",
               children: [
-                /* @__PURE__ */ jsxDEV6("input", {
+                /* @__PURE__ */ jsxDEV7("input", {
                   type: "checkbox",
                   defaultChecked: item.defaultChecked,
                   className: "h-4 w-4 rounded border-input"
                 }, undefined, false, undefined, this),
-                /* @__PURE__ */ jsxDEV6("span", {
+                /* @__PURE__ */ jsxDEV7("span", {
                   className: "text-sm",
                   children: item.label
                 }, undefined, false, undefined, this)
@@ -3210,26 +3481,26 @@ function SaasSettingsPanel() {
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV6("div", {
+      /* @__PURE__ */ jsxDEV7("div", {
         className: "rounded-xl border border-red-200 bg-red-50 p-6 dark:border-red-900 dark:bg-red-950/20",
         children: [
-          /* @__PURE__ */ jsxDEV6("h3", {
+          /* @__PURE__ */ jsxDEV7("h3", {
             className: "mb-2 font-semibold text-lg text-red-700 dark:text-red-400",
             children: "Danger Zone"
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV6("p", {
+          /* @__PURE__ */ jsxDEV7("p", {
             className: "mb-4 text-red-600 text-sm dark:text-red-300",
             children: "These actions are irreversible. Please proceed with caution."
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV6("div", {
+          /* @__PURE__ */ jsxDEV7("div", {
             className: "flex gap-3",
             children: [
-              /* @__PURE__ */ jsxDEV6(Button5, {
+              /* @__PURE__ */ jsxDEV7(Button5, {
                 variant: "secondary",
                 size: "sm",
                 children: "Export Data"
               }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV6(Button5, {
+              /* @__PURE__ */ jsxDEV7(Button5, {
                 variant: "secondary",
                 size: "sm",
                 children: "Delete Organization"
@@ -3292,6 +3563,7 @@ export {
   mockCreateProjectHandler,
   mockCheckFeatureAccessHandler,
   example_default as example,
+  createSaasVisualizationItems,
   createSaasHandlers,
   UsageSummaryModel,
   UsageRecordedPayloadModel,
@@ -3310,8 +3582,15 @@ export {
   SettingsScopeEnum,
   SettingsPanelPresentation,
   SettingsEntity,
+  SaasVisualizationSpecs,
+  SaasVisualizationRegistry,
+  SaasVisualizationRefs,
   SaasSettingsPanel,
+  SaasProjectUsageVisualization,
+  SaasProjectTierVisualization,
+  SaasProjectStatusVisualization,
   SaasProjectList,
+  SaasProjectActivityVisualization,
   SaasDashboardPresentation,
   SaasDashboard,
   SaasBoilerplateFeature,