@contractspec/example.analytics-dashboard 0.0.0-canary-20260113170453

package/dist/dashboard.feature.js

@@ -0,0 +1,177 @@
+import { defineFeature } from "@contractspec/lib.contracts";
+
+//#region src/dashboard.feature.ts
+/**
+* Analytics Dashboard Feature Module
+*
+* Comprehensive analytics and dashboarding solution for data visualization
+* and reporting across the platform.
+*
+* This feature module bundles all dashboard and query operations, events,
+* and presentations into an installable feature following FeatureModuleSpec.
+*/
+const AnalyticsDashboardFeature = defineFeature({
+	meta: {
+		key: "analytics-dashboard",
+		version: "1.0.0",
+		title: "Analytics Dashboard",
+		description: "Analytics dashboards with customizable widgets and queries",
+		domain: "analytics",
+		owners: ["@analytics-dashboard"],
+		tags: [
+			"analytics",
+			"dashboards",
+			"widgets",
+			"queries"
+		],
+		stability: "experimental"
+	},
+	operations: [
+		{
+			key: "analytics.dashboard.create",
+			version: "1.0.0"
+		},
+		{
+			key: "analytics.dashboard.list",
+			version: "1.0.0"
+		},
+		{
+			key: "analytics.dashboard.get",
+			version: "1.0.0"
+		},
+		{
+			key: "analytics.widget.add",
+			version: "1.0.0"
+		},
+		{
+			key: "analytics.query.create",
+			version: "1.0.0"
+		},
+		{
+			key: "analytics.query.execute",
+			version: "1.0.0"
+		}
+	],
+	events: [
+		{
+			key: "analytics.dashboard.created",
+			version: "1.0.0"
+		},
+		{
+			key: "analytics.widget.added",
+			version: "1.0.0"
+		},
+		{
+			key: "analytics.query.created",
+			version: "1.0.0"
+		}
+	],
+	presentations: [
+		{
+			key: "analytics.dashboard.list",
+			version: "1.0.0"
+		},
+		{
+			key: "analytics.dashboard.view",
+			version: "1.0.0"
+		},
+		{
+			key: "analytics.dashboard.editor",
+			version: "1.0.0"
+		},
+		{
+			key: "analytics.query.list",
+			version: "1.0.0"
+		},
+		{
+			key: "analytics.query.builder",
+			version: "1.0.0"
+		}
+	],
+	opToPresentation: [
+		{
+			op: {
+				key: "analytics.dashboard.list",
+				version: "1.0.0"
+			},
+			pres: {
+				key: "analytics.dashboard.list",
+				version: "1.0.0"
+			}
+		},
+		{
+			op: {
+				key: "analytics.dashboard.get",
+				version: "1.0.0"
+			},
+			pres: {
+				key: "analytics.dashboard.view",
+				version: "1.0.0"
+			}
+		},
+		{
+			op: {
+				key: "analytics.dashboard.create",
+				version: "1.0.0"
+			},
+			pres: {
+				key: "analytics.dashboard.editor",
+				version: "1.0.0"
+			}
+		},
+		{
+			op: {
+				key: "analytics.query.create",
+				version: "1.0.0"
+			},
+			pres: {
+				key: "analytics.query.builder",
+				version: "1.0.0"
+			}
+		}
+	],
+	presentationsTargets: [
+		{
+			key: "analytics.dashboard.list",
+			version: "1.0.0",
+			targets: [
+				"react",
+				"markdown",
+				"application/json"
+			]
+		},
+		{
+			key: "analytics.dashboard.view",
+			version: "1.0.0",
+			targets: ["react", "markdown"]
+		},
+		{
+			key: "analytics.dashboard.editor",
+			version: "1.0.0",
+			targets: ["react"]
+		},
+		{
+			key: "analytics.query.builder",
+			version: "1.0.0",
+			targets: ["react"]
+		}
+	],
+	capabilities: { requires: [
+		{
+			key: "identity",
+			version: "1.0.0"
+		},
+		{
+			key: "metering",
+			version: "1.0.0"
+		},
+		{
+			key: "audit-trail",
+			version: "1.0.0"
+		}
+	] }
+});
+
+//#endregion
+export { AnalyticsDashboardFeature };
+//# sourceMappingURL=dashboard.feature.js.map

