@contractspec/lib.example-shared-ui 1.11.0 → 1.12.0

package/dist/node/utils/index.js

@@ -0,0 +1,437 @@
+// src/utils/generateSpecFromTemplate.ts
+function generateSpecFromTemplate(template) {
+  const templateId = template?.id ?? "unknown";
+  if (!template) {
+    return generateDefaultSpec(templateId);
+  }
+  switch (templateId) {
+    case "crm-pipeline":
+      return generateCrmPipelineSpec(template.schema.contracts);
+    case "saas-boilerplate":
+      return generateSaasBoilerplateSpec(template.schema.contracts);
+    case "agent-console":
+      return generateAgentConsoleSpec(template.schema.contracts);
+    case "todos-app":
+      return generateTodosSpec(template.schema.contracts);
+    case "messaging-app":
+      return generateMessagingSpec(template.schema.contracts);
+    case "recipe-app-i18n":
+      return generateRecipeSpec(template.schema.contracts);
+    default:
+      return generateDefaultSpec(templateId);
+  }
+}
+function generateCrmPipelineSpec(contracts) {
+  return `// CRM Pipeline Specs
+// Contracts: ${contracts.join(", ")}
+
+contractSpec("crm.deal.updateStage.v1", {
+  goal: "Move a deal to a different pipeline stage",
+  transport: { gql: { mutation: "updateDealStage" } },
+  io: {
+    input: { 
+      dealId: "string",
+      stageId: "string",
+      notes: "string?"
+    },
+    output: { 
+      deal: {
+        id: "string",
+        stage: "string",
+        probability: "number",
+        value: "number"
+      }
+    }
+  },
+  events: ["deal.stage.changed"],
+  policy: { auth: "user", rbac: "org:sales" }
+});
+
+contractSpec("crm.deal.create.v1", {
+  goal: "Create a new deal in the pipeline",
+  transport: { gql: { mutation: "createDeal" } },
+  io: {
+    input: { 
+      title: "string",
+      value: "number",
+      contactId: "string",
+      stageId: "string",
+      ownerId: "string?"
+    },
+    output: { 
+      deal: {
+        id: "string",
+        title: "string",
+        value: "number",
+        stage: "string",
+        createdAt: "ISO8601"
+      }
+    }
+  },
+  events: ["deal.created"]
+});
+
+contractSpec("crm.contact.list.v1", {
+  goal: "List contacts with filtering and pagination",
+  transport: { gql: { query: "listContacts" } },
+  io: {
+    input: { 
+      filter: {
+        search: "string?",
+        companyId: "string?",
+        tags: "string[]?"
+      },
+      pagination: {
+        page: "number",
+        limit: "number"
+      }
+    },
+    output: { 
+      contacts: "array<Contact>",
+      total: "number",
+      hasMore: "boolean"
+    }
+  }
+});`;
+}
+function generateSaasBoilerplateSpec(contracts) {
+  return `// SaaS Boilerplate Specs
+// Contracts: ${contracts.join(", ")}
+
+contractSpec("saas.project.create.v1", {
+  goal: "Create a new project in an organization",
+  transport: { gql: { mutation: "createProject" } },
+  io: {
+    input: { 
+      orgId: "string",
+      name: "string",
+      description: "string?"
+    },
+    output: { 
+      project: {
+        id: "string",
+        name: "string",
+        description: "string?",
+        createdAt: "ISO8601"
+      }
+    }
+  },
+  policy: { auth: "user", rbac: "org:member" }
+});
+
+contractSpec("saas.billing.recordUsage.v1", {
+  goal: "Record usage for billing purposes",
+  transport: { gql: { mutation: "recordUsage" } },
+  io: {
+    input: { 
+      orgId: "string",
+      metric: "enum<'api_calls'|'storage_gb'|'seats'>",
+      quantity: "number",
+      timestamp: "ISO8601?"
+    },
+    output: { 
+      usage: {
+        id: "string",
+        metric: "string",
+        quantity: "number",
+        recordedAt: "ISO8601"
+      }
+    }
+  },
+  events: ["billing.usage.recorded"]
+});
+
+contractSpec("saas.settings.update.v1", {
+  goal: "Update organization or user settings",
+  transport: { gql: { mutation: "updateSettings" } },
+  io: {
+    input: { 
+      scope: "enum<'org'|'user'>",
+      targetId: "string",
+      settings: "Record<string, unknown>"
+    },
+    output: { 
+      settings: {
+        scope: "string",
+        values: "Record<string, unknown>",
+        updatedAt: "ISO8601"
+      }
+    }
+  },
+  events: ["settings.updated"]
+});`;
+}
+function generateAgentConsoleSpec(contracts) {
+  return `// Agent Console Specs
+// Contracts: ${contracts.join(", ")}
+
+contractSpec("agent.run.execute.v1", {
+  goal: "Execute an agent run with specified tools",
+  transport: { gql: { mutation: "executeAgentRun" } },
+  io: {
+    input: { 
+      agentId: "string",
+      input: "string",
+      tools: "string[]?",
+      maxSteps: "number?"
+    },
+    output: { 
+      runId: "string",
+      status: "enum<'running'|'completed'|'failed'>",
+      steps: "number"
+    }
+  },
+  events: ["run.started", "run.completed", "run.failed"]
+});
+
+contractSpec("agent.tool.create.v1", {
+  goal: "Register a new tool in the tool registry",
+  transport: { gql: { mutation: "createTool" } },
+  io: {
+    input: { 
+      name: "string",
+      description: "string",
+      category: "enum<'code'|'data'|'api'|'file'|'custom'>",
+      schema: "JSONSchema",
+      handler: "string"
+    },
+    output: { 
+      tool: {
+        id: "string",
+        name: "string",
+        category: "string",
+        createdAt: "ISO8601"
+      }
+    }
+  },
+  events: ["tool.created"]
+});
+
+contractSpec("agent.agent.create.v1", {
+  goal: "Create a new AI agent configuration",
+  transport: { gql: { mutation: "createAgent" } },
+  io: {
+    input: { 
+      name: "string",
+      description: "string",
+      model: "string",
+      systemPrompt: "string?",
+      tools: "string[]?"
+    },
+    output: { 
+      agent: {
+        id: "string",
+        name: "string",
+        model: "string",
+        toolCount: "number",
+        createdAt: "ISO8601"
+      }
+    }
+  },
+  events: ["agent.created"]
+});`;
+}
+function generateTodosSpec(contracts) {
+  return `// To-dos App Specs
+// Contracts: ${contracts.join(", ")}
+
+contractSpec("tasks.board.v1", {
+  goal: "Assign and approve craft work",
+  transport: { gql: { field: "tasksBoard" } },
+  io: {
+    input: { 
+      tenantId: "string", 
+      assignee: "string?",
+      status: "enum<'pending'|'in_progress'|'completed'>?"
+    },
+    output: { 
+      tasks: "array<Task>",
+      summary: {
+        total: "number",
+        completed: "number",
+        overdue: "number"
+      }
+    }
+  }
+});
+
+contractSpec("tasks.create.v1", {
+  goal: "Create a new task",
+  transport: { gql: { mutation: "createTask" } },
+  io: {
+    input: { 
+      title: "string",
+      description: "string?",
+      assignee: "string?",
+      priority: "enum<'low'|'medium'|'high'>",
+      dueDate: "ISO8601?"
+    },
+    output: { 
+      task: {
+        id: "string",
+        title: "string",
+        status: "string",
+        createdAt: "ISO8601"
+      }
+    }
+  },
+  events: ["task.created"]
+});
+
+contractSpec("tasks.complete.v1", {
+  goal: "Mark a task as completed",
+  transport: { gql: { mutation: "completeTask" } },
+  io: {
+    input: { taskId: "string" },
+    output: { 
+      task: {
+        id: "string",
+        status: "string",
+        completedAt: "ISO8601"
+      }
+    }
+  },
+  events: ["task.completed"]
+});`;
+}
+function generateMessagingSpec(contracts) {
+  return `// Messaging App Specs
+// Contracts: ${contracts.join(", ")}
+
+contractSpec("messaging.send.v1", {
+  goal: "Deliver intent-rich updates",
+  io: {
+    input: { 
+      conversationId: "string", 
+      body: "richtext",
+      attachments: "array<Attachment>?"
+    },
+    output: { 
+      messageId: "string", 
+      deliveredAt: "ISO8601"
+    }
+  },
+  events: ["message.sent", "message.delivered"]
+});
+
+contractSpec("messaging.conversation.create.v1", {
+  goal: "Start a new conversation",
+  transport: { gql: { mutation: "createConversation" } },
+  io: {
+    input: { 
+      participants: "string[]",
+      title: "string?",
+      type: "enum<'direct'|'group'>"
+    },
+    output: { 
+      conversation: {
+        id: "string",
+        title: "string?",
+        participantCount: "number",
+        createdAt: "ISO8601"
+      }
+    }
+  },
+  events: ["conversation.created"]
+});
+
+contractSpec("messaging.read.v1", {
+  goal: "Mark messages as read",
+  transport: { gql: { mutation: "markRead" } },
+  io: {
+    input: { 
+      conversationId: "string",
+      messageIds: "string[]"
+    },
+    output: { 
+      readCount: "number",
+      readAt: "ISO8601"
+    }
+  },
+  events: ["message.read"]
+});`;
+}
+function generateRecipeSpec(contracts) {
+  return `// Recipe App (i18n) Specs
+// Contracts: ${contracts.join(", ")}
+
+contractSpec("recipes.lookup.v1", {
+  goal: "Serve bilingual rituals",
+  io: {
+    input: { 
+      locale: "enum<'EN'|'FR'>", 
+      slug: "string" 
+    },
+    output: { 
+      title: "string", 
+      content: "markdown",
+      ingredients: "array<Ingredient>",
+      instructions: "array<Instruction>"
+    }
+  }
+});
+
+contractSpec("recipes.list.v1", {
+  goal: "Browse recipes with filtering",
+  transport: { gql: { query: "listRecipes" } },
+  io: {
+    input: { 
+      locale: "enum<'EN'|'FR'>",
+      category: "string?",
+      search: "string?",
+      favorites: "boolean?"
+    },
+    output: { 
+      recipes: "array<RecipeSummary>",
+      categories: "array<Category>",
+      total: "number"
+    }
+  }
+});
+
+contractSpec("recipes.favorite.toggle.v1", {
+  goal: "Toggle recipe favorite status",
+  transport: { gql: { mutation: "toggleFavorite" } },
+  io: {
+    input: { recipeId: "string" },
+    output: { 
+      isFavorite: "boolean",
+      totalFavorites: "number"
+    }
+  },
+  events: ["recipe.favorited", "recipe.unfavorited"]
+});`;
+}
+function generateDefaultSpec(templateId) {
+  return `// ${templateId} Specs
+
+contractSpec("${templateId}.main.v1", {
+  goal: "Main operation for ${templateId}",
+  transport: { gql: { query: "main" } },
+  io: {
+    input: { 
+      id: "string"
+    },
+    output: { 
+      result: "unknown"
+    }
+  }
+});`;
+}
+
+// src/utils/fetchPresentationData.ts
+async function fetchPresentationData(_presentationName, _templateId) {
+  throw new Error("fetchPresentationData is deprecated. Use fetchData from TemplateRuntimeContext.");
+}
+function hasPresentationDataFetcher(_presentationName) {
+  return false;
+}
+function getRegisteredPresentationFetchers() {
+  return [];
+}
+export {
+  hasPresentationDataFetcher,
+  getRegisteredPresentationFetchers,
+  generateSpecFromTemplate,
+  fetchPresentationData
+};

