@owlmeans/planning 0.1.18-rc.2 → 0.1.18-rc.21

package/build/helpers/scoped.js

@@ -0,0 +1,197 @@
+import { memoHelper } from '@owlmeans/context';
+import { PlanningSchemaKind, SchemaOrigin, WorkcardKind } from '../consts.js';
+import { PlanningUnsupported, SchemaInvalid, SchemaSealed } from '../errors.js';
+import { makeSchemaRegistry } from '../registry.js';
+import { StatusFlowSchemaSchema, WorkcardTypeSchemaSchema } from '../schemas.js';
+import { makeAjv, validateHelper } from './validate.js';
+const messageOf = (error) => error instanceof Error ? error.message : `${error}`;
+export const createScopedSchemaHelper = () => {
+    const checkers = memoHelper.once(() => {
+        const ajv = makeAjv();
+        return { flow: ajv.compile(StatusFlowSchemaSchema), type: ajv.compile(WorkcardTypeSchemaSchema) };
+    });
+    const schemaRecordKey = (record) => `${record.entityId}\u0000${record.project ?? ''}\u0000${record.kind}\u0000${record.key}`;
+    const schemaKeyOf = (kind, definition) => kind === PlanningSchemaKind.Type ? definition.type : definition.id;
+    const openType = (type) => type.kind === WorkcardKind.Card && type.overridable === true;
+    const assertOverridable = (code, kind, key) => {
+        if (kind === PlanningSchemaKind.Type) {
+            if (code.has(key) && !openType(code.type(key))) {
+                throw new SchemaSealed(`type:${key}`);
+            }
+            return;
+        }
+        const flow = code.flows().find(entry => entry.id === key);
+        if (flow != null && flow.overridable !== true) {
+            throw new SchemaSealed(`flow:${key}`);
+        }
+    };
+    const assertFlowSchema = (flow) => {
+        const validate = checkers().flow;
+        if (!validate(flow)) {
+            throw new SchemaInvalid(`flow:${flow?.id ?? ''}:${validateHelper.ajvErrorText(validate.errors)}`);
+        }
+        const keys = new Set();
+        for (const status of flow.statuses) {
+            if (keys.has(status.key)) {
+                throw new SchemaInvalid(`flow:${flow.id}:status-repeated:${status.key}`);
+            }
+            keys.add(status.key);
+        }
+        for (const rule of flow.transitions) {
+            if (!keys.has(rule.to)) {
+                throw new SchemaInvalid(`flow:${flow.id}:${rule.name}:to:${rule.to}`);
+            }
+            if (typeof rule.from === 'string') {
+                if (rule.from !== '*') {
+                    throw new SchemaInvalid(`flow:${flow.id}:${rule.name}:from:${rule.from}`);
+                }
+                continue;
+            }
+            const unknown = rule.from.find(status => !keys.has(status));
+            if (unknown != null) {
+                throw new SchemaInvalid(`flow:${flow.id}:${rule.name}:from:${unknown}`);
+            }
+        }
+    };
+    const assertTypeSchema = (type, flows) => {
+        const validate = checkers().type;
+        if (!validate(type)) {
+            throw new SchemaInvalid(`type:${type?.type ?? ''}:${validateHelper.ajvErrorText(validate.errors)}`);
+        }
+        if (type.kind !== WorkcardKind.Card) {
+            throw new SchemaInvalid(`type:${type.type}:kind:${type.kind}`);
+        }
+        try {
+            makeAjv().compile(type.fields);
+        }
+        catch (error) {
+            throw new SchemaInvalid(`type:${type.type}:fields:${messageOf(error)}`);
+        }
+        const seen = new Set();
+        for (const id of type.flows) {
+            if (seen.has(id)) {
+                throw new SchemaInvalid(`type:${type.type}:flow-repeated:${id}`);
+            }
+            seen.add(id);
+            try {
+                flows.flow(id);
+            }
+            catch {
+                throw new SchemaInvalid(`type:${type.type}:flow:${id}`);
+            }
+        }
+    };
+    const resolveKind = (kind, code, keyOf, open, valid, layers) => {
+        const coded = new Map(code.map(definition => [keyOf(definition), definition]));
+        const byKey = (records) => new Map(records
+            .filter(record => record.kind === kind)
+            .map(record => [record.key, record])
+            .filter(([key, record]) => {
+            const definition = record.definition;
+            return valid(definition) && keyOf(definition) === key;
+        }));
+        const entity = byKey(layers.entity);
+        const project = byKey(layers.project);
+        const added = [...new Set([...entity.keys(), ...project.keys()])].filter(key => !coded.has(key)).sort();
+        const stamped = (record) => ({ ...record.definition, version: record.version });
+        const result = { definitions: [], origins: {}, retired: [] };
+        for (const key of [...coded.keys(), ...added]) {
+            const declared = coded.get(key);
+            const candidates = [];
+            if (declared == null || open(declared)) {
+                const own = project.get(key);
+                if (own != null) {
+                    candidates.push({ origin: SchemaOrigin.Project, definition: stamped(own), retired: own.retired === true });
+                }
+                const shared = entity.get(key);
+                if (shared != null) {
+                    candidates.push({ origin: SchemaOrigin.Entity, definition: stamped(shared), retired: shared.retired === true });
+                }
+            }
+            if (declared != null) {
+                candidates.push({ origin: SchemaOrigin.Code, definition: declared, retired: false });
+            }
+            // A retired record gives way to a live declaration below it; only when every layer holding the
+            // key retired it does the key resolve retired — still there for the cards that use it.
+            const chosen = candidates.find(candidate => !candidate.retired) ?? candidates[0];
+            if (chosen == null) {
+                continue;
+            }
+            result.definitions.push(chosen.definition);
+            result.origins[key] = chosen.origin;
+            if (chosen.retired) {
+                result.retired.push(key);
+            }
+        }
+        return result;
+    };
+    const resolveScopedBundle = (code, records, scope) => {
+        const mine = records.filter(record => record.entityId === scope.entityId);
+        const layers = {
+            entity: mine.filter(record => record.project == null),
+            project: scope.project == null ? [] : mine.filter(record => record.project === scope.project),
+        };
+        const types = resolveKind(PlanningSchemaKind.Type, code.types, type => type.type, openType, type => type != null && typeof type.type === 'string' && type.kind === WorkcardKind.Card, layers);
+        const flows = resolveKind(PlanningSchemaKind.Flow, code.flows, flow => flow.id, flow => flow.overridable === true, flow => flow != null && typeof flow.id === 'string', layers);
+        return structuredClone({
+            version: code.version,
+            types: types.definitions,
+            flows: flows.definitions,
+            scope: scope.project == null ? { entityId: scope.entityId } : { entityId: scope.entityId, project: scope.project },
+            revision: scope.revision ?? 0,
+            origins: { types: types.origins, flows: flows.origins },
+            retired: { types: types.retired, flows: flows.retired },
+        });
+    };
+    const scopedRegistryOf = (bundle) => {
+        const base = makeSchemaRegistry(bundle);
+        const kept = structuredClone(bundle);
+        const refuse = () => {
+            throw new PlanningUnsupported('schemas:read-only');
+        };
+        const originsOf = (kind) => kind === PlanningSchemaKind.Type ? kept.origins?.types : kept.origins?.flows;
+        const retiredOf = (kind) => kind === PlanningSchemaKind.Type ? kept.retired?.types : kept.retired?.flows;
+        return {
+            ...base,
+            registerType: refuse,
+            registerFlow: refuse,
+            load: refuse,
+            scope: kept.scope ?? { entityId: '' },
+            revision: kept.revision ?? 0,
+            originOf: (kind, key) => originsOf(kind)?.[key]
+                ?? ((kind === PlanningSchemaKind.Type ? base.has(key) : base.flows().some(flow => flow.id === key))
+                    ? SchemaOrigin.Code
+                    : undefined),
+            isRetired: (kind, key) => retiredOf(kind)?.includes(key) === true,
+            bundle: () => structuredClone(kept),
+        };
+    };
+    const flowInUse = (bundle, flow) => {
+        if (bundle.retired?.flows.includes(flow) !== true) {
+            return undefined;
+        }
+        return bundle.types.find(type => bundle.retired?.types.includes(type.type) !== true && type.flows.includes(flow))?.type;
+    };
+    return {
+        schemaRecordKey, schemaKeyOf, assertOverridable, assertFlowSchema, assertTypeSchema, resolveScopedBundle,
+        scopedRegistryOf, flowInUse,
+    };
+};
+export const scopedSchemaHelper = createScopedSchemaHelper();
+/** @deprecated compat:factory-refactor — use `scopedSchemaHelper.schemaRecordKey(…)` */
+export const schemaRecordKey = (record) => scopedSchemaHelper.schemaRecordKey(record);
+/** @deprecated compat:factory-refactor — use `scopedSchemaHelper.schemaKeyOf(…)` */
+export const schemaKeyOf = (kind, definition) => scopedSchemaHelper.schemaKeyOf(kind, definition);
+/** @deprecated compat:factory-refactor — use `scopedSchemaHelper.assertOverridable(…)` */
+export const assertOverridable = (code, kind, key) => scopedSchemaHelper.assertOverridable(code, kind, key);
+/** @deprecated compat:factory-refactor — use `scopedSchemaHelper.assertFlowSchema(…)` */
+export const assertFlowSchema = (flow) => scopedSchemaHelper.assertFlowSchema(flow);
+/** @deprecated compat:factory-refactor — use `scopedSchemaHelper.assertTypeSchema(…)` */
+export const assertTypeSchema = (type, flows) => scopedSchemaHelper.assertTypeSchema(type, flows);
+/** @deprecated compat:factory-refactor — use `scopedSchemaHelper.resolveScopedBundle(…)` */
+export const resolveScopedBundle = (code, records, scope) => scopedSchemaHelper.resolveScopedBundle(code, records, scope);
+/** @deprecated compat:factory-refactor — use `scopedSchemaHelper.scopedRegistryOf(…)` */
+export const scopedRegistryOf = (bundle) => scopedSchemaHelper.scopedRegistryOf(bundle);
+/** @deprecated compat:factory-refactor — use `scopedSchemaHelper.flowInUse(…)` */
+export const flowInUse = (bundle, flow) => scopedSchemaHelper.flowInUse(bundle, flow);
+//# sourceMappingURL=scoped.js.map

