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

package/dist/lib/component-registry.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { TemplateId } from './types';
+export interface TemplateComponentRegistration {
+    list: React.ComponentType<any>;
+    detail: React.ComponentType<any>;
+    form?: React.ComponentType<any>;
+}
+export declare class TemplateComponentRegistry {
+    private readonly components;
+    private readonly listeners;
+    register(templateId: TemplateId, registration: TemplateComponentRegistration): void;
+    get(templateId: TemplateId): TemplateComponentRegistration | undefined;
+    subscribe(listener: (templateId: TemplateId) => void): () => void;
+}
+export declare const templateComponentRegistry: TemplateComponentRegistry;
+export declare function registerTemplateComponents(templateId: TemplateId, components: TemplateComponentRegistration): void;
+export declare function useTemplateComponents(templateId: TemplateId): TemplateComponentRegistration | undefined;
+//# sourceMappingURL=component-registry.d.ts.map

package/dist/lib/component-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.d.ts","sourceRoot":"","sources":["../../src/lib/component-registry.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;CACjC;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGvB;IACJ,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;IAEzE,QAAQ,CACN,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,6BAA6B;IAM7C,GAAG,CAAC,UAAU,EAAE,UAAU;IAI1B,SAAS,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI;CAMrD;AAED,eAAO,MAAM,yBAAyB,2BAAkC,CAAC;AAEzE,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,6BAA6B,QAG1C;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,UAAU,GACrB,6BAA6B,GAAG,SAAS,CAc3C"}

package/dist/lib/component-registry.js