package/dist/dashboard.feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.feature.js","names":[],"sources":["../src/dashboard.feature.ts"],"sourcesContent":["/**\n * Analytics Dashboard Feature Module\n *\n * Comprehensive analytics and dashboarding solution for data visualization\n * and reporting across the platform.\n *\n * This feature module bundles all dashboard and query operations, events,\n * and presentations into an installable feature following FeatureModuleSpec.\n */\n\nimport { defineFeature } from '@contractspec/lib.contracts';\n\n// ============ Feature Definition ============\n\nexport const AnalyticsDashboardFeature = defineFeature({\n  meta: {\n    key: 'analytics-dashboard',\n    version: '1.0.0',\n    title: 'Analytics Dashboard',\n    description: 'Analytics dashboards with customizable widgets and queries',\n    domain: 'analytics',\n    owners: ['@analytics-dashboard'],\n    tags: ['analytics', 'dashboards', 'widgets', 'queries'],\n    stability: 'experimental',\n  },\n\n  // ============ Contract Operations ============\n  // All contract operations included in this feature (OpRef[])\n  operations: [\n    // Dashboard operations\n    { key: 'analytics.dashboard.create', version: '1.0.0' },\n    { key: 'analytics.dashboard.list', version: '1.0.0' },\n    { key: 'analytics.dashboard.get', version: '1.0.0' },\n\n    // Widget operations\n    { key: 'analytics.widget.add', version: '1.0.0' },\n\n    // Query operations\n    { key: 'analytics.query.create', version: '1.0.0' },\n    { key: 'analytics.query.execute', version: '1.0.0' },\n  ],\n\n  // ============ Events ============\n  // Events emitted by this feature (EventRef[])\n  events: [\n    // Dashboard events\n    { key: 'analytics.dashboard.created', version: '1.0.0' },\n\n    // Widget events\n    { key: 'analytics.widget.added', version: '1.0.0' },\n\n    // Query events\n    { key: 'analytics.query.created', version: '1.0.0' },\n  ],\n\n  // ============ Presentations ============\n  // Presentations associated with this feature (PresentationRef[])\n  presentations: [\n    // Dashboard presentations\n    { key: 'analytics.dashboard.list', version: '1.0.0' },\n    { key: 'analytics.dashboard.view', version: '1.0.0' },\n    { key: 'analytics.dashboard.editor', version: '1.0.0' },\n\n    // Query presentations\n    { key: 'analytics.query.list', version: '1.0.0' },\n    { key: 'analytics.query.builder', version: '1.0.0' },\n  ],\n\n  // ============ Op-to-Presentation Links ============\n  // Links operations to their primary presentations\n  opToPresentation: [\n    {\n      op: { key: 'analytics.dashboard.list', version: '1.0.0' },\n      pres: { key: 'analytics.dashboard.list', version: '1.0.0' },\n    },\n    {\n      op: { key: 'analytics.dashboard.get', version: '1.0.0' },\n      pres: { key: 'analytics.dashboard.view', version: '1.0.0' },\n    },\n    {\n      op: { key: 'analytics.dashboard.create', version: '1.0.0' },\n      pres: { key: 'analytics.dashboard.editor', version: '1.0.0' },\n    },\n    {\n      op: { key: 'analytics.query.create', version: '1.0.0' },\n      pres: { key: 'analytics.query.builder', version: '1.0.0' },\n    },\n  ],\n\n  // ============ Presentation Targets ============\n  // Target requirements for multi-surface rendering\n  presentationsTargets: [\n    {\n      key: 'analytics.dashboard.list',\n      version: '1.0.0',\n      targets: ['react', 'markdown', 'application/json'],\n    },\n    {\n      key: 'analytics.dashboard.view',\n      version: '1.0.0',\n      targets: ['react', 'markdown'],\n    },\n    {\n      key: 'analytics.dashboard.editor',\n      version: '1.0.0',\n      targets: ['react'],\n    },\n    {\n      key: 'analytics.query.builder',\n      version: '1.0.0',\n      targets: ['react'],\n    },\n  ],\n\n  // ============ Capabilities ============\n  // Capability requirements for this feature\n  capabilities: {\n    requires: [\n      { key: 'identity', version: '1.0.0' },\n      { key: 'metering', version: '1.0.0' },\n      { key: 'audit-trail', version: '1.0.0' },\n    ],\n  },\n});\n"],"mappings":";;;;;;;;;;;;AAcA,MAAa,4BAA4B,cAAc;CACrD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,uBAAuB;EAChC,MAAM;GAAC;GAAa;GAAc;GAAW;GAAU;EACvD,WAAW;EACZ;CAID,YAAY;EAEV;GAAE,KAAK;GAA8B,SAAS;GAAS;EACvD;GAAE,KAAK;GAA4B,SAAS;GAAS;EACrD;GAAE,KAAK;GAA2B,SAAS;GAAS;EAGpD;GAAE,KAAK;GAAwB,SAAS;GAAS;EAGjD;GAAE,KAAK;GAA0B,SAAS;GAAS;EACnD;GAAE,KAAK;GAA2B,SAAS;GAAS;EACrD;CAID,QAAQ;EAEN;GAAE,KAAK;GAA+B,SAAS;GAAS;EAGxD;GAAE,KAAK;GAA0B,SAAS;GAAS;EAGnD;GAAE,KAAK;GAA2B,SAAS;GAAS;EACrD;CAID,eAAe;EAEb;GAAE,KAAK;GAA4B,SAAS;GAAS;EACrD;GAAE,KAAK;GAA4B,SAAS;GAAS;EACrD;GAAE,KAAK;GAA8B,SAAS;GAAS;EAGvD;GAAE,KAAK;GAAwB,SAAS;GAAS;EACjD;GAAE,KAAK;GAA2B,SAAS;GAAS;EACrD;CAID,kBAAkB;EAChB;GACE,IAAI;IAAE,KAAK;IAA4B,SAAS;IAAS;GACzD,MAAM;IAAE,KAAK;IAA4B,SAAS;IAAS;GAC5D;EACD;GACE,IAAI;IAAE,KAAK;IAA2B,SAAS;IAAS;GACxD,MAAM;IAAE,KAAK;IAA4B,SAAS;IAAS;GAC5D;EACD;GACE,IAAI;IAAE,KAAK;IAA8B,SAAS;IAAS;GAC3D,MAAM;IAAE,KAAK;IAA8B,SAAS;IAAS;GAC9D;EACD;GACE,IAAI;IAAE,KAAK;IAA0B,SAAS;IAAS;GACvD,MAAM;IAAE,KAAK;IAA2B,SAAS;IAAS;GAC3D;EACF;CAID,sBAAsB;EACpB;GACE,KAAK;GACL,SAAS;GACT,SAAS;IAAC;IAAS;IAAY;IAAmB;GACnD;EACD;GACE,KAAK;GACL,SAAS;GACT,SAAS,CAAC,SAAS,WAAW;GAC/B;EACD;GACE,KAAK;GACL,SAAS;GACT,SAAS,CAAC,QAAQ;GACnB;EACD;GACE,KAAK;GACL,SAAS;GACT,SAAS,CAAC,QAAQ;GACnB;EACF;CAID,cAAc,EACZ,UAAU;EACR;GAAE,KAAK;GAAY,SAAS;GAAS;EACrC;GAAE,KAAK;GAAY,SAAS;GAAS;EACrC;GAAE,KAAK;GAAe,SAAS;GAAS;EACzC,EACF;CACF,CAAC"}

