@pygmalionjs/pygmalion 0.6.29 → 0.6.30

package/dist-lib/types/App.d.ts

@@ -1,5 +1,8 @@
+import type { DesignCodegenProjectManifest } from './editor/designCompiler';
 export interface AppProps {
     /** The route identity is stable enough to read or produce preview artifacts. */
     previewIdentityReady?: boolean;
+    /** Checked-in host contract used by repository-aware codegen adapters. */
+    codegenProject?: DesignCodegenProjectManifest;
 }
 export declare const App: import("react").FunctionComponent<AppProps>;

package/dist-lib/types/editor/designCompiler.d.ts

@@ -2,6 +2,8 @@ import { type CodegenFrameOptions, type CodegenNode } from './codegen';
 import { type NodeJSON } from './store';
 export declare const DESIGN_IR_SCHEMA: "pygmalion.design-ir";
 export declare const DESIGN_IR_VERSION: 1;
+export declare const DESIGN_CODEGEN_PROJECT_SCHEMA: "pygmalion.codegen-project";
+export declare const DESIGN_CODEGEN_PROJECT_VERSION: 1;
 export type DesignCompilePurpose = 'interactive' | 'export';
 export type DesignCompileSeverity = 'info' | 'warning' | 'error';
 export type DesignCompileStage = 'normalize' | 'analyze' | 'generate' | 'resource';
@@ -43,6 +45,70 @@ export interface DesignIRMetrics {
     componentCount: number;
     assetCount: number;
 }
