@process.co/element-types 0.0.7 → 0.0.9

package/dist/materialize-slot-definition.d.ts

@@ -0,0 +1,32 @@
+import type { ISlotDefinition } from './slot-definition';
+export type MaterializedSlotBranch = {
+    kind: 'static' | 'dynamic';
+    id?: string;
+    label?: string;
+    branchValue?: string;
+    path?: string;
+    idPath?: string;
+    labelPath?: string;
+    enabledPath?: string;
+    actionsPath?: string;
+    exportsPath?: string;
+    hideOnDisable?: boolean;
+    labelPlaceholderTemplate?: string;
+    labelPlaceholderValue?: string;
+};
+export type MaterializedSlotLayout = {
+    showBranchLabels?: boolean;
+    activeSlotId?: string;
+    activeSlotLabel?: string;
+    hideDisabled?: boolean;
+    hideDisabledPath?: string;
+    hideOnDisable?: boolean;
+    exportSchemaPath?: string;
+};
+export type MaterializedSlotDefinition = {
+    layout: MaterializedSlotLayout;
+    branches: MaterializedSlotBranch[];
+};
+/** Normalize **`ISlotDefinition`** for codegen / workflow inference (JSON-serializable). */
+export declare function materializeSlotDefinition(def: ISlotDefinition | null | undefined): MaterializedSlotDefinition | null;
+//# sourceMappingURL=materialize-slot-definition.d.ts.map

package/dist/materialize-slot-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-slot-definition.d.ts","sourceRoot":"","sources":["../src/materialize-slot-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CACpC,CAAC;AAyCF,4FAA4F;AAC5F,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACtC,0BAA0B,GAAG,IAAI,CAQnC"}

