@process.co/element-types 0.0.8 → 0.0.10

package/dist/materialize-authoring-from-cli-output.d.ts

@@ -0,0 +1,51 @@
+import { type MaterializedSlotDefinition } from './materialize-slot-definition';
+import type { ProcessElementCliOutputWire } from './process-element-cli-output';
+export type MaterializedPropAuthoring = {
+    key: string;
+    label: string;
+    description: string;
+    /** String from loader **`type`** (e.g. **`string`**, **`object`**, or zodex-serialized object as JSON). */
+    wireType: string;
+    required: boolean;
+    hasJsonType: boolean;
+    isFunction: boolean;
+};
+export type MaterializedActionAuthoringEntry = {
+    kind: 'action';
+    fern: string;
+    /** Raw action key from the element (may include namespace prefix). */
+    elementKey: string;
+    name: string;
+    description?: string;
+    returns?: string;
+    props: MaterializedPropAuthoring[];
+    slots: MaterializedSlotDefinition | null;
+};
+export type MaterializedSignalAuthoringEntry = {
+    kind: 'signal';
+    fern: string;
+    elementKey: string;
+    name: string;
+    description?: string;
+    returns?: string;
+    props: MaterializedPropAuthoring[];
+};
+export type MaterializedAuthoringCatalog = {
+    namespace: string;
+    actionsByFern: Record<string, MaterializedActionAuthoringEntry>;
+    signalsByFern: Record<string, MaterializedSignalAuthoringEntry>;
+};
+/**
+ * Build registry FERN for an action (**`namespace::action:slug`**), matching common API normalization.
+ */
+export declare function buildProcessActionFern(namespace: string, actionKey: string): string;
+/** Build registry FERN for a signal (**`namespace::signal:slug`**). */
+export declare function buildProcessSignalFern(namespace: string, signalKey: string): string;
+/**
+ * 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).
+ */
+export declare function materializeAuthoringCatalogFromCliOutput(info: ProcessElementCliOutputWire, namespace?: string): MaterializedAuthoringCatalog;
+//# sourceMappingURL=materialize-authoring-from-cli-output.d.ts.map

package/dist/materialize-authoring-from-cli-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-authoring-from-cli-output.d.ts","sourceRoot":"","sources":["../src/materialize-authoring-from-cli-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3G,OAAO,KAAK,EAEV,2BAA2B,EAG5B,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,yBAAyB,GAAG;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,2GAA2G;IAC3G,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACnC,KAAK,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;IAChE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;CACjE,CAAC;AAOF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGnF;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGnF;AA6DD;;;;;GAKG;AACH,wBAAgB,wCAAwC,CACtD,IAAI,EAAE,2BAA2B,EACjC,SAAS,CAAC,EAAE,MAAM,GACjB,4BAA4B,CAsB9B"}

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/platform-loader-type.d.ts

@@ -0,0 +1,11 @@
+/**
+ * **`prop.type`** string prefixes that bind to runtime platform implementations
+ * (**`$.interface.http`**, **`$.service.db`**, **`$.interface.timer`**, …).
+ *
+ * Keep in sync with:
+ * - **`@process.co/compatibility`** authoring registry (**`excludeFromAuthoringInstanceShape`**)
+ * - **`apps/web`** expression validation / console (skip misleading type-mismatch noise)
+ */
+export declare const PLATFORM_BOUND_LOADER_TYPE_PREFIXES: readonly ["$.interface.", "$.service."];
+export declare function isPlatformBoundLoaderType(type: string): boolean;
+//# sourceMappingURL=platform-loader-type.d.ts.map

package/dist/platform-loader-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-loader-type.d.ts","sourceRoot":"","sources":["../src/platform-loader-type.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,mCAAmC,yCAA0C,CAAC;AAE3F,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG/D"}

package/dist/platform-loader-type.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLATFORM_BOUND_LOADER_TYPE_PREFIXES = void 0;
+exports.isPlatformBoundLoaderType = isPlatformBoundLoaderType;
+/**
+ * **`prop.type`** string prefixes that bind to runtime platform implementations
+ * (**`$.interface.http`**, **`$.service.db`**, **`$.interface.timer`**, …).
+ *
+ * Keep in sync with:
+ * - **`@process.co/compatibility`** authoring registry (**`excludeFromAuthoringInstanceShape`**)
+ * - **`apps/web`** expression validation / console (skip misleading type-mismatch noise)
+ */
+exports.PLATFORM_BOUND_LOADER_TYPE_PREFIXES = ['$.interface.', '$.service.'];
+function isPlatformBoundLoaderType(type) {
+    const t = type.trim();
+    return exports.PLATFORM_BOUND_LOADER_TYPE_PREFIXES.some((p) => t.startsWith(p));
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGxhdGZvcm0tbG9hZGVyLXR5cGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvcGxhdGZvcm0tbG9hZGVyLXR5cGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBVUEsOERBR0M7QUFiRDs7Ozs7OztHQU9HO0FBQ1UsUUFBQSxtQ0FBbUMsR0FBRyxDQUFDLGNBQWMsRUFBRSxZQUFZLENBQVUsQ0FBQztBQUUzRixTQUFnQix5QkFBeUIsQ0FBQyxJQUFZO0lBQ3BELE1BQU0sQ0FBQyxHQUFHLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUN0QixPQUFPLDJDQUFtQyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO0FBQzFFLENBQUMifQ==

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.10",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/authoring-contract-types.ts

@@ -0,0 +1,132 @@
+/**
+ * Locked authoring contract **types only** (published for partners).
+ * Runtime: **`@process.co/compatibility`** **`authoring-spec`** — **`authoringCatalogContractFromCliOutput`**, **`materializeAuthoringCatalogFromCliOutput`**, etc.
+ */
+
+/**
+ * Bump when this contract changes — regenerate **`@process.co/elements`** **`generate:authoring`** and other 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;
+  /**
+   * When true, the prop is **not** part of the user instance payload (e.g. loader **`type`** is
+   * **`$.interface.http`** / **`$.service.db`** — runtime-injected). Merged **`GeneratedAuthoringStepPropsByFern`**
+   * emission skips these keys.
+   */
+  readonly excludeFromAuthoringInstanceShape?: 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: **`@process.co/compatibility`** **`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];
+
+/**
+ * **Early** artifact: one file per element / integration build, written by **`@process.co/compatibility`**.
+ * **Late** step merges many shards (any mix of **`--dir` / `--shard` / `--cli` / `--bundle`**) into **one** file:
+ * **`@process.co/elements`** **`src/generated/authoring-registry.merged.ts`** — merged inference types; contract JSON stays in shards / bundles.
+ * **FERN keys must be unique across the merged set**; duplicates are a merge conflict (tooling should pick one winner).
+ * Payload is **contract-only** (**`wireKind`**, slots metadata) — not full persisted editor **`data.data`** shapes.
+ */
+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>;
+};