@process.co/element-types 0.0.8 → 0.0.9

package/dist/materialize-authoring-from-cli-output.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildProcessActionFern = buildProcessActionFern;
+exports.buildProcessSignalFern = buildProcessSignalFern;
+exports.materializeAuthoringCatalogFromCliOutput = materializeAuthoringCatalogFromCliOutput;
+const materialize_slot_definition_1 = require("./materialize-slot-definition");
+function stripNamespacePrefixFromActionKey(namespace, key) {
+    const prefix = `${namespace}-`;
+    return key.startsWith(prefix) ? key.slice(prefix.length) : key;
+}
+/**
+ * Build registry FERN for an action (**`namespace::action:slug`**), matching common API normalization.
+ */
+function buildProcessActionFern(namespace, actionKey) {
+    const slug = stripNamespacePrefixFromActionKey(namespace, actionKey);
+    return `${namespace}::action:${slug}`;
+}
+/** Build registry FERN for a signal (**`namespace::signal:slug`**). */
+function buildProcessSignalFern(namespace, signalKey) {
+    const slug = stripNamespacePrefixFromActionKey(namespace, signalKey);
+    return `${namespace}::signal:${slug}`;
+}
+function wireTypeLabel(type) {
+    if (type === undefined || type === null) {
+        return 'unknown';
+    }
+    if (typeof type === 'string') {
+        return type;
+    }
+    try {
+        return JSON.stringify(type);
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function materializeProp(p) {
+    return {
+        key: p.key,
+        label: p.label,
+        description: typeof p.description === 'string' ? p.description : '',
+        wireType: wireTypeLabel(p.type),
+        required: p.required === true,
+        hasJsonType: p.jsonType !== undefined && p.jsonType !== null,
+        isFunction: p.isFunction === true,
+    };
+}
+function materializeAction(namespace, a) {
+    const fern = buildProcessActionFern(namespace, a.key);
+    return {
+        kind: 'action',
+        fern,
+        elementKey: a.key,
+        name: a.name,
+        description: typeof a.description === 'string' ? a.description : undefined,
+        returns: typeof a.returns === 'string' ? a.returns : undefined,
+        props: (Array.isArray(a.props) ? a.props : []).map(materializeProp),
+        slots: (0, materialize_slot_definition_1.materializeSlotDefinition)(a.slots),
+    };
+}
+function materializeSignal(namespace, s) {
+    const fern = buildProcessSignalFern(namespace, s.key);
+    return {
+        kind: 'signal',
+        fern,
+        elementKey: s.key,
+        name: s.name,
+        description: typeof s.description === 'string' ? s.description : undefined,
+        returns: typeof s.returns === 'string' ? s.returns : undefined,
+        props: (Array.isArray(s.props) ? s.props : []).map(materializeProp),
+    };
+}
+/**
+ * Turn the **entire compatibility CLI / `loadElementPointers` JSON** into FERN-keyed authoring material
+ * (props + slot paths + returns hints) for codegen or merging into **`@process.co/workflow-sdk`**.
+ *
+ * @param namespace — FERN namespace segment (e.g. **`process-internal`**). Defaults to **`info.name`** (element app slug).
+ */
+function materializeAuthoringCatalogFromCliOutput(info, namespace) {
+    const ns = namespace ?? info.name;
+    const actionsByFern = {};
+    const signalsByFern = {};
+    for (const a of info.actions) {
+        if (a?.type !== 'action' || typeof a.key !== 'string') {
+            continue;
+        }
+        const entry = materializeAction(ns, a);
+        actionsByFern[entry.fern] = entry;
+    }
+    for (const s of info.signals) {
+        if (s?.type !== 'signal' || typeof s.key !== 'string') {
+            continue;
+        }
+        const entry = materializeSignal(ns, s);
+        signalsByFern[entry.fern] = entry;
+    }
+    return { namespace: ns, actionsByFern, signalsByFern };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWF0ZXJpYWxpemUtYXV0aG9yaW5nLWZyb20tY2xpLW91dHB1dC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9tYXRlcmlhbGl6ZS1hdXRob3JpbmctZnJvbS1jbGktb3V0cHV0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBdURBLHdEQUdDO0FBR0Qsd0RBR0M7QUFtRUQsNEZBeUJDO0FBNUpELCtFQUEyRztBQStDM0csU0FBUyxpQ0FBaUMsQ0FBQyxTQUFpQixFQUFFLEdBQVc7SUFDdkUsTUFBTSxNQUFNLEdBQUcsR0FBRyxTQUFTLEdBQUcsQ0FBQztJQUMvQixPQUFPLEdBQUcsQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUM7QUFDakUsQ0FBQztBQUVEOztHQUVHO0FBQ0gsU0FBZ0Isc0JBQXNCLENBQUMsU0FBaUIsRUFBRSxTQUFpQjtJQUN6RSxNQUFNLElBQUksR0FBRyxpQ0FBaUMsQ0FBQyxTQUFTLEVBQUUsU0FBUyxDQUFDLENBQUM7SUFDckUsT0FBTyxHQUFHLFNBQVMsWUFBWSxJQUFJLEVBQUUsQ0FBQztBQUN4QyxDQUFDO0FBRUQsdUVBQXVFO0FBQ3ZFLFNBQWdCLHNCQUFzQixDQUFDLFNBQWlCLEVBQUUsU0FBaUI7SUFDekUsTUFBTSxJQUFJLEdBQUcsaUNBQWlDLENBQUMsU0FBUyxFQUFFLFNBQVMsQ0FBQyxDQUFDO0lBQ3JFLE9BQU8sR0FBRyxTQUFTLFlBQVksSUFBSSxFQUFFLENBQUM7QUFDeEMsQ0FBQztBQUVELFNBQVMsYUFBYSxDQUFDLElBQWE7SUFDbEMsSUFBSSxJQUFJLEtBQUssU0FBUyxJQUFJLElBQUksS0FBSyxJQUFJLEVBQUUsQ0FBQztRQUN4QyxPQUFPLFNBQVMsQ0FBQztJQUNuQixDQUFDO0lBQ0QsSUFBSSxPQUFPLElBQUksS0FBSyxRQUFRLEVBQUUs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

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.8",
+  "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;