package/dist/materialize-slot-definition.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.materializeSlotDefinition = materializeSlotDefinition;
+function branchKind(row) {
+    return 'type' in row && row.type === 'static' ? 'static' : 'dynamic';
+}
+function pickBranch(row) {
+    const b = { kind: branchKind(row) };
+    if (row.id !== undefined)
+        b.id = row.id;
+    if (row.label !== undefined)
+        b.label = row.label;
+    if (row.branchValue !== undefined)
+        b.branchValue = row.branchValue;
+    if (row.path !== undefined)
+        b.path = row.path;
+    if (row.idPath !== undefined)
+        b.idPath = row.idPath;
+    if (row.labelPath !== undefined)
+        b.labelPath = row.labelPath;
+    if (row.enabledPath !== undefined)
+        b.enabledPath = row.enabledPath;
+    if (row.actionsPath !== undefined)
+        b.actionsPath = row.actionsPath;
+    if (row.exportsPath !== undefined)
+        b.exportsPath = row.exportsPath;
+    if (row.hideOnDisable !== undefined)
+        b.hideOnDisable = row.hideOnDisable;
+    if (row.labelPlaceholderTemplate !== undefined)
+        b.labelPlaceholderTemplate = row.labelPlaceholderTemplate;
+    if (row.labelPlaceholderValue !== undefined)
+        b.labelPlaceholderValue = row.labelPlaceholderValue;
+    return b;
+}
+function pickLayout(def) {
+    const layout = {};
+    if (def.showBranchLabels !== undefined)
+        layout.showBranchLabels = def.showBranchLabels;
+    if (def.activeSlotId !== undefined)
+        layout.activeSlotId = def.activeSlotId;
+    if (def.activeSlotLabel !== undefined)
+        layout.activeSlotLabel = def.activeSlotLabel;
+    if (def.hideDisabled !== undefined)
+        layout.hideDisabled = def.hideDisabled;
+    if (def.hideDisabledPath !== undefined)
+        layout.hideDisabledPath = def.hideDisabledPath;
+    if (def.hideOnDisable !== undefined)
+        layout.hideOnDisable = def.hideOnDisable;
+    if (def.exportSchemaPath !== undefined)
+        layout.exportSchemaPath = def.exportSchemaPath;
+    return layout;
+}
+function isEffectivelyEmpty(def) {
+    const rows = def.slots ?? [];
+    const layout = pickLayout(def);
+    return rows.length === 0 && Object.keys(layout).length === 0;
+}
+/** Normalize **`ISlotDefinition`** for codegen / workflow inference (JSON-serializable). */
+function materializeSlotDefinition(def) {
+    if (def == null || isEffectivelyEmpty(def)) {
+        return null;
+    }
+    return {
+        layout: pickLayout(def),
+        branches: (def.slots ?? []).map(pickBranch),
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWF0ZXJpYWxpemUtc2xvdC1kZWZpbml0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL21hdGVyaWFsaXplLXNsb3QtZGVmaW5pdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQTZFQSw4REFVQztBQWxERCxTQUFTLFVBQVUsQ0FBQyxHQUE0RDtJQUM5RSxPQUFPLE1BQU0sSUFBSSxHQUFHLElBQUksR0FBRyxDQUFDLElBQUksS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDO0FBQ3ZFLENBQUM7QUFFRCxTQUFTLFVBQVUsQ0FBQyxHQUE0RDtJQUM5RSxNQUFNLENBQUMsR0FBMkIsRUFBRSxJQUFJLEVBQUUsVUFBVSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7SUFDNUQsSUFBSSxHQUFHLENBQUMsRUFBRSxLQUFLLFNBQVM7UUFBRSxDQUFDLENBQUMsRUFBRSxHQUFHLEdBQUcsQ0FBQyxFQUFFLENBQUM7SUFDeEMsSUFBSSxHQUFHLENBQUMsS0FBSyxLQUFLLFNBQVM7UUFBRSxDQUFDLENBQUMsS0FBSyxHQUFHLEdBQUcsQ0FBQyxLQUFLLENBQUM7SUFDakQsSUFBSSxHQUFHLENBQUMsV0FBVyxLQUFLLFNBQVM7UUFBRSxDQUFDLENBQUMsV0FBVyxHQUFHLEdBQUcsQ0FBQyxXQUFXLENBQUM7SUFDbkUsSUFBSSxHQUFHLENBQUMsSUFBSSxLQUFLLFNBQVM7UUFBRSxDQUFDLENBQUMsSUFBSSxHQUFHLEdBQUcsQ0FBQyxJQUFJLENBQUM7SUFDOUMsSUFBSSxHQUFHLENBQUMsTUFBTSxLQUFLLFNBQVM7UUFBRSxDQUFDLENBQUMsTUFBTSxHQUFHLEdBQUcsQ0FBQyxNQUFNLENBQUM7SUFDcEQsSUFBSSxHQUFHLENBQUMsU0FBUyxLQUFLLFNBQVM7UUFBRSxDQUFDLENBQUMsU0FBUyxHQUFHLEdBQUcsQ0FBQyxTQUFTLENBQUM7SUFDN0QsSUFBSSxHQUFHLENBQUMsV0FB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

package/dist/process-element-cli-output.d.ts

@@ -0,0 +1,82 @@
+import type { ISlotDefinition } from './slot-definition';
+/**
+ * One flattened prop row from **`process-co` compatibility `loadElementPointers`** (`buildProp` output).
+ * Matches **`@process.co/elements`** `IProcessDefinitionUIPointers.props[]` plus loader fields.
+ */
+export type ProcessElementPropCliWire = {
+    key: string;
+    label: string;
+    description?: string;
+    type?: unknown;
+    jsonType?: unknown;
+    isFunction?: boolean;
+    required?: boolean;
+    default?: unknown;
+    ui?: string;
+    options?: unknown;
+    deps?: string[];
+    placeholder?: string;
+    [key: string]: unknown;
+};
+/**
+ * One action row from **`loadElementPointers`** for a Process element (not Pipedream shape).
+ * This is what sits in **`IProcessDefinitionUIInfo.actions[]`** after the process loader runs.
+ */
+export type ProcessElementActionCliWire = {
+    type: 'action';
+    key: string;
+    name: string;
+    description?: string;
+    icon?: unknown;
+    ui?: string;
+    categoryKey?: string;
+    sampleEmit?: unknown;
+    returns?: string;
+    slots?: ISlotDefinition;
+    noAuth?: boolean;
+    hasNew?: boolean;
+    initValue?: unknown;
+    props?: ProcessElementPropCliWire[];
+    [key: string]: unknown;
+};
+/**
+ * One signal row from **`loadElementPointers`** for a Process element.
+ */
+export type ProcessElementSignalCliWire = {
+    type: 'signal';
+    key: string;
+    name: string;
+    description?: string;
+    ui?: string;
+    categoryKey?: string;
+    sampleEmit?: unknown;
+    returns?: string;
+    noAuth?: boolean;
+    hasNew?: boolean;
+    initValue?: unknown;
+    icon?: unknown;
+    hooks?: boolean;
+    dedupe?: unknown;
+    http?: unknown;
+    instant?: boolean;
+    props?: ProcessElementPropCliWire[];
+    [key: string]: unknown;
+};
+/**
+ * Full object emitted by **`process-element`** (compatibility CLI): **`SuperJSON.stringify(loadElementPointers(...))`**.
+ * Structurally aligned with **`@process.co/elements` `IProcessDefinitionUIInfo`** plus process-loader fields on each row.
+ */
+export type ProcessElementCliOutputWire = {
+    elementType: 'process' | 'pipedream' | 'dofloV1' | 'n8n';
+    /** App / namespace slug (`element.app`); used as default FERN namespace when building keys. */
+    name: string;
+    description: {
+        short: string;
+        long: string;
+        MD: string;
+    };
+    actions: ProcessElementActionCliWire[];
+    signals: ProcessElementSignalCliWire[];
+    credentials: unknown[];
+};
+//# sourceMappingURL=process-element-cli-output.d.ts.map

package/dist/process-element-cli-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-element-cli-output.d.ts","sourceRoot":"","sources":["../src/process-element-cli-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,CAAC;IACzD,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACvC,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACvC,WAAW,EAAE,OAAO,EAAE,CAAC;CACxB,CAAC"}

package/dist/process-element-cli-output.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvY2Vzcy1lbGVtZW50LWNsaS1vdXRwdXQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvcHJvY2Vzcy1lbGVtZW50LWNsaS1vdXRwdXQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist/slot-definition.d.ts

@@ -0,0 +1,30 @@
+export type ISlotInstanceDefinition = {
+    id?: string;
+    label?: string;
+    enabled?: boolean;
+    path?: string;
+    idPath?: string;
+    labelPath?: string;
+    enabledPath?: string;
+    labelPlaceholderTemplate?: string;
+    labelPlaceholderValue?: string;
+    branchValue?: string;
+    hideOnDisable?: boolean;
+    actionsPath?: string;
+    exportsPath?: string;
+};
+export type ISlotStaticInstanceDefinition = ISlotInstanceDefinition & {
+    type: 'static';
+};
+export type ISlotDefinition = {
+    showBranchLabels?: boolean;
+    activeSlotId?: string;
+    activeSlotLabel?: string;
+    hideDisabled?: boolean;
+    /** Expression/template path for per-row hide-disabled (flow editor / container layout). */
+    hideDisabledPath?: string;
+    hideOnDisable?: boolean;
+    exportSchemaPath?: string;
+    slots?: (ISlotInstanceDefinition | ISlotStaticInstanceDefinition)[];
+};
+//# sourceMappingURL=slot-definition.d.ts.map

package/dist/slot-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-definition.d.ts","sourceRoot":"","sources":["../src/slot-definition.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,uBAAuB,GAAG;IACpE,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,CAAC,uBAAuB,GAAG,6BAA6B,CAAC,EAAE,CAAC;CACrE,CAAC"}

package/dist/slot-definition.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2xvdC1kZWZpbml0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3Nsb3QtZGVmaW5pdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@process.co/element-types",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/authoring-contract.ts

@@ -0,0 +1,243 @@
+import type {
+  MaterializedActionAuthoringEntry,
+  MaterializedAuthoringCatalog,
+  MaterializedSignalAuthoringEntry,
+} from './materialize-authoring-from-cli-output';
+import type { MaterializedSlotBranch, MaterializedSlotDefinition } from './materialize-slot-definition';
+import type { ProcessElementCliOutputWire } from './process-element-cli-output';
+import { materializeAuthoringCatalogFromCliOutput } from './materialize-authoring-from-cli-output';
+
+/**
+ * Bump when this contract changes — regenerate workflow-sdk / codegen consumers.
+ * Raw CLI JSON does not carry this; the **contract** is the stable TS surface.
+ */
+export const ELEMENT_AUTHORING_CONTRACT_VERSION = 1 as const;
+
+/**
+ * Normalized prop kind for **`keyof` / conditional types** (not the raw loader string).
+ */
+export type AuthoringPropWireKind =
+  | 'string'
+  | 'number'
+  | 'boolean'
+  | 'integer'
+  | 'object'
+  | 'array'
+  | 'unknown';
+
+/** One action prop in the **locked** authoring shape. */
+export interface AuthoringPropContract {
+  readonly key: string;
+  readonly label: string;
+  readonly wireKind: AuthoringPropWireKind;
+  readonly required: boolean;
+}
+
+/**
+ * One container branch. **`childStepsProperty`** is intentionally a **string literal type** so
+ * `defineGroup`-style APIs can use `B['childStepsProperty']` and get `'actions'`, not `string`.
+ */
+export interface SlotBranchAuthoringContract {
+  readonly kind: 'static' | 'dynamic';
+  readonly slotRowId?: string;
+  readonly paths: Readonly<{
+    row?: string;
+    id?: string;
+    label?: string;
+    enabled?: string;
+    actions?: string;
+    exports?: string;
+  }>;
+  /**
+   * Where nested steps attach on each branch row, relative to that row’s object.
+   * Locked default **`actions`**; override only if element contract documents otherwise.
+   */
+  readonly childStepsProperty: 'actions';
+  /** Branch-level export callback property when present (e.g. switch **`export`**). */
+  readonly branchExportsProperty?: 'export' | 'exports';
+}
+
+export interface SlotsAuthoringContract {
+  readonly layout: Readonly<{
+    showBranchLabels?: boolean;
+    activeSlotId?: string;
+    activeSlotLabel?: string;
+    hideDisabled?: boolean;
+    hideDisabledPath?: string;
+    hideOnDisable?: boolean;
+    exportSchemaPath?: string;
+  }>;
+  readonly branches: readonly SlotBranchAuthoringContract[];
+}
+
+/** Locked per-action shape for FERN-keyed inference. */
+export interface ActionAuthoringContract {
+  readonly fern: string;
+  readonly elementKey: string;
+  readonly name: string;
+  readonly returnsTypeName?: string;
+  readonly props: readonly AuthoringPropContract[];
+  readonly slots: SlotsAuthoringContract | null;
+}
+
+export interface SignalAuthoringContract {
+  readonly fern: string;
+  readonly elementKey: string;
+  readonly name: string;
+  readonly returnsTypeName?: string;
+  readonly props: readonly AuthoringPropContract[];
+}
+
+/**
+ * **Canonical object** for TypeScript to hang inference off — not the CLI blob.
+ *
+ * - Runtime: **`authoringCatalogContractFromCliOutput`** / **`toAuthoringCatalogContract`**.
+ * - Best inference: codegen emits **`export const X = { … } as const satisfies ElementAuthoringCatalogContract`**
+ *   so **`keyof X['actions']`** is a **union of FERN literals**, not plain **`string`**.
+ */
+export interface ElementAuthoringCatalogContract {
+  readonly version: typeof ELEMENT_AUTHORING_CONTRACT_VERSION;
+  readonly namespace: string;
+  readonly actions: Readonly<Record<string, ActionAuthoringContract>>;
+  readonly signals: Readonly<Record<string, SignalAuthoringContract>>;
+}
+
+// --- Type-level helpers (the “magic” entry points) -------------------------------------------
+
+export type ChildStepsPropertyForBranch<B extends SlotBranchAuthoringContract> = B['childStepsProperty'];
+
+export type ActionPropKeys<A extends ActionAuthoringContract> = A['props'][number]['key'];
+
+export type ActionContractByFern<
+  C extends ElementAuthoringCatalogContract,
+  Fern extends keyof C['actions'] & string,
+> = C['actions'][Fern];
+
+// --- Normalization: materialized → contract ---------------------------------------------------
+
+function normalizeWireKind(wireType: string): AuthoringPropWireKind {
+  const t = wireType.trim().toLowerCase();
+  if (t === 'string' || t === 'number' || t === 'boolean' || t === 'integer') {
+    return t as AuthoringPropWireKind;
+  }
+  if (t === 'object' || t.startsWith('object(')) {
+    return 'object';
+  }
+  if (t === 'array' || t.startsWith('array<')) {
+    return 'array';
+  }
+  return 'unknown';
+}
+
+function inferBranchExportsProperty(branch: MaterializedSlotBranch): 'export' | 'exports' | undefined {
+  const e = branch.exportsPath;
+  if (e === undefined) {
+    return undefined;
+  }
+  if (e.endsWith('.export') || e.includes('.export.')) {
+    return 'export';
+  }
+  if (e.endsWith('.exports') || e.includes('.exports.')) {
+    return 'exports';
+  }
+  return undefined;
+}
+
+function branchToContract(branch: MaterializedSlotBranch): SlotBranchAuthoringContract {
+  const exportsProp = inferBranchExportsProperty(branch);
+  return {
+    kind: branch.kind,
+    slotRowId: branch.id,
+    paths: {
+      row: branch.path,
+      id: branch.idPath,
+      label: branch.labelPath,
+      enabled: branch.enabledPath,
+      actions: branch.actionsPath,
+      exports: branch.exportsPath,
+    },
+    childStepsProperty: 'actions',
+    ...(exportsProp !== undefined ? { branchExportsProperty: exportsProp } : {}),
+  };
+}
+
+function slotsToContract(slots: MaterializedSlotDefinition | null): SlotsAuthoringContract | null {
+  if (slots === null) {
+    return null;
+  }
+  return {
+    layout: { ...slots.layout },
+    branches: slots.branches.map(branchToContract),
+  };
+}
+
+function propToContract(p: { key: string; label: string; wireType: string; required: boolean }): AuthoringPropContract {
+  return {
+    key: p.key,
+    label: p.label,
+    wireKind: normalizeWireKind(p.wireType),
+    required: p.required,
+  };
+}
+
+function actionToContract(a: MaterializedActionAuthoringEntry): ActionAuthoringContract {
+  return {
+    fern: a.fern,
+    elementKey: a.elementKey,
+    name: a.name,
+    returnsTypeName: a.returns,
+    props: a.props.map(propToContract),
+    slots: slotsToContract(a.slots),
+  };
+}
+
+function signalToContract(s: MaterializedSignalAuthoringEntry): SignalAuthoringContract {
+  return {
+    fern: s.fern,
+    elementKey: s.elementKey,
+    name: s.name,
+    returnsTypeName: s.returns,
+    props: s.props.map(propToContract),
+  };
+}
+
+/**
+ * Map **loose materialized catalog** (from CLI JSON) into the **locked `ElementAuthoringCatalogContract`**.
+ */
+export function toAuthoringCatalogContract(cat: MaterializedAuthoringCatalog): ElementAuthoringCatalogContract {
+  const actions: Record<string, ActionAuthoringContract> = {};
+  const signals: Record<string, SignalAuthoringContract> = {};
+  for (const [fern, a] of Object.entries(cat.actionsByFern)) {
+    actions[fern] = actionToContract(a);
+  }
+  for (const [fern, s] of Object.entries(cat.signalsByFern)) {
+    signals[fern] = signalToContract(s);
+  }
+  return {
+    version: ELEMENT_AUTHORING_CONTRACT_VERSION,
+    namespace: cat.namespace,
+    actions,
+    signals,
+  };
+}
+
+/** One-shot: **`process-element` JSON shape** → locked contract. */
+export function authoringCatalogContractFromCliOutput(
+  info: ProcessElementCliOutputWire,
+  namespace?: string,
+): ElementAuthoringCatalogContract {
+  return toAuthoringCatalogContract(materializeAuthoringCatalogFromCliOutput(info, namespace));
+}
+
+/**
+ * **Early** artifact: one file per element / build, written by **`@process.co/compatibility`**.
+ * **Late** step merges many shards into **`workflow-sdk`** `fern-authoring-registry.generated.ts`.
+ */
+export type FernAuthoringShardFileV1 = {
+  readonly version: typeof ELEMENT_AUTHORING_CONTRACT_VERSION;
+  /** Source path or id (optional, for debugging). */
+  readonly source?: string;
+  readonly namespace: string;
+  readonly actions: Record<string, ActionAuthoringContract>;
+  readonly signals: Record<string, SignalAuthoringContract>;
+};

package/src/builtin-action-slots-registry.ts

@@ -0,0 +1,36 @@
+import type { ISlotDefinition } from './slot-definition';
+
+/**
+ * Optional bootstrap registry (FERN → **`ISlotDefinition`**).
+ * Prefer driving inference from **`materializeAuthoringCatalogFromCliOutput`** on the full
+ * **`process-element` / `loadElementPointers`** JSON — that includes **props**, **returns**, and **slots**.
+ */
+export const builtinActionSlotsRegistry = {
+  'process-internal::action:switch': {
+    hideDisabled: true,
+    slots: [
+      {
+        type: 'static' as const,
+        id: '{{ID_GUID}}_default_case',
+        labelPath: '$.data.cases.defaultLabel',
+        enabledPath: '$.data.cases.defaultEnabled',
+        hideOnDisable: true,
+      },
+      {
+        path: '$.data.cases.cases[*]',
+        idPath: '$.data.cases.cases[*].id',
+        labelPath: '$.data.cases.cases[*].label',
+        enabledPath: '$.data.cases.cases[*].enabled',
+        hideOnDisable: true,
+      },
+    ],
+  } satisfies ISlotDefinition,
+} as const;
+
+export type BuiltinActionSlotsRegistry = typeof builtinActionSlotsRegistry;
+
+export type BuiltinActionSlotsFern = keyof BuiltinActionSlotsRegistry;
+
+export type InferBuiltinActionSlots<Fern extends string> = Fern extends BuiltinActionSlotsFern
+  ? BuiltinActionSlotsRegistry[Fern]
+  : undefined;

package/src/index.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 import type { z } from 'zod';
 
 // Element types
@@ -15,32 +16,67 @@ export type ElementSignal<T> = { type: "signal"; icon?: ElementIcon; label?: str
 
 export type ElementIcon = { type: "FontAwesome" | "MaterialIcons" | "ProcessIcons" | "RemoteImage" | "image"; icon: string | ['far' | 'fas' | 'fab' | 'fal' | 'fad', string] } | string;
 
-export type ISlotInstanceDefinition = {
-    id?: string;
-    label?: string;
-    enabled?: boolean;
-    path?: string;
-    idPath?: string;
-    labelPath?: string;
-    enabledPath?: string;
-    labelPlaceholderTemplate?: string;
-    labelPlaceholderValue?: string;
-    branchValue?: string;
-    hideOnDisable?: boolean;
-}
-
-export type ISlotStaticInstanceDefinition = ISlotInstanceDefinition & {
-    type: "static";
-}
-
-export type ISlotDefinition = {
-    showBranchLabels?: boolean;
-    activeSlotId?: string;
-    activeSlotLabel?: string;
-    hideDisabled?: boolean;
-    hideOnDisable?: boolean;
-    slots?: (ISlotInstanceDefinition | ISlotStaticInstanceDefinition)[];
-}
+import type {
+    ISlotInstanceDefinition,
+    ISlotStaticInstanceDefinition,
+    ISlotDefinition,
+} from './slot-definition';
+
+export type { ISlotInstanceDefinition, ISlotStaticInstanceDefinition, ISlotDefinition };
+
+export {
+    builtinActionSlotsRegistry,
+    type BuiltinActionSlotsRegistry,
+    type BuiltinActionSlotsFern,
+    type InferBuiltinActionSlots,
+} from './builtin-action-slots-registry';
+
+/** Full **`process-element` CLI** JSON shape + materializer for FERN-keyed props/slots (workflow-sdk / codegen). */
+export type {
+    ProcessElementPropCliWire,
+    ProcessElementActionCliWire,
+    ProcessElementSignalCliWire,
+    ProcessElementCliOutputWire,
+} from './process-element-cli-output';
+
+export type {
+    MaterializedSlotBranch,
+    MaterializedSlotLayout,
+    MaterializedSlotDefinition,
+} from './materialize-slot-definition';
+export { materializeSlotDefinition } from './materialize-slot-definition';
+
+export type {
+    MaterializedPropAuthoring,
+    MaterializedActionAuthoringEntry,
+    MaterializedSignalAuthoringEntry,
+    MaterializedAuthoringCatalog,
+} from './materialize-authoring-from-cli-output';
+export {
+    buildProcessActionFern,
+    buildProcessSignalFern,
+    materializeAuthoringCatalogFromCliOutput,
+} from './materialize-authoring-from-cli-output';
+
+/** Locked authoring catalog + helpers for FERN / slot / prop inference (not raw CLI JSON). */
+export {
+    ELEMENT_AUTHORING_CONTRACT_VERSION,
+    toAuthoringCatalogContract,
+    authoringCatalogContractFromCliOutput,
+} from './authoring-contract';
+export type {
+    AuthoringPropWireKind,
+    AuthoringPropContract,
+    SlotBranchAuthoringContract,
+    SlotsAuthoringContract,
+    ActionAuthoringContract,
+    SignalAuthoringContract,
+    ElementAuthoringCatalogContract,
+    ChildStepsPropertyForBranch,
+    ActionPropKeys,
+    ActionContractByFern,
+    FernAuthoringShardFileV1,
+} from './authoring-contract';
 
 // Base types for module definitions
 export type ModuleDefinition = {
@@ -623,4 +659,4 @@ export type WithThis<T> = T extends { methods: Record<string, any>; props: Recor
             : T['methods'][K];
         };
     }
-    : T; 
+    : T;