package/dist/overlay-types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared Overlay Type Definitions
+ *
+ * These types are used across all template overlays to ensure consistency.
+ */
+export interface OverlayDefinition {
+    overlayId: string;
+    version: string;
+    description: string;
+    appliesTo: {
+        presentation?: string;
+        role?: string;
+        feature?: string;
+        tier?: string;
+    };
+    modifications: OverlayModification[];
+}
+export type OverlayModification = {
+    type: 'hideField';
+    field: string;
+    reason?: string;
+} | {
+    type: 'renameLabel';
+    field: string;
+    newLabel: string;
+} | {
+    type: 'addBadge';
+    position: string;
+    label: string;
+    variant?: string;
+} | {
+    type: 'setDefault';
+    field: string;
+    value: unknown;
+} | {
+    type: 'setLimit';
+    field: string;
+    max: number;
+    message?: string;
+};
+//# sourceMappingURL=overlay-types.d.ts.map

package/dist/overlay-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-types.d.ts","sourceRoot":"","sources":["../src/overlay-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QACT,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,aAAa,EAAE,mBAAmB,EAAE,CAAC;CACtC;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/overlay-types.js

@@ -0,0 +1 @@
+// @bun

package/dist/utils/fetchPresentationData.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Fetch Presentation Data Utility
+ *
+ * Types for presentation data fetching.
+ * Actual fetching logic is now handled via TemplateRuntimeContext and dependency injection.
+ */
+import type { TemplateId } from '../lib/types';
+/**
+ * Data fetcher result type
+ */
+export interface PresentationDataResult {
+    data: unknown;
+    metadata?: {
+        total?: number;
+        timestamp?: Date;
+        source?: string;
+    };
+}
+/**
+ * @deprecated Use fetchData from TemplateRuntimeContext instead.
+ */
+/**
+ * @deprecated Use fetchData from TemplateRuntimeContext instead.
+ */
+export declare function fetchPresentationData(_presentationName: string, _templateId: TemplateId): Promise<PresentationDataResult>;
+/**
+ * @deprecated
+ */
+export declare function hasPresentationDataFetcher(_presentationName: string): boolean;
+/**
+ * @deprecated
+ */
+export declare function getRegisteredPresentationFetchers(): string[];
+//# sourceMappingURL=fetchPresentationData.d.ts.map

