@owlmeans/planning 0.1.18-rc.9 → 0.1.18

package/build/helpers/apply.js

@@ -1,162 +1,145 @@
-import { IntrinsicStatus, TransitionAction } from '../consts.js';
+import { IntrinsicStatus, PlanningResourceKind, TransitionAction } from '../consts.js';
 import { PlanningError } from '../errors.js';
-/** Never written by a transition's `changes`: the fold takes them from the transition itself. */
-const IDENTITY_KEYS = new Set(['id', 'kind', 'type', 'entityId', 'seq', 'head', 'createdAt']);
-/** Cannot be cleared: a record without them is not a record. */
-const REQUIRED_KEYS = new Set([
-    ...IDENTITY_KEYS, 'title', 'parents', 'status', 'intrinsic', 'flows', 'labels', 'fields',
-]);
-/** Merged shallowly into the card's own map rather than replacing it. */
-const MERGED_KEYS = new Set(['fields', 'flows']);
+import { IDENTITY_KEYS, MERGED_KEYS, REQUIRED_KEYS } from './apply/consts.local.js';
 const clean = (record) => Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
-const outOfOrder = (card, transition) => new PlanningError(`fold:out-of-order:${transition.card}:${card?.seq ?? 0}:${transition.seq}`);
-const unsetOn = (record, paths) => {
-    for (const path of paths ?? []) {
-        const dot = path.indexOf('.');
-        if (dot > 0) {
-            const head = path.slice(0, dot);
-            const map = record[head];
-            if (MERGED_KEYS.has(head) && map != null && typeof map === 'object') {
-                delete map[path.slice(dot + 1)];
+export const createApplyHelper = () => {
+    const outOfOrder = (card, transition) => new PlanningError(`fold:out-of-order:${transition.card}:${card?.seq ?? 0}:${transition.seq}`);
+    const unsetOn = (record, paths) => {
+        for (const path of paths ?? []) {
+            const dot = path.indexOf('.');
+            if (dot > 0) {
+                const head = path.slice(0, dot);
+                const map = record[head];
+                if (MERGED_KEYS.has(head) && map != null && typeof map === 'object') {
+                    delete map[path.slice(dot + 1)];
+                }
+                continue;
+            }
+            if (!REQUIRED_KEYS.has(path)) {
+                delete record[path];
             }
-            continue;
-        }
-        if (!REQUIRED_KEYS.has(path)) {
-            delete record[path];
-        }
-    }
-};
-const writeChanges = (record, changes) => {
-    for (const [key, value] of Object.entries(changes)) {
-        if (value === undefined || IDENTITY_KEYS.has(key)) {
-            continue;
         }
-        if (MERGED_KEYS.has(key)) {
-            const merged = { ...(record[key] ?? {}) };
-            for (const [entry, entryValue] of Object.entries(value ?? {})) {
-                if (entryValue === null) {
-                    delete merged[entry];
+    };
+    const writeChanges = (record, changes) => {
+        for (const [key, value] of Object.entries(changes)) {
+            if (value === undefined || IDENTITY_KEYS.has(key)) {
+                continue;
+            }
+            if (MERGED_KEYS.has(key)) {
+                const merged = { ...(record[key] ?? {}) };
+                for (const [entry, entryValue] of Object.entries(value ?? {})) {
+                    if (entryValue === null) {
+                        delete merged[entry];
+                    }
+                    else if (entryValue !== undefined) {
+                        merged[entry] = entryValue;
+                    }
                 }
-                else if (entryValue !== undefined) {
-                    merged[entry] = entryValue;
+                record[key] = merged;
+                continue;
+            }
+            if (value === null) {
+                if (!REQUIRED_KEYS.has(key)) {
+                    delete record[key];
                 }
+                continue;
             }
-            record[key] = merged;
-            continue;
+            record[key] = value;
         }
-        if (value === null) {
-            if (!REQUIRED_KEYS.has(key)) {
-                delete record[key];
+    };
+    const applyTransition = (card, transition) => {
+        if (card != null && transition.seq <= card.seq) {
+            return card;
+        }
+        if (card == null) {
+            if (transition.action === TransitionAction.Delete) {
+                return null;
+            }
+            if (transition.action !== TransitionAction.Create || transition.seq !== 1) {
+                throw outOfOrder(card, transition);
             }
-            continue;
         }
-        record[key] = value;
-    }
-};
-/**
- * THE fold: the card after one transition. Pure, total, no I/O — every store (memory, Mongo, a
- * client mirror) folds with this and nothing else, so one log always means one card.
- *
- * - An already-applied transition (`seq <= card.seq`) returns the card unchanged: re-folding is
- *   safe.
- * - Anything but the next seq (`card.seq + 1`, or 1 for a create with no card) is refused with
- *   `PlanningError('fold:out-of-order')`.
- * - `create` builds the whole record from `changes` plus the transition's identity; `delete`
- *   answers `null`; `link`/`unlink` only move `seq`/`head`/`updatedAt` (the edges are
- *   {@link applyRelationship}'s); `update`/`transit` write `changes` — `fields` and `flows` merge,
- *   everything else replaces — and clear `unset`.
- * - Every result has `seq = transition.seq`, `head = max(head, seq)`, `updatedAt = transition.at`.
- *
- * @throws {PlanningError} `planning:fold:out-of-order:…`
- */
-export const applyTransition = (card, transition) => {
-    if (card != null && transition.seq <= card.seq) {
-        return card;
-    }
-    if (card == null) {
+        else if (transition.seq !== card.seq + 1) {
+            throw outOfOrder(card, transition);
+        }
         if (transition.action === TransitionAction.Delete) {
             return null;
         }
-        if (transition.action !== TransitionAction.Create || transition.seq !== 1) {
-            throw outOfOrder(card, transition);
+        const head = Math.max(card?.head ?? card?.seq ?? 0, transition.seq);
+        const changes = structuredClone(transition.changes ?? {});
+        if (transition.action === TransitionAction.Create) {
+            const record = {
+                parents: [], labels: [], fields: {}, flows: {}, status: '', intrinsic: IntrinsicStatus.Planned,
+            };
+            writeChanges(record, changes);
+            unsetOn(record, transition.unset);
+            return clean({
+                ...record,
+                id: transition.card,
+                kind: transition.kind,
+                type: transition.type,
+                entityId: transition.entityId,
+                seq: transition.seq,
+                head,
+                createdAt: transition.at,
+                updatedAt: transition.at,
+            });
         }
-    }
-    else if (transition.seq !== card.seq + 1) {
-        throw outOfOrder(card, transition);
-    }
-    if (transition.action === TransitionAction.Delete) {
-        return null;
-    }
-    const head = Math.max(card?.head ?? card?.seq ?? 0, transition.seq);
-    const changes = structuredClone(transition.changes ?? {});
-    if (transition.action === TransitionAction.Create) {
-        const record = {
-            parents: [], labels: [], fields: {}, flows: {}, status: '', intrinsic: IntrinsicStatus.Planned,
-        };
-        writeChanges(record, changes);
-        unsetOn(record, transition.unset);
-        return clean({
-            ...record,
-            id: transition.card,
-            kind: transition.kind,
-            type: transition.type,
-            entityId: transition.entityId,
-            seq: transition.seq,
-            head,
-            createdAt: transition.at,
-            updatedAt: transition.at,
-        });
-    }
-    const record = structuredClone(card);
-    if (transition.action === TransitionAction.Update || transition.action === TransitionAction.Transit) {
-        writeChanges(record, changes);
-        unsetOn(record, transition.unset);
-    }
-    record.seq = transition.seq;
-    record.head = head;
-    record.updatedAt = transition.at;
-    return clean(record);
-};
-const edgeOf = (transition, draft) => clean({
-    entityId: transition.entityId,
-    type: draft.type,
-    from: draft.from ?? transition.card,
-    to: draft.to,
-    project: transition.project,
-    fields: draft.fields == null ? undefined : structuredClone(draft.fields),
-    createdAt: transition.at,
-    transition: transition.id,
-});
-const sameEdge = (left, right) => left.entityId === right.entityId && left.from === right.from && left.to === right.to && left.type === right.type;
-/**
- * The relationships after one transition. Pure and total, like {@link applyTransition}.
- *
- * `create` adds its `links`, `link` adds its `link`, `unlink` removes the matching edge, and a
- * `delete` removes every edge touching the card. An edge that already exists is kept as it is, so
- * re-folding adds nothing. Every other action answers the list unchanged. Always a new array.
- */
-export const applyRelationship = (links, transition) => {
-    const add = (drafts) => drafts.reduce((result, draft) => {
-        const edge = edgeOf(transition, draft);
-        return result.some(existing => sameEdge(existing, edge)) ? result : [...result, edge];
-    }, [...links]);
-    switch (transition.action) {
-        case TransitionAction.Create:
-            return add(transition.links ?? []);
-        case TransitionAction.Link:
-            return add(transition.link == null ? [] : [transition.link]);
-        case TransitionAction.Unlink: {
-            if (transition.link == null) {
-                return [...links];
+        const record = structuredClone(card);
+        if (transition.action === TransitionAction.Update || transition.action === TransitionAction.Transit) {
+            writeChanges(record, changes);
+            unsetOn(record, transition.unset);
+        }
+        record.seq = transition.seq;
+        record.head = head;
+        record.updatedAt = transition.at;
+        return clean(record);
+    };
+    const edgeOf = (transition, draft) => clean({
+        entityId: transition.entityId,
+        type: draft.type,
+        from: draft.from ?? transition.card,
+        to: draft.to,
+        fromKind: draft.fromKind,
+        toKind: draft.toKind,
+        project: transition.project,
+        fields: draft.fields == null ? undefined : structuredClone(draft.fields),
+        createdAt: transition.at,
+        transition: transition.id,
+    });
+    const sameEdge = (left, right) => left.entityId === right.entityId && left.from === right.from && left.to === right.to && left.type === right.type
+        && (left.fromKind ?? PlanningResourceKind.Workcard) === (right.fromKind ?? PlanningResourceKind.Workcard)
+        && (left.toKind ?? PlanningResourceKind.Workcard) === (right.toKind ?? PlanningResourceKind.Workcard);
+    const applyRelationship = (links, transition) => {
+        const add = (drafts) => drafts.reduce((result, draft) => {
+            const edge = edgeOf(transition, draft);
+            return result.some(existing => sameEdge(existing, edge)) ? result : [...result, edge];
+        }, [...links]);
+        switch (transition.action) {
+            case TransitionAction.Create:
+                return add(transition.links ?? []);
+            case TransitionAction.Link:
+                return add(transition.link == null ? [] : [transition.link]);
+            case TransitionAction.Unlink: {
+                if (transition.link == null) {
+                    return [...links];
+                }
+                const edge = edgeOf(transition, transition.link);
+                return links.filter(existing => !sameEdge(existing, edge));
             }
-            const edge = edgeOf(transition, transition.link);
-            return links.filter(existing => !sameEdge(existing, edge));
+            case TransitionAction.Delete:
+                return links.filter(existing => existing.entityId !== transition.entityId
+                    || !((existing.from === transition.card && (existing.fromKind ?? PlanningResourceKind.Workcard) === PlanningResourceKind.Workcard)
+                        || (existing.to === transition.card && (existing.toKind ?? PlanningResourceKind.Workcard) === PlanningResourceKind.Workcard)));
+            default:
+                return [...links];
         }
-        case TransitionAction.Delete:
-            return links.filter(existing => existing.entityId !== transition.entityId
-                || (existing.from !== transition.card && existing.to !== transition.card));
-        default:
-            return [...links];
-    }
+    };
+    return { applyTransition, applyRelationship };
 };
+export const applyHelper = createApplyHelper();
+/** @deprecated compat:factory-refactor — use `applyHelper.applyTransition(…)` */
+export const applyTransition = (card, transition) => applyHelper.applyTransition(card, transition);
+/** @deprecated compat:factory-refactor — use `applyHelper.applyRelationship(…)` */
+export const applyRelationship = (links, transition) => applyHelper.applyRelationship(links, transition);
 //# sourceMappingURL=apply.js.map

package/build/helpers/apply.js.map

@@ -1 +1 @@
-{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/helpers/apply.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/helpers/apply.ts"],"names":[],"mappings":"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"}

package/build/helpers/card/types.d.ts

@@ -0,0 +1,20 @@
+import type { Card, Project, Specification, Workcard, WorkcardDraft } from '../../types.js';
+/** The kind guards and the parent rules every record keeps. */
+export interface CardHelper {
+    isProject: (card?: Workcard | null) => card is Project;
+    isCard: (card?: Workcard | null) => card is Card;
+    isSpecification: (card?: Workcard | null) => card is Specification;
+    /** `parents` with `parent` first and no repeats — the invariant every record keeps. */
+    normalizeParents: (parent?: string | null, parents?: string[] | null) => string[];
+    /** A draft with the collections every record carries filled in. */
+    cardDefaults: (draft: WorkcardDraft) => WorkcardDraft & Required<Pick<WorkcardDraft, 'parents' | 'labels' | 'fields'>>;
+    /** A transition was allocated for the card and has not been folded yet. */
+    isPending: (card: Pick<Workcard, 'seq' | 'head'>) => boolean;
+    parentOf: (card: Workcard) => string | undefined;
+    /**
+     * The project a card belongs to: a project is its own; a card under a project is that project's;
+     * anything deeper is its parent's project, which needs the parent to answer.
+     */
+    projectOf: (card: Workcard, parent?: Workcard | null) => string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/helpers/card/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/card/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE3F,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,IAAI,OAAO,CAAA;IACtD,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,CAAA;IAChD,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,IAAI,aAAa,CAAA;IAClE,uFAAuF;IACvF,gBAAgB,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,KAAK,MAAM,EAAE,CAAA;IACjF,mEAAmE;IACnE,YAAY,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAA;IACtH,2EAA2E;IAC3E,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,OAAO,CAAA;IAC5D,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,MAAM,GAAG,SAAS,CAAA;IAChD;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,KAAK,MAAM,GAAG,SAAS,CAAA;CAC5E"}

package/build/helpers/card/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/helpers/card/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/helpers/card/types.ts"],"names":[],"mappings":""}

package/build/helpers/card.d.ts

@@ -1,17 +1,21 @@
 import type { Card, Project, Specification, Workcard, WorkcardDraft } from '../types.js';
+import type { CardHelper } from './card/types.js';
+export declare const createCardHelper: () => CardHelper;
+export declare const cardHelper: CardHelper;
+/** @deprecated compat:factory-refactor — use `cardHelper.isProject(…)` */
 export declare const isProject: (card?: Workcard | null) => card is Project;
+/** @deprecated compat:factory-refactor — use `cardHelper.isCard(…)` */
 export declare const isCard: (card?: Workcard | null) => card is Card;
+/** @deprecated compat:factory-refactor — use `cardHelper.isSpecification(…)` */
 export declare const isSpecification: (card?: Workcard | null) => card is Specification;
-/** `parents` with `parent` first and no repeats — the invariant every record keeps. */
+/** @deprecated compat:factory-refactor — use `cardHelper.normalizeParents(…)` */
 export declare const normalizeParents: (parent?: string | null, parents?: string[] | null) => string[];
-/** A draft with the collections every record carries filled in. */
+/** @deprecated compat:factory-refactor — use `cardHelper.cardDefaults(…)` */
 export declare const cardDefaults: (draft: WorkcardDraft) => WorkcardDraft & Required<Pick<WorkcardDraft, 'parents' | 'labels' | 'fields'>>;
-/** A transition was allocated for the card and has not been folded yet. */
+/** @deprecated compat:factory-refactor — use `cardHelper.isPending(…)` */
 export declare const isPending: (card: Pick<Workcard, 'seq' | 'head'>) => boolean;
+/** @deprecated compat:factory-refactor — use `cardHelper.parentOf(…)` */
 export declare const parentOf: (card: Workcard) => string | undefined;
-/**
- * The project a card belongs to: a project is its own; a card under a project is that project's;
- * anything deeper is its parent's project, which needs the parent to answer.
- */
+/** @deprecated compat:factory-refactor — use `cardHelper.projectOf(…)` */
 export declare const projectOf: (card: Workcard, parent?: Workcard | null) => string | undefined;
 //# sourceMappingURL=card.d.ts.map

package/build/helpers/card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/helpers/card.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAExF,eAAO,MAAM,SAAS,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,OAA8C,CAAA;AAEzG,eAAO,MAAM,MAAM,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,IAAwC,CAAA;AAEhG,eAAO,MAAM,eAAe,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,aACtB,CAAA;AAE3C,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,YAAa,MAAM,GAAG,IAAI,YAAY,MAAM,EAAE,GAAG,IAAI,KAAG,MAAM,EAE/D,CAAA;AAE5B,mEAAmE;AACnE,eAAO,MAAM,YAAY,UAAW,aAAa,KAAG,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAK/H,CAAA;AAEF,2EAA2E;AAC3E,eAAO,MAAM,SAAS,SAAU,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,MAAM,CAAC,KAAG,OAA6C,CAAA;AAE9G,eAAO,MAAM,QAAQ,SAAU,QAAQ,KAAG,MAAM,GAAG,SAA2C,CAAA;AAE9F;;;GAGG;AACH,eAAO,MAAM,SAAS,SAAU,QAAQ,WAAW,QAAQ,GAAG,IAAI,KAAG,MAAM,GAAG,SAS7E,CAAA"}
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/helpers/card.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,eAAO,MAAM,gBAAgB,QAAO,UAmCnC,CAAA;AAED,eAAO,MAAM,UAAU,YAAqB,CAAA;AAE5C,0EAA0E;AAC1E,eAAO,MAAM,SAAS,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,OAAqC,CAAA;AAEhG,uEAAuE;AACvE,eAAO,MAAM,MAAM,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,IAA+B,CAAA;AAEvF,gFAAgF;AAChF,eAAO,MAAM,eAAe,UAAW,QAAQ,GAAG,IAAI,KAAG,IAAI,IAAI,aAAiD,CAAA;AAElH,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,YAAa,MAAM,GAAG,IAAI,YAAY,MAAM,EAAE,GAAG,IAAI,KAAG,MAAM,EAC7C,CAAA;AAE9C,6EAA6E;AAC7E,eAAO,MAAM,YAAY,UAAW,aAAa,KAAG,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,CACjG,CAAA;AAEhC,0EAA0E;AAC1E,eAAO,MAAM,SAAS,SAAU,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,MAAM,CAAC,KAAG,OAAqC,CAAA;AAEtG,yEAAyE;AACzE,eAAO,MAAM,QAAQ,SAAU,QAAQ,KAAG,MAAM,GAAG,SAAsC,CAAA;AAEzF,0EAA0E;AAC1E,eAAO,MAAM,SAAS,SAAU,QAAQ,WAAW,QAAQ,GAAG,IAAI,KAAG,MAAM,GAAG,SAA+C,CAAA"}

package/build/helpers/card.js

@@ -1,31 +1,44 @@
 import { WorkcardKind } from '../consts.js';
-export const isProject = (card) => card?.kind === WorkcardKind.Project;
-export const isCard = (card) => card?.kind === WorkcardKind.Card;
-export const isSpecification = (card) => card?.kind === WorkcardKind.Specification;
-/** `parents` with `parent` first and no repeats — the invariant every record keeps. */
-export const normalizeParents = (parent, parents) => [...new Set([...(parent != null && parent !== '' ? [parent] : []), ...(parents ?? [])])]
-    .filter(id => id !== '');
-/** A draft with the collections every record carries filled in. */
-export const cardDefaults = (draft) => ({
-    ...draft,
-    parents: normalizeParents(draft.parent, draft.parents),
-    labels: [...new Set(draft.labels ?? [])],
-    fields: draft.fields ?? {},
-});
-/** A transition was allocated for the card and has not been folded yet. */
-export const isPending = (card) => (card.head ?? card.seq) > card.seq;
-export const parentOf = (card) => card.parent ?? card.parents[0];
-/**
- * The project a card belongs to: a project is its own; a card under a project is that project's;
- * anything deeper is its parent's project, which needs the parent to answer.
- */
-export const projectOf = (card, parent) => {
-    if (isProject(card)) {
-        return card.id;
-    }
-    if (parent != null) {
-        return isProject(parent) ? parent.id : parent.parent;
-    }
-    return card.parent;
+export const createCardHelper = () => {
+    const isProject = (card) => card?.kind === WorkcardKind.Project;
+    const isCard = (card) => card?.kind === WorkcardKind.Card;
+    const isSpecification = (card) => card?.kind === WorkcardKind.Specification;
+    const normalizeParents = (parent, parents) => [...new Set([...(parent != null && parent !== '' ? [parent] : []), ...(parents ?? [])])]
+        .filter(id => id !== '');
+    const cardDefaults = (draft) => ({
+        ...draft,
+        parents: normalizeParents(draft.parent, draft.parents),
+        labels: [...new Set(draft.labels ?? [])],
+        fields: draft.fields ?? {},
+    });
+    const isPending = (card) => (card.head ?? card.seq) > card.seq;
+    const parentOf = (card) => card.parent ?? card.parents[0];
+    const projectOf = (card, parent) => {
+        if (isProject(card)) {
+            return card.id;
+        }
+        if (parent != null) {
+            return isProject(parent) ? parent.id : parent.parent;
+        }
+        return card.parent;
+    };
+    return { isProject, isCard, isSpecification, normalizeParents, cardDefaults, isPending, parentOf, projectOf };
 };
+export const cardHelper = createCardHelper();
+/** @deprecated compat:factory-refactor — use `cardHelper.isProject(…)` */
+export const isProject = (card) => cardHelper.isProject(card);
+/** @deprecated compat:factory-refactor — use `cardHelper.isCard(…)` */
+export const isCard = (card) => cardHelper.isCard(card);
+/** @deprecated compat:factory-refactor — use `cardHelper.isSpecification(…)` */
+export const isSpecification = (card) => cardHelper.isSpecification(card);
+/** @deprecated compat:factory-refactor — use `cardHelper.normalizeParents(…)` */
+export const normalizeParents = (parent, parents) => cardHelper.normalizeParents(parent, parents);
+/** @deprecated compat:factory-refactor — use `cardHelper.cardDefaults(…)` */
+export const cardDefaults = (draft) => cardHelper.cardDefaults(draft);
+/** @deprecated compat:factory-refactor — use `cardHelper.isPending(…)` */
+export const isPending = (card) => cardHelper.isPending(card);
+/** @deprecated compat:factory-refactor — use `cardHelper.parentOf(…)` */
+export const parentOf = (card) => cardHelper.parentOf(card);
+/** @deprecated compat:factory-refactor — use `cardHelper.projectOf(…)` */
+export const projectOf = (card, parent) => cardHelper.projectOf(card, parent);
 //# sourceMappingURL=card.js.map

package/build/helpers/card.js.map

@@ -1 +1 @@
-{"version":3,"file":"card.js","sourceRoot":"","sources":["../../src/helpers/card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAsB,EAAmB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,YAAY,CAAC,OAAO,CAAA;AAEzG,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAsB,EAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,YAAY,CAAC,IAAI,CAAA;AAEhG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAsB,EAAyB,EAAE,CAC/E,IAAI,EAAE,IAAI,KAAK,YAAY,CAAC,aAAa,CAAA;AAE3C,uFAAuF;AACvF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAsB,EAAE,OAAyB,EAAY,EAAE,CAC9F,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;KACrF,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAE5B,mEAAmE;AACnE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAoB,EAAkF,EAAE,CAAC,CAAC;IACrI,GAAG,KAAK;IACR,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;IACtD,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACxC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;CAC3B,CAAC,CAAA;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAoC,EAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAA;AAE9G,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAc,EAAsB,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AAE9F;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAc,EAAE,MAAwB,EAAsB,EAAE;IACxF,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,EAAE,CAAA;IAChB,CAAC;IACD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAA;IACtD,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,CAAA;AACpB,CAAC,CAAA"}
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../../src/helpers/card.ts"],"names":[],"mappings":"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"}

package/build/helpers/changes/consts.local.d.ts

@@ -0,0 +1,13 @@
+/** Never in a caller's changes: the transition itself carries them. */
+export declare const IDENTITY_KEYS: string[];
+/** Written once, from a create's draft; never by `changes` or `unset`, whatever the action. */
+export declare const PROVENANCE_KEYS: string[];
+/** Move only through `transit` (or a create's draft). */
+export declare const FLOW_KEYS: string[];
+/** Computed by the executor, never supplied. */
+export declare const DERIVED_KEYS: string[];
+/** Cannot be cleared. */
+export declare const REQUIRED_KEYS: string[];
+/** Changing one of these produces a new revision of a revisioned document. */
+export declare const CONTENT_KEYS: string[];
+//# sourceMappingURL=consts.local.d.ts.map

package/build/helpers/changes/consts.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../../../src/helpers/changes/consts.local.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,eAAO,MAAM,aAAa,UAA+E,CAAA;AAEzG,+FAA+F;AAC/F,eAAO,MAAM,eAAe,UAAgB,CAAA;AAE5C,yDAAyD;AACzD,eAAO,MAAM,SAAS,UAA+C,CAAA;AAErE,gDAAgD;AAChD,eAAO,MAAM,YAAY,UAA4B,CAAA;AAErD,yBAAyB;AACzB,eAAO,MAAM,aAAa,UAAiE,CAAA;AAE3F,8EAA8E;AAC9E,eAAO,MAAM,YAAY,UAAuC,CAAA"}

package/build/helpers/changes/consts.local.js

@@ -0,0 +1,13 @@
+/** Never in a caller's changes: the transition itself carries them. */
+export const IDENTITY_KEYS = ['id', 'kind', 'type', 'entityId', 'seq', 'head', 'parentType', 'createdAt'];
+/** Written once, from a create's draft; never by `changes` or `unset`, whatever the action. */
+export const PROVENANCE_KEYS = ['createdBy'];
+/** Move only through `transit` (or a create's draft). */
+export const FLOW_KEYS = ['status', 'intrinsic', 'flows', 'closedAt'];
+/** Computed by the executor, never supplied. */
+export const DERIVED_KEYS = ['revision', 'bodyChars'];
+/** Cannot be cleared. */
+export const REQUIRED_KEYS = ['title', 'parents', 'labels', 'fields', 'category', 'format'];
+/** Changing one of these produces a new revision of a revisioned document. */
+export const CONTENT_KEYS = ['body', 'ref', 'format', 'version'];
+//# sourceMappingURL=consts.local.js.map

package/build/helpers/changes/consts.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../../../src/helpers/changes/consts.local.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,CAAC,CAAA;AAEzG,+FAA+F;AAC/F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,WAAW,CAAC,CAAA;AAE5C,yDAAyD;AACzD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;AAErE,gDAAgD;AAChD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;AAErD,yBAAyB;AACzB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAA;AAE3F,8EAA8E;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA"}

package/build/helpers/changes/types.d.ts

@@ -0,0 +1,58 @@
+import type { AnyTypeSchema, SpecificationSlot, TransitionExecution, Workcard, WorkcardChanges } from '../../types.js';
+import type { FlowLookup } from '../types.local.js';
+export interface ChangeSet {
+    changes: WorkcardChanges;
+    unset: string[];
+    /** Transit only: the flow that moved, and the move. */
+    flow?: string;
+    from?: string;
+    to?: string;
+}
+/** What a transition records — computed from an execution, and the guards it must pass first. */
+export interface ChangesHelper {
+    /** Structural equality over JSON values. */
+    sameValue: (left: unknown, right: unknown) => boolean;
+    /** A shallow merge that drops keys patched to `null`. */
+    mergeFields: (base?: Record<string, unknown> | null, patch?: Record<string, unknown> | null) => Record<string, unknown>;
+    /** A copy of the record with the paths (`key`, `fields.key`, `flows.id`) removed. */
+    applyUnset: <T extends object>(record: T, unset?: string[]) => T;
+    /**
+     * Refuse an execution that writes what only the transition, the flow or the executor may write.
+     *
+     * `status`/`intrinsic`/`flows`/`closedAt` move only through `transit` (a create's draft may name
+     * the initial status); `code` is fixed once minted unless the type's policy says `mutable`;
+     * `category` is fixed; `revision`/`bodyChars` are computed; `createdBy` is the create DRAFT's
+     * alone — named in `changes` or `unset` it is refused on every action, so an owner check
+     * (`card.createdBy === profileId`) can trust it.
+     *
+     * @throws {PlanningError} `planning:immutable:<field>`
+     */
+    assertMutable: (exec: TransitionExecution, type: AnyTypeSchema) => void;
+    /**
+     * The `changes`/`unset` a transition records (plan step 9).
+     *
+     * - `create`: the whole initial record from the draft (overlaid by `exec.changes`) — `parents`
+     *   normalized, every flow at its initial status (the draft's `status` for the primary one),
+     *   `status`/`intrinsic` mirrored, `closedAt` when it starts closed; a specification gets its
+     *   format, `bodyChars` and revision 1 when the slot is revisioned.
+     * - `update`: only what differs; `null` or `exec.unset` clears a field that has a value; a moved
+     *   `parent` replaces the old one in `parents`; a revisioned document whose content changed gets
+     *   `revision + 1`. An update that changes nothing is empty ({@link ChangesHelper.isEmptyChange}).
+     * - `transit`: `flows[flow] = rule.to`, `status` when the flow is primary, `intrinsic` when it
+     *   moves, `closedAt` set on entering closed and cleared on leaving it — plus the caller's own
+     *   changes, diffed as in an update.
+     * - `link`, `unlink`, `delete`: nothing.
+     *
+     * `createdBy` comes from a create's draft only: `changes` and `unset` never carry it, on any action
+     * ({@link ChangesHelper.assertMutable} refuses an execution that tries).
+     *
+     * @throws {IllegalTransition} a transit the flow does not offer from the current status
+     * @throws {PlanningError} `malformed:*` for an execution missing what its action needs
+     */
+    computeChanges: (card: Workcard | null | undefined, exec: TransitionExecution, type: AnyTypeSchema, registry: FlowLookup, at: string, opts?: {
+        slot?: SpecificationSlot | null;
+    }) => ChangeSet;
+    /** Nothing to write: no changed value and nothing to clear. */
+    isEmptyChange: (set: Pick<ChangeSet, 'changes' | 'unset'>) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/helpers/changes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/changes/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,EACjF,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,eAAe,CAAA;IACxB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,iGAAiG;AACjG,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;IACrD,yDAAyD;IACzD,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvH,qFAAqF;IACrF,UAAU,EAAE,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;IAChE;;;;;;;;;;OAUG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;IACvE;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,cAAc,EAAE,CACd,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EACjC,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,UAAU,EACpB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;KAAE,KACvC,SAAS,CAAA;IACd,+DAA+D;IAC/D,aAAa,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,OAAO,CAAA;CACtE"}

package/build/helpers/changes/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/helpers/changes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/helpers/changes/types.ts"],"names":[],"mappings":""}