package/build/helpers/scoped.js.map

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

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

@@ -0,0 +1,24 @@
+import type { AnyTypeSchema, PlanningSchemaRegistry, Specification, SpecificationSlot, Workcard } from '../../types.js';
+/** The slot and revision rules of the documents a parent card carries. */
+export interface SpecificationHelper {
+    /** The slot a parent type declares for a category. */
+    slotOf: (type: AnyTypeSchema, category: string) => SpecificationSlot | undefined;
+    isRevisioned: (slot?: SpecificationSlot | null) => boolean;
+    bodyCharsOf: (body?: string | null) => number | undefined;
+    /** The revision a write lands as: 1 for a new document, current + 1 after, none when unrevisioned. */
+    nextRevision: (current: Pick<Specification, 'revision'> | null | undefined, slot?: SpecificationSlot | null) => number | undefined;
+    /**
+     * The current document of a category among a parent's specifications: the highest revision, then
+     * the most recently updated. `null` when the category has none.
+     */
+    currentSpecification: (specs: Workcard[], category: string) => Specification | null;
+    /**
+     * The specification type a new document of a slot is created with: the slot's own `type`, else
+     * the only registered specification type, else the one sharing the parent type's prefix
+     * (`viable:project` → `viable:spec`).
+     *
+     * @throws {UnknownWorkcardType} when none or several candidates remain
+     */
+    specificationTypeOf: (registry: Pick<PlanningSchemaRegistry, 'types'>, parentType: string, slot?: SpecificationSlot | null) => string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/specification/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEvH,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,MAAM,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAA;IAChF,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,KAAK,OAAO,CAAA;IAC1D,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,SAAS,CAAA;IACzD,sGAAsG;IACtG,YAAY,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,KAAK,MAAM,GAAG,SAAS,CAAA;IAClI;;;OAGG;IACH,oBAAoB,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAA;IACnF;;;;;;OAMG;IACH,mBAAmB,EAAE,CACnB,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,KACjG,MAAM,CAAA;CACZ"}

package/build/helpers/specification/types.js

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

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

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

package/build/helpers/specification.d.ts

@@ -1,21 +1,17 @@
 import type { AnyTypeSchema, PlanningSchemaRegistry, Specification, SpecificationSlot, Workcard } from '../types.js';
-/** The slot a parent type declares for a category. */
+import type { SpecificationHelper } from './specification/types.js';
+export declare const createSpecificationHelper: () => SpecificationHelper;
+export declare const specificationHelper: SpecificationHelper;
+/** @deprecated compat:factory-refactor — use `specificationHelper.slotOf(…)` */
 export declare const slotOf: (type: AnyTypeSchema, category: string) => SpecificationSlot | undefined;
+/** @deprecated compat:factory-refactor — use `specificationHelper.isRevisioned(…)` */
 export declare const isRevisioned: (slot?: SpecificationSlot | null) => boolean;
+/** @deprecated compat:factory-refactor — use `specificationHelper.bodyCharsOf(…)` */
 export declare const bodyCharsOf: (body?: string | null) => number | undefined;
-/** The revision a write lands as: 1 for a new document, current + 1 after, none when unrevisioned. */
+/** @deprecated compat:factory-refactor — use `specificationHelper.nextRevision(…)` */
 export declare const nextRevision: (current: Pick<Specification, 'revision'> | null | undefined, slot?: SpecificationSlot | null) => number | undefined;
-/**
- * The current document of a category among a parent's specifications: the highest revision, then
- * the most recently updated. `null` when the category has none.
- */
+/** @deprecated compat:factory-refactor — use `specificationHelper.currentSpecification(…)` */
 export declare const currentSpecification: (specs: Workcard[], category: string) => Specification | null;
-/**
- * The specification type a new document of a slot is created with: the slot's own `type`, else
- * the only registered specification type, else the one sharing the parent type's prefix
- * (`viable:project` → `viable:spec`).
- *
- * @throws {UnknownWorkcardType} when none or several candidates remain
- */
+/** @deprecated compat:factory-refactor — use `specificationHelper.specificationTypeOf(…)` */
 export declare const specificationTypeOf: (registry: Pick<PlanningSchemaRegistry, 'types'>, parentType: string, slot?: SpecificationSlot | null) => string;
 //# sourceMappingURL=specification.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"specification.d.ts","sourceRoot":"","sources":["../../src/helpers/specification.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAClF,MAAM,aAAa,CAAA;AAEpB,sDAAsD;AACtD,eAAO,MAAM,MAAM,SAAU,aAAa,YAAY,MAAM,KAAG,iBAAiB,GAAG,SACrB,CAAA;AAE9D,eAAO,MAAM,YAAY,UAAW,iBAAiB,GAAG,IAAI,KAAG,OAAoC,CAAA;AAEnG,eAAO,MAAM,WAAW,UAAW,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,SAAmD,CAAA;AAE/G,sGAAsG;AACtG,eAAO,MAAM,YAAY,YACd,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,SAAS,iBAAiB,GAAG,IAAI,KAC3F,MAAM,GAAG,SAA0E,CAAA;AAEtF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UACxB,QAAQ,EAAE,YAAY,MAAM,KAClC,aAAa,GAAG,IAYT,CAAA;AAIV;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,aACpB,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,cAAc,MAAM,SAAS,iBAAiB,GAAG,IAAI,KACnG,MAcF,CAAA"}
+{"version":3,"file":"specification.d.ts","sourceRoot":"","sources":["../../src/helpers/specification.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAClF,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,eAAO,MAAM,yBAAyB,QAAO,mBAiD5C,CAAA;AAED,eAAO,MAAM,mBAAmB,qBAA8B,CAAA;AAE9D,gFAAgF;AAChF,eAAO,MAAM,MAAM,SAAU,aAAa,YAAY,MAAM,KAAG,iBAAiB,GAAG,SACvC,CAAA;AAE5C,sFAAsF;AACtF,eAAO,MAAM,YAAY,UAAW,iBAAiB,GAAG,IAAI,KAAG,OAAiD,CAAA;AAEhH,qFAAqF;AACrF,eAAO,MAAM,WAAW,UAAW,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,SAAkD,CAAA;AAE9G,sFAAsF;AACtF,eAAO,MAAM,YAAY,YACd,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,SAAS,iBAAiB,GAAG,IAAI,KAC3F,MAAM,GAAG,SAA4D,CAAA;AAExE,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,UAAW,QAAQ,EAAE,YAAY,MAAM,KAAG,aAAa,GAAG,IAChC,CAAA;AAE3D,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,aACpB,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,cAAc,MAAM,SAAS,iBAAiB,GAAG,IAAI,KACnG,MAA6E,CAAA"}

package/build/helpers/specification.js

@@ -1,48 +1,51 @@
 import { WorkcardKind } from '../consts.js';
 import { UnknownWorkcardType } from '../errors.js';
-/** The slot a parent type declares for a category. */
-export const slotOf = (type, category) => type.specifications.find(slot => slot.category === category);
-export const isRevisioned = (slot) => slot?.revisioned === true;
-export const bodyCharsOf = (body) => body == null ? undefined : body.length;
-/** The revision a write lands as: 1 for a new document, current + 1 after, none when unrevisioned. */
-export const nextRevision = (current, slot) => isRevisioned(slot) ? (current?.revision ?? 0) + 1 : undefined;
-/**
- * The current document of a category among a parent's specifications: the highest revision, then
- * the most recently updated. `null` when the category has none.
- */
-export const currentSpecification = (specs, category) => specs
-    .filter((spec) => spec.kind === WorkcardKind.Specification
-    && spec.category === category)
-    .reduce((best, spec) => {
-    if (best == null) {
-        return spec;
-    }
-    const byRevision = (spec.revision ?? 0) - (best.revision ?? 0);
-    if (byRevision !== 0) {
-        return byRevision > 0 ? spec : best;
-    }
-    return (spec.updatedAt ?? spec.createdAt) > (best.updatedAt ?? best.createdAt) ? spec : best;
-}, null);
-const prefixOf = (type) => type.includes(':') ? type.slice(0, type.lastIndexOf(':')) : '';
-/**
- * The specification type a new document of a slot is created with: the slot's own `type`, else
- * the only registered specification type, else the one sharing the parent type's prefix
- * (`viable:project` → `viable:spec`).
- *
- * @throws {UnknownWorkcardType} when none or several candidates remain
- */
-export const specificationTypeOf = (registry, parentType, slot) => {
-    if (slot?.type != null) {
-        return slot.type;
-    }
-    const candidates = registry.types().filter(type => type.kind === WorkcardKind.Specification);
-    if (candidates.length === 1) {
-        return candidates[0].type;
-    }
-    const prefixed = candidates.filter(type => prefixOf(type.type) === prefixOf(parentType));
-    if (prefixed.length === 1) {
-        return prefixed[0].type;
-    }
-    throw new UnknownWorkcardType(`specification:${parentType}:${slot?.category ?? ''}`);
+export const createSpecificationHelper = () => {
+    const slotOf = (type, category) => type.specifications.find(slot => slot.category === category);
+    const isRevisioned = (slot) => slot?.revisioned === true;
+    const bodyCharsOf = (body) => body == null ? undefined : body.length;
+    const nextRevision = (current, slot) => isRevisioned(slot) ? (current?.revision ?? 0) + 1 : undefined;
+    const currentSpecification = (specs, category) => specs
+        .filter((spec) => spec.kind === WorkcardKind.Specification
+        && spec.category === category)
+        .reduce((best, spec) => {
+        if (best == null) {
+            return spec;
+        }
+        const byRevision = (spec.revision ?? 0) - (best.revision ?? 0);
+        if (byRevision !== 0) {
+            return byRevision > 0 ? spec : best;
+        }
+        return (spec.updatedAt ?? spec.createdAt) > (best.updatedAt ?? best.createdAt) ? spec : best;
+    }, null);
+    const prefixOf = (type) => type.includes(':') ? type.slice(0, type.lastIndexOf(':')) : '';
+    const specificationTypeOf = (registry, parentType, slot) => {
+        if (slot?.type != null) {
+            return slot.type;
+        }
+        const candidates = registry.types().filter(type => type.kind === WorkcardKind.Specification);
+        if (candidates.length === 1) {
+            return candidates[0].type;
+        }
+        const prefixed = candidates.filter(type => prefixOf(type.type) === prefixOf(parentType));
+        if (prefixed.length === 1) {
+            return prefixed[0].type;
+        }
+        throw new UnknownWorkcardType(`specification:${parentType}:${slot?.category ?? ''}`);
+    };
+    return { slotOf, isRevisioned, bodyCharsOf, nextRevision, currentSpecification, specificationTypeOf };
 };
+export const specificationHelper = createSpecificationHelper();
+/** @deprecated compat:factory-refactor — use `specificationHelper.slotOf(…)` */
+export const slotOf = (type, category) => specificationHelper.slotOf(type, category);
+/** @deprecated compat:factory-refactor — use `specificationHelper.isRevisioned(…)` */
+export const isRevisioned = (slot) => specificationHelper.isRevisioned(slot);
+/** @deprecated compat:factory-refactor — use `specificationHelper.bodyCharsOf(…)` */
+export const bodyCharsOf = (body) => specificationHelper.bodyCharsOf(body);
+/** @deprecated compat:factory-refactor — use `specificationHelper.nextRevision(…)` */
+export const nextRevision = (current, slot) => specificationHelper.nextRevision(current, slot);
+/** @deprecated compat:factory-refactor — use `specificationHelper.currentSpecification(…)` */
+export const currentSpecification = (specs, category) => specificationHelper.currentSpecification(specs, category);
+/** @deprecated compat:factory-refactor — use `specificationHelper.specificationTypeOf(…)` */
+export const specificationTypeOf = (registry, parentType, slot) => specificationHelper.specificationTypeOf(registry, parentType, slot);
 //# sourceMappingURL=specification.js.map

package/build/helpers/specification.js.map

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

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

@@ -0,0 +1,48 @@
+import type { IntrinsicStatus } from '../../consts.js';
+import type { AnyTypeSchema, StatusDefinition, StatusFlowSchema, StatusTransitionRule } from '../../types.js';
+import type { FlowLookup } from '../types.local.js';
+/** The status-flow rules: statuses, the transitions a flow offers, and the intrinsic state. */
+export interface StatusHelper {
+    /** The primary flow id of a type — `flows[0]`. @throws {UnknownStatusFlow} when it declares none */
+    primaryFlowOf: (type: AnyTypeSchema) => string;
+    flowIdsOf: (type: AnyTypeSchema) => string[];
+    statusDefinitionOf: (flow: StatusFlowSchema, status: string) => StatusDefinition | undefined;
+    /** The intrinsic state a status maps onto, or `undefined` for a status the flow does not declare. */
+    intrinsicOf: (flow: StatusFlowSchema, status: string) => IntrinsicStatus | undefined;
+    /** The status marked `initial`, else the first one. @throws {PlanningError} for a flow with none */
+    initialStatusOf: (flow: StatusFlowSchema) => string;
+    isTerminal: (flow: StatusFlowSchema, status: string) => boolean;
+    /**
+     * The rule a named transition follows from a status.
+     *
+     * A name may be declared several times with different `from` sets; the rule naming the status
+     * explicitly wins, and a `'*'` rule of that name answers only when none does. A status the flow
+     * does NOT declare — a card whose flow changed under it — matches every rule of the name, the first
+     * declared answering: such a card can always move back onto the flow it now runs.
+     */
+    ruleOf: (flow: StatusFlowSchema, transition: string, from: string) => StatusTransitionRule | undefined;
+    canTransit: (flow: StatusFlowSchema, transition: string, from: string) => boolean;
+    /**
+     * Every transition available from a status, one rule per name (the one `ruleOf` would pick), in
+     * declaration order. `explicit: true` keeps only the rules offered to a person.
+     */
+    transitionsFrom: (flow: StatusFlowSchema, status: string, opts?: {
+        explicit?: boolean;
+    }) => StatusTransitionRule[];
+    /**
+     * A new card's status per flow: every flow's initial status, with the primary one overridden by
+     * `status` when the draft names one.
+     *
+     * @throws {UnknownStatusFlow}
+     */
+    initialFlowsOf: (type: AnyTypeSchema, registry: FlowLookup, status?: string) => Record<string, string>;
+    /**
+     * The card's intrinsic state over its flows. {@link IntrinsicPolicy.Primary} reads the primary
+     * flow; {@link IntrinsicPolicy.All} takes the least advanced flow. A status the flow does not
+     * declare reads as planned.
+     *
+     * @throws {UnknownStatusFlow}
+     */
+    resolveIntrinsic: (type: AnyTypeSchema, flows: Record<string, string>, registry: FlowLookup) => IntrinsicStatus;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/status/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAC7G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,+FAA+F;AAC/F,MAAM,WAAW,YAAY;IAC3B,oGAAoG;IACpG,aAAa,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,MAAM,CAAA;IAC9C,SAAS,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,MAAM,EAAE,CAAA;IAC5C,kBAAkB,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAA;IAC5F,qGAAqG;IACrG,WAAW,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAA;IACpF,oGAAoG;IACpG,eAAe,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,MAAM,CAAA;IACnD,UAAU,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;IAC/D;;;;;;;OAOG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,oBAAoB,GAAG,SAAS,CAAA;IACtG,UAAU,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACjF;;;OAGG;IACH,eAAe,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,oBAAoB,EAAE,CAAA;IAClH;;;;;OAKG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtG;;;;;;OAMG;IACH,gBAAgB,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,UAAU,KAAK,eAAe,CAAA;CAChH"}

package/build/helpers/status/types.js

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

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

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

package/build/helpers/status.d.ts

@@ -1,44 +1,31 @@
 import { IntrinsicStatus } from '../consts.js';
-import type { AnyTypeSchema, PlanningSchemaRegistry, StatusDefinition, StatusFlowSchema, StatusTransitionRule } from '../types.js';
-type FlowLookup = Pick<PlanningSchemaRegistry, 'flow'>;
-/** The primary flow id of a type — `flows[0]`. @throws {UnknownStatusFlow} when it declares none */
+import type { AnyTypeSchema, StatusDefinition, StatusFlowSchema, StatusTransitionRule } from '../types.js';
+import type { StatusHelper } from './status/types.js';
+import type { FlowLookup } from './types.local.js';
+export declare const createStatusHelper: () => StatusHelper;
+export declare const statusHelper: StatusHelper;
+/** @deprecated compat:factory-refactor — use `statusHelper.primaryFlowOf(…)` */
 export declare const primaryFlowOf: (type: AnyTypeSchema) => string;
+/** @deprecated compat:factory-refactor — use `statusHelper.flowIdsOf(…)` */
 export declare const flowIdsOf: (type: AnyTypeSchema) => string[];
+/** @deprecated compat:factory-refactor — use `statusHelper.statusDefinitionOf(…)` */
 export declare const statusDefinitionOf: (flow: StatusFlowSchema, status: string) => StatusDefinition | undefined;
-/** The intrinsic state a status maps onto, or `undefined` for a status the flow does not declare. */
+/** @deprecated compat:factory-refactor — use `statusHelper.intrinsicOf(…)` */
 export declare const intrinsicOf: (flow: StatusFlowSchema, status: string) => IntrinsicStatus | undefined;
-/** The status marked `initial`, else the first one. @throws {PlanningError} for a flow with none */
+/** @deprecated compat:factory-refactor — use `statusHelper.initialStatusOf(…)` */
 export declare const initialStatusOf: (flow: StatusFlowSchema) => string;
+/** @deprecated compat:factory-refactor — use `statusHelper.isTerminal(…)` */
 export declare const isTerminal: (flow: StatusFlowSchema, status: string) => boolean;
-/**
- * The rule a named transition follows from a status.
- *
- * A name may be declared several times with different `from` sets; the rule naming the status
- * explicitly wins, and a `'*'` rule of that name answers only when none does.
- */
+/** @deprecated compat:factory-refactor — use `statusHelper.ruleOf(…)` */
 export declare const ruleOf: (flow: StatusFlowSchema, transition: string, from: string) => StatusTransitionRule | undefined;
+/** @deprecated compat:factory-refactor — use `statusHelper.canTransit(…)` */
 export declare const canTransit: (flow: StatusFlowSchema, transition: string, from: string) => boolean;
-/**
- * Every transition available from a status, one rule per name (the one `ruleOf` would pick), in
- * declaration order. `explicit: true` keeps only the rules offered to a person.
- */
+/** @deprecated compat:factory-refactor — use `statusHelper.transitionsFrom(…)` */
 export declare const transitionsFrom: (flow: StatusFlowSchema, status: string, opts?: {
     explicit?: boolean;
 }) => StatusTransitionRule[];
-/**
- * A new card's status per flow: every flow's initial status, with the primary one overridden by
- * `status` when the draft names one.
- *
- * @throws {UnknownStatusFlow}
- */
+/** @deprecated compat:factory-refactor — use `statusHelper.initialFlowsOf(…)` */
 export declare const initialFlowsOf: (type: AnyTypeSchema, registry: FlowLookup, status?: string) => Record<string, string>;
-/**
- * The card's intrinsic state over its flows. {@link IntrinsicPolicy.Primary} reads the primary
- * flow; {@link IntrinsicPolicy.All} takes the least advanced flow. A status the flow does not
- * declare reads as planned.
- *
- * @throws {UnknownStatusFlow}
- */
+/** @deprecated compat:factory-refactor — use `statusHelper.resolveIntrinsic(…)` */
 export declare const resolveIntrinsic: (type: AnyTypeSchema, flows: Record<string, string>, registry: FlowLookup) => IntrinsicStatus;
-export {};
 //# sourceMappingURL=status.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/helpers/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,eAAe,EAAE,MAAM,cAAc,CAAA;AAE5F,OAAO,KAAK,EACV,aAAa,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAChG,MAAM,aAAa,CAAA;AAEpB,KAAK,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAA;AAEtD,oGAAoG;AACpG,eAAO,MAAM,aAAa,SAAU,aAAa,KAAG,MAOnD,CAAA;AAED,eAAO,MAAM,SAAS,SAAU,aAAa,KAAG,MAAM,EAAqB,CAAA;AAE3E,eAAO,MAAM,kBAAkB,SAAU,gBAAgB,UAAU,MAAM,KAAG,gBAAgB,GAAG,SAClC,CAAA;AAE7D,qGAAqG;AACrG,eAAO,MAAM,WAAW,SAAU,gBAAgB,UAAU,MAAM,KAAG,eAAe,GAAG,SAC1C,CAAA;AAE7C,oGAAoG;AACpG,eAAO,MAAM,eAAe,SAAU,gBAAgB,KAAG,MAOxD,CAAA;AAED,eAAO,MAAM,UAAU,SAAU,gBAAgB,UAAU,MAAM,KAAG,OACf,CAAA;AAKrD;;;;;GAKG;AACH,eAAO,MAAM,MAAM,SACX,gBAAgB,cAAc,MAAM,QAAQ,MAAM,KACvD,oBAAoB,GAAG,SAKzB,CAAA;AAED,eAAO,MAAM,UAAU,SAAU,gBAAgB,cAAc,MAAM,QAAQ,MAAM,KAAG,OAC9C,CAAA;AAExC;;;GAGG;AACH,eAAO,MAAM,eAAe,SACpB,gBAAgB,UAAU,MAAM,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,KACpE,oBAAoB,EAMtB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,SACnB,aAAa,YAAY,UAAU,WAAW,MAAM,KACzD,MAAM,CAAC,MAAM,EAAE,MAAM,CAMvB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,SACrB,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,UAAU,KACvE,eAgBF,CAAA"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/helpers/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,eAAe,EAAE,MAAM,cAAc,CAAA;AAE5F,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAC1G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,eAAO,MAAM,kBAAkB,QAAO,YA0FrC,CAAA;AAED,eAAO,MAAM,YAAY,cAAuB,CAAA;AAEhD,gFAAgF;AAChF,eAAO,MAAM,aAAa,SAAU,aAAa,KAAG,MAA0C,CAAA;AAE9F,4EAA4E;AAC5E,eAAO,MAAM,SAAS,SAAU,aAAa,KAAG,MAAM,EAAkC,CAAA;AAExF,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,SAAU,gBAAgB,UAAU,MAAM,KAAG,gBAAgB,GAAG,SAChD,CAAA;AAE/C,8EAA8E;AAC9E,eAAO,MAAM,WAAW,SAAU,gBAAgB,UAAU,MAAM,KAAG,eAAe,GAAG,SAC/C,CAAA;AAExC,kFAAkF;AAClF,eAAO,MAAM,eAAe,SAAU,gBAAgB,KAAG,MAA4C,CAAA;AAErG,6EAA6E;AAC7E,eAAO,MAAM,UAAU,SAAU,gBAAgB,UAAU,MAAM,KAAG,OAAgD,CAAA;AAEpH,yEAAyE;AACzE,eAAO,MAAM,MAAM,SAAU,gBAAgB,cAAc,MAAM,QAAQ,MAAM,KAAG,oBAAoB,GAAG,SAC5D,CAAA;AAE7C,6EAA6E;AAC7E,eAAO,MAAM,UAAU,SAAU,gBAAgB,cAAc,MAAM,QAAQ,MAAM,KAAG,OACrC,CAAA;AAEjD,kFAAkF;AAClF,eAAO,MAAM,eAAe,SACpB,gBAAgB,UAAU,MAAM,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,KACpE,oBAAoB,EAAsD,CAAA;AAE7E,iFAAiF;AACjF,eAAO,MAAM,cAAc,SAAU,aAAa,YAAY,UAAU,WAAW,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAC5D,CAAA;AAErD,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,SACrB,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,UAAU,KACvE,eAAuE,CAAA"}