package/dist/utils/fetchPresentationData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchPresentationData.d.ts","sourceRoot":"","sources":["../../src/utils/fetchPresentationData.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,UAAU,GACtB,OAAO,CAAC,sBAAsB,CAAC,CAIjC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED;;GAEG;AACH,wBAAgB,iCAAiC,IAAI,MAAM,EAAE,CAE5D"}

package/dist/utils/fetchPresentationData.js

@@ -0,0 +1,16 @@
+// @bun
+// src/utils/fetchPresentationData.ts
+async function fetchPresentationData(_presentationName, _templateId) {
+  throw new Error("fetchPresentationData is deprecated. Use fetchData from TemplateRuntimeContext.");
+}
+function hasPresentationDataFetcher(_presentationName) {
+  return false;
+}
+function getRegisteredPresentationFetchers() {
+  return [];
+}
+export {
+  hasPresentationDataFetcher,
+  getRegisteredPresentationFetchers,
+  fetchPresentationData
+};

package/dist/utils/generateSpecFromTemplate.d.ts

@@ -0,0 +1,7 @@
+import type { TemplateDefinition } from '../lib/types';
+/**
+ * Generate TypeScript spec code from a template's definition.
+ * Converts FeatureModuleSpec contracts to TypeScript spec code.
+ */
+export declare function generateSpecFromTemplate(template: TemplateDefinition | null): string;
+//# sourceMappingURL=generateSpecFromTemplate.d.ts.map

package/dist/utils/generateSpecFromTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateSpecFromTemplate.d.ts","sourceRoot":"","sources":["../../src/utils/generateSpecFromTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAc,MAAM,cAAc,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAClC,MAAM,CAwBR"}