@@ -0,0 +1,43 @@
+// @bun
+// src/lib/component-registry.tsx
+import { useState, useEffect } from "react";
+"use client";
+
+class TemplateComponentRegistry {
+  components = new Map;
+  listeners = new Set;
+  register(templateId, registration) {
+    this.components.set(templateId, registration);
+    this.listeners.forEach((l) => l(templateId));
+  }
+  get(templateId) {
+    return this.components.get(templateId);
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+}
+var templateComponentRegistry = new TemplateComponentRegistry;
+function registerTemplateComponents(templateId, components) {
+  templateComponentRegistry.register(templateId, components);
+}
+function useTemplateComponents(templateId) {
+  const [components, setComponents] = useState(() => templateComponentRegistry.get(templateId));
+  useEffect(() => {
+    return templateComponentRegistry.subscribe((updatedId) => {
+      if (updatedId === templateId) {
+        setComponents(templateComponentRegistry.get(templateId));
+      }
+    });
+  }, [templateId]);
+  return components;
+}
+export {
+  useTemplateComponents,
+  templateComponentRegistry,
+  registerTemplateComponents,
+  TemplateComponentRegistry
+};

package/dist/lib/runtime-context.d.ts

@@ -0,0 +1,29 @@
+import type { ApolloClient } from '@apollo/client';
+import type { TransformEngine } from '@contractspec/lib.contracts';
+import type { TemplateDefinition, TemplateId, TemplateInstaller } from './types';
+export type GenericTemplateHandlers = unknown;
+export interface TemplateRuntimeContextValue<THandlers = GenericTemplateHandlers> {
+    template: TemplateDefinition;
+    runtime: unknown;
+    installer: TemplateInstaller;
+    client: ApolloClient;
+    components?: unknown;
+    /** @deprecated use template.id */
+    templateId: TemplateId;
+    projectId: string;
+    engine: TransformEngine;
+    fetchData: (presentationName: string) => Promise<{
+        data: unknown;
+        metadata?: unknown;
+    }>;
+    handlers: THandlers;
+    resolvePresentation?: (presentationName: string) => unknown;
+}
+export declare const TemplateRuntimeContext: import("react").Context<TemplateRuntimeContextValue<unknown> | null>;
+export declare function useTemplateRuntime<THandlers = GenericTemplateHandlers>(): TemplateRuntimeContextValue<THandlers>;
+export interface TemplateRuntimeProviderProps {
+    templateId: TemplateId;
+    projectId?: string;
+    lazy?: boolean;
+}
+//# sourceMappingURL=runtime-context.d.ts.map

package/dist/lib/runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../src/lib/runtime-context.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAIjB,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE9C,MAAM,WAAW,2BAA2B,CAC1C,SAAS,GAAG,uBAAuB;IAEnC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kCAAkC;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,CACT,gBAAgB,EAAE,MAAM,KACrB,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpD,QAAQ,EAAE,SAAS,CAAC;IACpB,mBAAmB,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC;CAC7D;AAED,eAAO,MAAM,sBAAsB,sEACsB,CAAC;AAE1D,wBAAgB,kBAAkB,CAChC,SAAS,GAAG,uBAAuB,KAChC,2BAA2B,CAAC,SAAS,CAAC,CAQ1C;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/dist/lib/runtime-context.js

@@ -0,0 +1,16 @@
+// @bun
+// src/lib/runtime-context.tsx
+import { createContext, useContext } from "react";
+"use client";
+var TemplateRuntimeContext = createContext(null);
+function useTemplateRuntime() {
+  const context = useContext(TemplateRuntimeContext);
+  if (!context) {
+    throw new Error("useTemplateRuntime must be used within a TemplateRuntimeProvider");
+  }
+  return context;
+}
+export {
+  useTemplateRuntime,
+  TemplateRuntimeContext
+};

package/dist/lib/types.d.ts

@@ -0,0 +1,69 @@
+export type TemplateId = string;
+export type TemplateCategory = 'productivity' | 'communication' | 'content' | 'business' | 'ai';
+export type TemplateComplexity = 'beginner' | 'intermediate' | 'advanced';
+export interface TemplateDefinition {
+    id: TemplateId;
+    name: string;
+    description: string;
+    category: TemplateCategory;
+    complexity: TemplateComplexity;
+    icon: string;
+    features: string[];
+    tags: string[];
+    schema: {
+        models: string[];
+        contracts: string[];
+    };
+    components: {
+        list: string;
+        detail: string;
+        form?: string;
+        dashboard?: string;
+    };
+    preview?: {
+        demoUrl?: string;
+        videoUrl?: string;
+    };
+    docs?: {
+        quickstart?: string;
+        reference?: string;
+    };
+    /** Package name for external examples that can be cloned via Git */
+    package?: string;
+    /** Whether this template uses the new cross-cutting modules */
+    usesModules?: string[];
+    /** Feature spec key from the example package */
+    featureSpec?: string;
+    /** List of presentation names available for this template */
+    presentations?: string[];
+    /** List of render targets supported (default: ['react']) */
+    renderTargets?: ('react' | 'markdown' | 'json' | 'xml')[];
+}
+export interface TemplateFilter {
+    category?: TemplateCategory;
+    complexity?: TemplateComplexity;
+    tag?: string;
+}
+export interface InstallTemplateOptions {
+    projectId?: string;
+}
+export interface SaveTemplateOptions {
+    endpoint?: string;
+    token?: string;
+    projectName: string;
+    organizationId: string;
+    templateId: TemplateId;
+}
+export interface SaveTemplateResult {
+    projectId: string;
+    status: string;
+}
+/**
+ * Interface for the TemplateInstaller class.
+ * Mirrors the public API of the implementation in @contractspec/module.examples
+ */
+export interface TemplateInstaller {
+    install(templateId: TemplateId, options?: InstallTemplateOptions): Promise<void>;
+    saveToStudio(options: SaveTemplateOptions): Promise<SaveTemplateResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,eAAe,GACf,SAAS,GACT,UAAU,GACV,IAAI,CAAC;AAET,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;AAE1E,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,CAAC,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC;CAC3D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CACL,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACzE"}

package/dist/lib/types.js

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