package/dist/docs/analytics-dashboard.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/analytics-dashboard.docblock.js

@@ -0,0 +1,114 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/analytics-dashboard.docblock.ts
+registerDocBlocks([
+	{
+		id: "docs.examples.analytics-dashboard",
+		title: "Analytics Dashboard",
+		summary: "Multi-tenant analytics with dashboards, widgets, query builder, and scheduled reports built on the Event Bus.",
+		kind: "reference",
+		visibility: "public",
+		route: "/docs/examples/analytics-dashboard",
+		tags: [
+			"analytics",
+			"dashboards",
+			"bi",
+			"queries"
+		],
+		body: `## Entities
+
+- Dashboard, Widget, Query, Report.
+- Widget/query configs stay declarative for regeneration.
+
+## Contracts
+
+- \`analytics.dashboard.create\`, \`analytics.widget.add\`, \`analytics.query.execute\`, \`analytics.dashboard.get\`.
+- Metrics can source from Event Bus schemas and Usage/Metering module.
+
+## Events
+
+- dashboard.created/updated, widget.added, report.scheduled/sent.
+- Emitted for audit + notification hooks.
+
+## UI / Presentations
+
+- Dashboard list, dashboard view, query builder, widget gallery.
+- Registered under \`analytics-dashboard\` template in Template Registry.
+
+## Notes
+
+- Enforce org scoping for multi-tenant isolation.
+- Use Feature Flags for beta widgets; Metering to track query volume.
+`
+	},
+	{
+		id: "docs.examples.analytics-dashboard.goal",
+		title: "Analytics Dashboard — Goal",
+		summary: "Why this template matters and what success looks like.",
+		kind: "goal",
+		visibility: "public",
+		route: "/docs/examples/analytics-dashboard/goal",
+		tags: ["analytics", "goal"],
+		body: `## Why it matters
+- Give teams a regenerable analytics workspace that stays in sync with Event Bus, Usage/Metering, and presentations.
+- Avoid dashboard drift by keeping schema-first widgets/queries.
+
+## Business/Product goal
+- Deliver tenant-scoped dashboards, governed queries, and scheduled reports with clear ownership and auditability.
+- Enable feature-flagged rollout of new widgets and sampling for cost control.
+
+## Success criteria
+- Dashboards can be regenerated safely from spec changes.
+- Queries/widgets have enforced validation; PII is redacted per policy.`
+	},
+	{
+		id: "docs.examples.analytics-dashboard.usage",
+		title: "Analytics Dashboard — Usage",
+		summary: "How to seed, extend, and safely regenerate dashboards.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/examples/analytics-dashboard/usage",
+		tags: ["analytics", "usage"],
+		body: `## Setup
+1) Seed dashboards/widgets (via template registry) to preload sample queries.
+2) Configure org/tenant scope and attach Usage/Metering for cost/sampling controls.
+
+## Extend & regenerate
+1) Add or modify widget/query schemas in the spec (inputs, validation, PII paths).
+2) Regenerate to update UI + API + events; review presentations for redaction.
+3) Use Feature Flags to roll out new widgets or sampling knobs gradually.
+
+## Guardrails
+- Keep all query inputs validated; mark PII paths in policy.
+- Use Audit Trail for report deliveries; Notifications for scheduled sends.`
+	},
+	{
+		id: "docs.examples.analytics-dashboard.constraints",
+		title: "Analytics Dashboard — Constraints & Safety",
+		summary: "Internal guardrails for queries, widgets, and regeneration.",
+		kind: "reference",
+		visibility: "internal",
+		route: "/docs/examples/analytics-dashboard/constraints",
+		tags: [
+			"analytics",
+			"constraints",
+			"internal"
+		],
+		body: `## Constraints
+- Queries and widgets must declare inputs/validation in spec; no ad-hoc query strings.
+- Regeneration must preserve sampling/windowing semantics; document changes explicitly.
+- Events/usage metrics should remain consistent with Metering/Audit wiring.
+
+## PII & Data
+- Mark PII paths (user ids, emails) in presentations for redaction.
+- Avoid exposing raw query payloads in MCP/web without policy checks.
+
+## Verification
+- Add fixtures for widget/query schema changes and scheduled reports.
+- Run regeneration diff when adjusting query builders; ensure UI/markdown targets updated.
+- Confirm feature-flagged widgets default to safe/off for new tenants.`
+	}
+]);
+
+//#endregion
+//# sourceMappingURL=analytics-dashboard.docblock.js.map