+/** JSON-shaped host data produced from a repository-owned codegen contract. */
+export type DesignCodegenData = null | string | number | boolean | readonly DesignCodegenData[] | {
+    readonly [key: string]: DesignCodegenData;
+};
+export interface DesignCodegenPromptReference {
+    /** Repository-relative agent instruction file used to author this manifest. */
+    sourcePath: string;
+    /** Host-owned revision bumped when the instructions or output contract change. */
+    revision: string;
+}
+export interface DesignCodegenFrameContract {
+    /** Canonical source anchors chosen by the host, in addition to observed files. */
+    sourcePaths?: readonly string[];
+    /** Adapter-specific, deterministic metadata. It is never interpreted by core. */
+    metadata?: Readonly<Record<string, DesignCodegenData>>;
+}
+/**
+ * Checked-in output of a repository's codegen instructions.
+ *
+ * The prompt is provenance, not a runtime dependency: adapters consume this
+ * manifest synchronously and never call a model while the editor is open.
+ */
+export interface DesignCodegenProjectManifest {
+    schema: typeof DESIGN_CODEGEN_PROJECT_SCHEMA;
+    version: typeof DESIGN_CODEGEN_PROJECT_VERSION;
+    defaultTarget?: string;
+    prompt?: DesignCodegenPromptReference;
+    frames?: Readonly<Record<string, DesignCodegenFrameContract>>;
+}
+export interface DesignCodegenPageContext {
+    /** Canonical import id when available, otherwise the editor-local page id. */
+    id: string;
+    name: string;
+    route?: string;
+    previewRoute?: string;
+    sourcePaths: readonly string[];
+    flow?: string;
+    scenario?: string;
+    state?: string;
+    stateKind?: string;
+    scenarioId?: string;
+    scenarioIds: readonly string[];
+    desiredState?: Readonly<Record<string, DesignCodegenData>>;
+    /** Current reproducible recipe; direct state stays separate for easy adapters. */
+    capture: {
+        environment?: DesignCodegenData;
+        preset?: DesignCodegenData;
+        interactions: readonly DesignCodegenData[];
+        assertions: readonly DesignCodegenData[];
+    };
+    interactiveStateId?: string;
+    interactiveOptionId?: string;
+    interactiveOptionIds?: readonly string[];
+    viewport: {
+        width: number;
+        height: number;
+    };
+    /** Frame-specific checked-in contract selected by id. */
+    contract?: DesignCodegenFrameContract;
+}
+export interface DesignCodegenRuntimeContext {
+    page?: DesignCodegenPageContext;
+    project?: DesignCodegenProjectManifest;
+}
 export interface DesignIntermediateDocumentV1 {
     schema: typeof DESIGN_IR_SCHEMA;
     version: typeof DESIGN_IR_VERSION;
@@ -61,7 +127,7 @@ export interface DesignCompileLimits {
     maxOutputBytes: number;
 }
 export declare const DEFAULT_DESIGN_COMPILE_LIMITS: Readonly<DesignCompileLimits>;
-export interface DesignCodegenAdapterContext {
+export interface DesignCodegenAdapterContext extends DesignCodegenRuntimeContext {
     document: DesignIntermediateDocumentV1;
 }
 export interface DesignCodegenAdapterOutput {
@@ -73,6 +139,13 @@ export interface DesignCodegenAdapter {
     label: string;
     language: string;
     extension: string;
+    /**
+     * Repository adapters generate from checked-in source contracts rather than
+     * approximating the captured design tree. They still receive the document
+     * for source-map context, but design-IR warnings and preview size deferral do
+     * not describe their output.
+     */
+    basis?: 'design-ir' | 'repository';
     generate(context: DesignCodegenAdapterContext): string | DesignCodegenAdapterOutput;
 }
 export interface DesignCompileOptions {
@@ -81,6 +154,8 @@ export interface DesignCompileOptions {
     force?: boolean;
     frame?: CodegenFrameOptions;
     limits?: Partial<DesignCompileLimits>;
+    /** Current repository frame and checked-in codegen contract for host adapters. */
+    context?: DesignCodegenRuntimeContext;
 }
 export interface DesignCompileResult {
     target: string;

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

@@ -18,6 +18,7 @@ import type { StoryboardDefinition } from './editor/storyboardGraph';
 import { type TokenDef } from './editor/tokens';
 import { type ViewportPresetDef } from './editor/viewportPresets';
 import { type PreviewEnvironmentControlDef } from './editor/previewEnvironmentControls';
+import type { DesignCodegenProjectManifest } from './editor/designCompiler';
 
 export { setComponentRegistry } from './editor/registry';
 export { PYGMALION_PREVIEW_CAPTURE_PROGRESS_SUFFIX, previewCaptureProgressEndpoint, usePygmalionPreviewCaptureProgress, } from './editor/previewCaptureProgress';
@@ -27,8 +28,8 @@ export type { FrameInteractionPhase, FrameInteractionScrollState, FrameInteracti
 export type { ComponentRegistry, RegistryEntry, RegistryPropValue, } from './editor/registry';
 export { enumerateDesignComponentConnectionCases, getDesignComponentConnection, getDesignComponentConnectionForComponent, getDesignComponentConnections, setDesignComponentConnections, validateDesignComponentConnections, } from './editor/componentConnections';
 export type { DesignComponentConnectionCase, DesignComponentConnectionCases, DesignComponentConnectionDef, DesignComponentReference, DesignConnectionDiagnostic, DesignConnectionPropertyDef, DesignConnectionPropertyKind, } from './editor/componentConnections';
-export { compileDesignDocument, createDesignIntermediateDocument, DEFAULT_DESIGN_COMPILE_LIMITS, DESIGN_IR_SCHEMA, DESIGN_IR_VERSION, getDesignCodegenAdapters, registerDesignCodegenAdapter, } from './editor/designCompiler';
-export type { DesignCodegenAdapter, DesignCodegenAdapterContext, DesignCodegenAdapterOutput, DesignCompileDiagnostic, DesignCompileLimits, DesignCompileOptions, DesignCompilePurpose, DesignCompileResult, DesignCompileSeverity, DesignCompileStage, DesignCompileStatus, DesignIntermediateDocumentV1, DesignIRAsset, DesignIRComponent, DesignIRMetrics, } from './editor/designCompiler';
+export { compileDesignDocument, createDesignIntermediateDocument, DEFAULT_DESIGN_COMPILE_LIMITS, DESIGN_CODEGEN_PROJECT_SCHEMA, DESIGN_CODEGEN_PROJECT_VERSION, DESIGN_IR_SCHEMA, DESIGN_IR_VERSION, getDesignCodegenAdapters, registerDesignCodegenAdapter, } from './editor/designCompiler';
+export type { DesignCodegenAdapter, DesignCodegenAdapterContext, DesignCodegenAdapterOutput, DesignCodegenData, DesignCodegenFrameContract, DesignCodegenPageContext, DesignCodegenProjectManifest, DesignCodegenPromptReference, DesignCodegenRuntimeContext, DesignCompileDiagnostic, DesignCompileLimits, DesignCompileOptions, DesignCompilePurpose, DesignCompileResult, DesignCompileSeverity, DesignCompileStage, DesignCompileStatus, DesignIntermediateDocumentV1, DesignIRAsset, DesignIRComponent, DesignIRMetrics, } from './editor/designCompiler';
 export type { CodegenFrameOptions } from './editor/codegen';
 export { createDesignComponentCatalog, createDesignComponentVariantMatrix, createDesignGalleryCatalog, designCatalogKey, designCatalogRegistryName, PygmalionCatalogDocument, PygmalionCatalogMatrix, PygmalionCatalogSection, } from './editor/catalog';
 export type { DesignCatalogBuild, DesignCatalogFrame, DesignCatalogItem, DesignCatalogKind, DesignCatalogPageDescriptor, DesignComponentCatalogOptions, DesignComponentVariantMatrix, DesignGalleryCatalogOptions, PygmalionCatalogDocumentProps, PygmalionCatalogMatrixProps, PygmalionCatalogSectionProps, } from './editor/catalog';
@@ -281,7 +282,7 @@ export declare function pygmalionOpenPreview(): void;
 export declare function pygmalionResetCurrentEdits(): boolean;
 export interface InitialPageDef extends DesignImportInitialPage {
 }
-export declare function PygmalionEditor({ registry, tokens, initialPages, initialCanvas, initialEditMode, componentConnections, viewportPresets, sessionPresets, previewEnvironmentControls, designImport, onTokensChange, appOrigin, previewRevision, previewCacheNamespace, previewArtifacts, previewArtifactEndpoint, previewConcurrency, previewOpen, onPreviewOpenChange, flowCanvas, frameSurface, captureSupply, screenFlows, screenFlowConcurrency, scenarioCoverage, screenDimensions, screenLists, sectionHeaders, sectionHeaderLabels, screenLanes, frameBranchKinds, frameLabelLabels, screenCards, liveScreenBudget, screenStateAxes, interactiveStates, surfaceClassifications, onApply, onDesignChange, onInspectApply, onInspectPreview, onInspectImpact, storyboard, storyboardScenarios, sessionStoryboards, storyboardDiscovery, storyboardDiscoveryEndpoint, }: {
+export declare function PygmalionEditor({ registry, tokens, initialPages, initialCanvas, initialEditMode, componentConnections, codegenProject, viewportPresets, sessionPresets, previewEnvironmentControls, designImport, onTokensChange, appOrigin, previewRevision, previewCacheNamespace, previewArtifacts, previewArtifactEndpoint, previewConcurrency, previewOpen, onPreviewOpenChange, flowCanvas, frameSurface, captureSupply, screenFlows, screenFlowConcurrency, scenarioCoverage, screenDimensions, screenLists, sectionHeaders, sectionHeaderLabels, screenLanes, frameBranchKinds, frameLabelLabels, screenCards, liveScreenBudget, screenStateAxes, interactiveStates, surfaceClassifications, onApply, onDesignChange, onInspectApply, onInspectPreview, onInspectImpact, storyboard, storyboardScenarios, sessionStoryboards, storyboardDiscovery, storyboardDiscoveryEndpoint, }: {
     registry?: ComponentRegistry;
     tokens?: TokenDef[];
     initialPages?: InitialPageDef[];
@@ -296,6 +297,11 @@ export declare function PygmalionEditor({ registry, tokens, initialPages, initia
     initialEditMode?: 'edit' | 'view-only';
     /** Explicit external-design to registered-code component mappings. */
     componentConnections?: readonly DesignComponentConnectionDef[];
+    /**
+     * Checked-in repository contract for deterministic, state-aware codegen.
+     * Its prompt reference is provenance only; no model runs in the editor.
+     */
+    codegenProject?: DesignCodegenProjectManifest;
     /** Named frame widths the application supports — rendered as one-click buttons beside the W/H boxes. */
     viewportPresets?: readonly ViewportPresetDef[];
     /**

package/dist-lib/types/shell/CodePanel.d.ts

@@ -1 +1,4 @@
-export declare const CodePanel: import("react").FunctionComponent<object>;
+import { type DesignCodegenProjectManifest } from '../editor/designCompiler';
+export declare const CodePanel: import("react").FunctionComponent<{
+    codegenProject?: DesignCodegenProjectManifest;
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pygmalionjs/pygmalion",
-  "version": "0.6.29",
+  "version": "0.6.30",
   "description": "Code-backed DOM design sandbox and visual QA editor",
   "license": "UNLICENSED",
   "publishConfig": {