package/dist/docs/analytics-dashboard.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-dashboard.docblock.js","names":[],"sources":["../../src/docs/analytics-dashboard.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst analyticsDashboardDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.examples.analytics-dashboard',\n    title: 'Analytics Dashboard',\n    summary:\n      'Multi-tenant analytics with dashboards, widgets, query builder, and scheduled reports built on the Event Bus.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/analytics-dashboard',\n    tags: ['analytics', 'dashboards', 'bi', 'queries'],\n    body: `## Entities\n\n- Dashboard, Widget, Query, Report.\n- Widget/query configs stay declarative for regeneration.\n\n## Contracts\n\n- \\`analytics.dashboard.create\\`, \\`analytics.widget.add\\`, \\`analytics.query.execute\\`, \\`analytics.dashboard.get\\`.\n- Metrics can source from Event Bus schemas and Usage/Metering module.\n\n## Events\n\n- dashboard.created/updated, widget.added, report.scheduled/sent.\n- Emitted for audit + notification hooks.\n\n## UI / Presentations\n\n- Dashboard list, dashboard view, query builder, widget gallery.\n- Registered under \\`analytics-dashboard\\` template in Template Registry.\n\n## Notes\n\n- Enforce org scoping for multi-tenant isolation.\n- Use Feature Flags for beta widgets; Metering to track query volume.\n`,\n  },\n  {\n    id: 'docs.examples.analytics-dashboard.goal',\n    title: 'Analytics Dashboard — Goal',\n    summary: 'Why this template matters and what success looks like.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/analytics-dashboard/goal',\n    tags: ['analytics', 'goal'],\n    body: `## Why it matters\n- Give teams a regenerable analytics workspace that stays in sync with Event Bus, Usage/Metering, and presentations.\n- Avoid dashboard drift by keeping schema-first widgets/queries.\n\n## Business/Product goal\n- Deliver tenant-scoped dashboards, governed queries, and scheduled reports with clear ownership and auditability.\n- Enable feature-flagged rollout of new widgets and sampling for cost control.\n\n## Success criteria\n- Dashboards can be regenerated safely from spec changes.\n- Queries/widgets have enforced validation; PII is redacted per policy.`,\n  },\n  {\n    id: 'docs.examples.analytics-dashboard.usage',\n    title: 'Analytics Dashboard — Usage',\n    summary: 'How to seed, extend, and safely regenerate dashboards.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/analytics-dashboard/usage',\n    tags: ['analytics', 'usage'],\n    body: `## Setup\n1) Seed dashboards/widgets (via template registry) to preload sample queries.\n2) Configure org/tenant scope and attach Usage/Metering for cost/sampling controls.\n\n## Extend & regenerate\n1) Add or modify widget/query schemas in the spec (inputs, validation, PII paths).\n2) Regenerate to update UI + API + events; review presentations for redaction.\n3) Use Feature Flags to roll out new widgets or sampling knobs gradually.\n\n## Guardrails\n- Keep all query inputs validated; mark PII paths in policy.\n- Use Audit Trail for report deliveries; Notifications for scheduled sends.`,\n  },\n  {\n    id: 'docs.examples.analytics-dashboard.constraints',\n    title: 'Analytics Dashboard — Constraints & Safety',\n    summary: 'Internal guardrails for queries, widgets, and regeneration.',\n    kind: 'reference',\n    visibility: 'internal',\n    route: '/docs/examples/analytics-dashboard/constraints',\n    tags: ['analytics', 'constraints', 'internal'],\n    body: `## Constraints\n- Queries and widgets must declare inputs/validation in spec; no ad-hoc query strings.\n- Regeneration must preserve sampling/windowing semantics; document changes explicitly.\n- Events/usage metrics should remain consistent with Metering/Audit wiring.\n\n## PII & Data\n- Mark PII paths (user ids, emails) in presentations for redaction.\n- Avoid exposing raw query payloads in MCP/web without policy checks.\n\n## Verification\n- Add fixtures for widget/query schema changes and scheduled reports.\n- Run regeneration diff when adjusting query builders; ensure UI/markdown targets updated.\n- Confirm feature-flagged widgets default to safe/off for new tenants.`,\n  },\n];\n\nregisterDocBlocks(analyticsDashboardDocBlocks);\n"],"mappings":";;;AAwGA,kBArGgD;CAC9C;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAa;GAAc;GAAM;GAAU;EAClD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;EAyBP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,aAAa,OAAO;EAC3B,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,aAAa,QAAQ;EAC5B,MAAM;;;;;;;;;;;;EAYP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAa;GAAe;GAAW;EAC9C,MAAM;;;;;;;;;;;;;EAaP;CACF,CAE6C"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./analytics-dashboard.docblock.js";

package/dist/events.d.ts

@@ -0,0 +1,149 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+import * as _contractspec_lib_schema0 from "@contractspec/lib.schema";
+
+//#region src/events.d.ts
+declare const DashboardCreatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  dashboardId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  title: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  orgId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  createdBy: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  timestamp: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+declare const WidgetAddedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  widgetId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  dashboardId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  widgetType: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  orgId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  timestamp: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+declare const QueryCreatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+  queryId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  queryType: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  orgId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  createdBy: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  timestamp: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+declare const AnalyticsDashboardEvents: {
+  DashboardCreatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+    dashboardId: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    title: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    orgId: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    createdBy: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    timestamp: {
+      type: _contractspec_lib_schema0.FieldType<Date, string>;
+      isOptional: false;
+    };
+  }>>;
+  WidgetAddedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+    widgetId: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    dashboardId: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    widgetType: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    orgId: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    timestamp: {
+      type: _contractspec_lib_schema0.FieldType<Date, string>;
+      isOptional: false;
+    };
+  }>>;
+  QueryCreatedEvent: _contractspec_lib_contracts0.EventSpec<_contractspec_lib_schema0.SchemaModel<{
+    queryId: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    name: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    queryType: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    orgId: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    createdBy: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    timestamp: {
+      type: _contractspec_lib_schema0.FieldType<Date, string>;
+      isOptional: false;
+    };
+  }>>;
+};
+//#endregion
+export { AnalyticsDashboardEvents, DashboardCreatedEvent, QueryCreatedEvent, WidgetAddedEvent };
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","names":[],"sources":["../src/events.ts"],"sourcesContent":[],"mappings":";;;;cAwCa,uBAAqB,4BAAA,CAAA,oCAAA;;UAUhC,yBAAA,CAAA;;EAVW,CAAA;EAUX,KAAA,EAAA;;;;;;;EAVgC,CAAA;EAAA,SAAA,EAAA;IAYrB,IAAA,qCAUX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;AAV2B,cAAhB,gBAAgB,EAAA,4BAAA,CAAA,SAAA,2BAAA,WAAA,CAAA;EAAA,QAAA,EAAA;IAYhB,IAAA,EAFX,yBAAA,CAAA,SAYA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;6CAV4B,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;EAYjB,KAAA,EAAA;IAIZ,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;cAhBY,mBAAiB,4BAAA,CAAA,oCAAA;;UAU5B,yBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;cAEW;;;YAIZ,yBAAA,CAAA"}

package/dist/events.js

@@ -0,0 +1,128 @@
+import { defineEvent } from "@contractspec/lib.contracts";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/events.ts
+const DashboardEventPayload = defineSchemaModel({
+	name: "DashboardEventPayload",
+	description: "Payload for dashboard events",
+	fields: {
+		dashboardId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		title: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		createdBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const WidgetEventPayload = defineSchemaModel({
+	name: "WidgetEventPayload",
+	description: "Payload for widget events",
+	fields: {
+		widgetId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		dashboardId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		widgetType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const QueryEventPayload = defineSchemaModel({
+	name: "QueryEventPayload",
+	description: "Payload for query events",
+	fields: {
+		queryId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		queryType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		createdBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const DashboardCreatedEvent = defineEvent({
+	meta: {
+		key: "analytics.dashboard.created",
+		version: "1.0.0",
+		description: "A dashboard was created.",
+		stability: "stable",
+		owners: ["@analytics-team"],
+		tags: ["dashboard"]
+	},
+	payload: DashboardEventPayload
+});
+const WidgetAddedEvent = defineEvent({
+	meta: {
+		key: "analytics.widget.added",
+		version: "1.0.0",
+		description: "A widget was added to a dashboard.",
+		stability: "stable",
+		owners: ["@analytics-team"],
+		tags: ["dashboard"]
+	},
+	payload: WidgetEventPayload
+});
+const QueryCreatedEvent = defineEvent({
+	meta: {
+		key: "analytics.query.created",
+		version: "1.0.0",
+		description: "A query was created.",
+		stability: "stable",
+		owners: ["@analytics-team"],
+		tags: ["dashboard"]
+	},
+	payload: QueryEventPayload
+});
+const AnalyticsDashboardEvents = {
+	DashboardCreatedEvent,
+	WidgetAddedEvent,
+	QueryCreatedEvent
+};
+
+//#endregion
+export { AnalyticsDashboardEvents, DashboardCreatedEvent, QueryCreatedEvent, WidgetAddedEvent };
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\nimport { defineEvent } from '@contractspec/lib.contracts';\n\nconst DashboardEventPayload = defineSchemaModel({\n  name: 'DashboardEventPayload',\n  description: 'Payload for dashboard events',\n  fields: {\n    dashboardId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst WidgetEventPayload = defineSchemaModel({\n  name: 'WidgetEventPayload',\n  description: 'Payload for widget events',\n  fields: {\n    widgetId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    dashboardId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    widgetType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nconst QueryEventPayload = defineSchemaModel({\n  name: 'QueryEventPayload',\n  description: 'Payload for query events',\n  fields: {\n    queryId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    queryType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    timestamp: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const DashboardCreatedEvent = defineEvent({\n  meta: {\n    key: 'analytics.dashboard.created',\n    version: '1.0.0',\n    description: 'A dashboard was created.',\n    stability: 'stable',\n    owners: ['@analytics-team'],\n    tags: ['dashboard'],\n  },\n  payload: DashboardEventPayload,\n});\n\nexport const WidgetAddedEvent = defineEvent({\n  meta: {\n    key: 'analytics.widget.added',\n    version: '1.0.0',\n    description: 'A widget was added to a dashboard.',\n    stability: 'stable',\n    owners: ['@analytics-team'],\n    tags: ['dashboard'],\n  },\n  payload: WidgetEventPayload,\n});\n\nexport const QueryCreatedEvent = defineEvent({\n  meta: {\n    key: 'analytics.query.created',\n    version: '1.0.0',\n    description: 'A query was created.',\n    stability: 'stable',\n    owners: ['@analytics-team'],\n    tags: ['dashboard'],\n  },\n  payload: QueryEventPayload,\n});\n\nexport const AnalyticsDashboardEvents = {\n  DashboardCreatedEvent,\n  WidgetAddedEvent,\n  QueryCreatedEvent,\n};\n"],"mappings":";;;;AAGA,MAAM,wBAAwB,kBAAkB;CAC9C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,aAAa;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC1E,OAAO;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE,OAAO;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE,WAAW;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE,WAAW;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAO;EAClE;CACF,CAAC;AAEF,MAAM,qBAAqB,kBAAkB;CAC3C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACvE,aAAa;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC1E,YAAY;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACzE,OAAO;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE,WAAW;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAO;EAClE;CACF,CAAC;AAEF,MAAM,oBAAoB,kBAAkB;CAC1C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,MAAM;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE,WAAW;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE,OAAO;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE,WAAW;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE,WAAW;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAO;EAClE;CACF,CAAC;AAEF,MAAa,wBAAwB,YAAY;CAC/C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,kBAAkB;EAC3B,MAAM,CAAC,YAAY;EACpB;CACD,SAAS;CACV,CAAC;AAEF,MAAa,mBAAmB,YAAY;CAC1C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,kBAAkB;EAC3B,MAAM,CAAC,YAAY;EACpB;CACD,SAAS;CACV,CAAC;AAEF,MAAa,oBAAoB,YAAY;CAC3C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,kBAAkB;EAC3B,MAAM,CAAC,YAAY;EACpB;CACD,SAAS;CACV,CAAC;AAEF,MAAa,2BAA2B;CACtC;CACA;CACA;CACD"}

package/dist/example.d.ts

@@ -0,0 +1,7 @@
+import * as _contractspec_lib_contracts15 from "@contractspec/lib.contracts";
+
+//#region src/example.d.ts
+declare const example: _contractspec_lib_contracts15.ExampleSpec;
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SAoCJ,6BAAA,CApCW"}

package/dist/example.js

@@ -0,0 +1,58 @@
+import { defineExample } from "@contractspec/lib.contracts";
+
+//#region src/example.ts
+const example = defineExample({
+	meta: {
+		key: "analytics-dashboard",
+		version: "1.0.0",
+		title: "Analytics Dashboard",
+		description: "Tenant-scoped dashboards, widgets, query builder, and scheduled reports (spec-first widgets/queries).",
+		kind: "template",
+		visibility: "public",
+		stability: "experimental",
+		owners: ["@platform.core"],
+		tags: [
+			"analytics",
+			"dashboards",
+			"bi",
+			"queries"
+		]
+	},
+	docs: {
+		rootDocId: "docs.examples.analytics-dashboard",
+		goalDocId: "docs.examples.analytics-dashboard.goal",
+		usageDocId: "docs.examples.analytics-dashboard.usage",
+		constraintsDocId: "docs.examples.analytics-dashboard.constraints"
+	},
+	entrypoints: {
+		packageName: "@contractspec/example.analytics-dashboard",
+		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;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map