@owlmeans/viable-common 0.0.44 → 0.0.46

package/build/convert/utils.d.ts

@@ -1,4 +1,5 @@
+/** @deprecated compat:factory-refactor — use `conversionDocHelper.conversionStoryDoc(…)` */
 export declare const conversionStoryDoc: (code: string) => string;
+/** @deprecated compat:factory-refactor — use `conversionDocHelper.conversionSeedDoc(…)` */
 export declare const conversionSeedDoc: (name: string) => string;
-export declare const conversionSeedData: (name: string, ext: string) => string;
 //# sourceMappingURL=utils.d.ts.map

package/build/convert/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/convert/utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,SAAU,MAAM,KAAG,MAA8C,CAAA;AAEhG,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,MAA6C,CAAA;AAE9F,eAAO,MAAM,kBAAkB,SAAU,MAAM,OAAO,MAAM,KAAG,MACjB,CAAA"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/convert/utils.ts"],"names":[],"mappings":"AAEA,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,SAAU,MAAM,KAAG,MAAsD,CAAA;AAExG,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,MAAqD,CAAA"}

package/build/convert/utils.js

@@ -1,5 +1,6 @@
-import { CONVERSION_SEED_DATA_DIR, CONVERSION_SEED_DIR, CONVERSION_STORY_DIR } from './consts.js';
-export const conversionStoryDoc = (code) => `${CONVERSION_STORY_DIR}/${code}.md`;
-export const conversionSeedDoc = (name) => `${CONVERSION_SEED_DIR}/${name}.md`;
-export const conversionSeedData = (name, ext) => `${CONVERSION_SEED_DATA_DIR}/${name}.${ext}`;
+import { conversionDocHelper } from './docs.js';
+/** @deprecated compat:factory-refactor — use `conversionDocHelper.conversionStoryDoc(…)` */
+export const conversionStoryDoc = (code) => conversionDocHelper.conversionStoryDoc(code);
+/** @deprecated compat:factory-refactor — use `conversionDocHelper.conversionSeedDoc(…)` */
+export const conversionSeedDoc = (name) => conversionDocHelper.conversionSeedDoc(name);
 //# sourceMappingURL=utils.js.map

package/build/convert/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/convert/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEjG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,GAAG,oBAAoB,IAAI,IAAI,KAAK,CAAA;AAEhG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,GAAG,mBAAmB,IAAI,IAAI,KAAK,CAAA;AAE9F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,GAAW,EAAU,EAAE,CACtE,GAAG,wBAAwB,IAAI,IAAI,IAAI,GAAG,EAAE,CAAA"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/convert/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAE/C,4FAA4F;AAC5F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;AAExG,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA"}

package/build/design/helpers.d.ts

@@ -1,64 +1,24 @@
 import type { UserStory } from '../ba/types.js';
-import { DesignStaleness } from './consts.js';
+import type { DesignStaleness } from './consts.js';
 import type { StoryDesign } from './types.js';
-/**
- * The in-memory aggregate the coders take, derived from the design ALONE.
- *
- * Derived rather than stored, and derived HERE rather than at the platform: the aggregate is what
- * every generation helper reads, and a second place that assembles it is a second place that can
- * assemble it differently. The `code` in particular is load-bearing - the scaffold stamps every
- * placeholder it draws with it, so a run keyed by anything else cannot recognise its own
- * reservation.
- *
- * For a context with no card behind it. Where a story card exists, `userStoryOf(card, design)` is
- * the reader: the card wins on the narrative, code, area and actor, which a person may have
- * changed since the design was written.
- */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.userStoryOfDesign(…)` */
 export declare const userStoryOfDesign: (design: StoryDesign) => UserStory;
-/** Screen name to component names - the shape every UX and UI prompt takes. */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.screenMapOf(…)` */
 export declare const screenMapOf: (design: StoryDesign) => Record<string, string[]>;
-/** Every path the design names, in the order the implementation stage visits them. */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designPaths(…)` */
 export declare const designPaths: (design: StoryDesign) => string[];
-/**
- * How far the world has moved since the design was written.
- *
- * Ordered by severity, and each answer has one correct reaction: a version mismatch REFUSES, a
- * changed narrative re-designs, a changed project warns and continues, a moved tree re-runs only
- * the stages that read the tree. Collapsing them into a boolean would make every one of those the
- * most expensive of the four.
- */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designStaleness(…)` */
 export declare const designStaleness: (design: StoryDesign, now: {
     narrativeHash: string;
     projectHash: string;
     registryHash: string;
 }) => DesignStaleness;
-/**
- * A stable, dependency-free hash of arbitrary text.
- *
- * FNV-1a, because what is being detected is "did this change", not "is this authentic" - and a
- * design record must be readable by a browser bundle, a worker and a test with no crypto import
- * between them.
- */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designHash(…)` */
 export declare const designHash: (...parts: Array<string | undefined>) => string;
-/** An empty design, so every stage can fill its own slice without inventing the shape. */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.emptyStoryDesign(…)` */
 export declare const emptyStoryDesign: (input: Pick<StoryDesign, 'code' | 'narrative' | 'area'> & Partial<StoryDesign>) => StoryDesign;
-/**
- * The design, small enough to hand a model, complete enough to act on.
- *
- * What a free-flight agent needs is names and counts: which screens exist, what is on them, which
- * types and endpoints the story implies. The UX and UI prose is the bulk of a design and none of
- * it helps an agent decide what to do next, so it is deliberately left out.
- */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designDigest(…)` */
 export declare const designDigest: (design: StoryDesign) => string;
-/**
- * Apply a patch to a design, refusing anything that would rename an allocated artifact.
- *
- * A path or an alias is registry-owned. Changing one behind the registry's back leaves two
- * spellings of the same thing in a project, and no number of fix attempts repairs that — the
- * compiler sees a missing module and the fixer, reasonably, renames the reference to match
- * whichever spelling it found first.
- *
- * Returns the reason as a STRING when it refuses, so a model can read it and take the other route.
- */
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.amendStoryDesign(…)` */
 export declare const amendStoryDesign: (design: StoryDesign, patch: Record<string, unknown>) => StoryDesign | string;
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/design/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuC,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACpF,OAAO,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,WAAY,WAAW,KAAG,SA2CvD,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,WAAW,WAAY,WAAW,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAKjE,CAAA;AAER,sFAAsF;AACtF,eAAO,MAAM,WAAW,WAAY,WAAW,KAAG,MAAM,EAQvD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,WAClB,WAAW,OACd;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,KACxE,eAeF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,aAAc,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,KAAG,MAShE,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,UACpB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,KAC7E,WAqBD,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,WAAY,WAAW,KAAG,MAqDlD,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,WACnB,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAClD,WAAW,GAAG,MA8BhB,CAAA"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/design/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,WAAY,WAAW,KAAG,SAAwD,CAAA;AAEhH,mFAAmF;AACnF,eAAO,MAAM,WAAW,WAAY,WAAW,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAA0C,CAAA;AAEnH,mFAAmF;AACnF,eAAO,MAAM,WAAW,WAAY,WAAW,KAAG,MAAM,EAA2C,CAAA;AAEnG,uFAAuF;AACvF,eAAO,MAAM,eAAe,WAClB,WAAW,OACd;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,KACxE,eAAiE,CAAA;AAEpE,kFAAkF;AAClF,eAAO,MAAM,UAAU,aAAc,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,KAAG,MAAgD,CAAA;AAEjH,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,UACpB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,KAC7E,WAAwD,CAAA;AAE3D,oFAAoF;AACpF,eAAO,MAAM,YAAY,WAAY,WAAW,KAAG,MAAgD,CAAA;AAEnG,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,WAAY,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,WAAW,GAAG,MAClD,CAAA"}

package/build/design/helpers.js

@@ -1,225 +1,18 @@
-import { SpecCategory } from '../ba/consts.js';
-import { DesignStaleness, STORY_DESIGN_VERSION } from './consts.js';
-/**
- * The in-memory aggregate the coders take, derived from the design ALONE.
- *
- * Derived rather than stored, and derived HERE rather than at the platform: the aggregate is what
- * every generation helper reads, and a second place that assembles it is a second place that can
- * assemble it differently. The `code` in particular is load-bearing - the scaffold stamps every
- * placeholder it draws with it, so a run keyed by anything else cannot recognise its own
- * reservation.
- *
- * For a context with no card behind it. Where a story card exists, `userStoryOf(card, design)` is
- * the reader: the card wins on the narrative, code, area and actor, which a person may have
- * changed since the design was written.
- */
-export const userStoryOfDesign = (design) => {
-    const componentOf = (name) => {
-        const component = design.components.find(entry => entry.name === name);
-        if (component == null) {
-            return null;
-        }
-        return {
-            name: component.name,
-            description: '',
-            specs: {
-                [SpecCategory.UX]: component.specs.ux,
-                [SpecCategory.UI]: component.specs.ui,
-            },
-            entities: component.entities.map(entity => ({
-                name: entity, description: '', attributes: [],
-            })),
-        };
-    };
-    const screens = design.screens.map(screen => ({
-        name: screen.name,
-        description: '',
-        ...(screen.section != null ? { section: screen.section } : {}),
-        specs: {
-            [SpecCategory.UX]: screen.specs.ux,
-            [SpecCategory.UI]: screen.specs.ui,
-        },
-        components: screen.components
-            .map(componentOf)
-            .filter((component) => component != null),
-    }));
-    return {
-        story: design.narrative,
-        code: design.code,
-        area: design.area,
-        entity: null,
-        entities: design.entities.map(entity => ({
-            name: entity.name, description: entity.description, attributes: [],
-        })),
-        screens,
-    };
-};
-/** Screen name to component names - the shape every UX and UI prompt takes. */
-export const screenMapOf = (design) => design.screens.reduce((map, screen) => {
-    map[screen.name] = [...screen.components];
-    return map;
-}, {});
-/** Every path the design names, in the order the implementation stage visits them. */
-export const designPaths = (design) => [
-    ...design.types.map(entry => entry.path),
-    ...design.resources.map(entry => entry.path),
-    ...design.models.map(entry => entry.path),
-    ...design.api.map(entry => entry.path),
-    ...design.stores.map(entry => entry.path),
-    ...design.components.flatMap(entry => [entry.viewModelPath, entry.path]),
-    ...design.screens.map(entry => entry.path),
-];
-/**
- * How far the world has moved since the design was written.
- *
- * Ordered by severity, and each answer has one correct reaction: a version mismatch REFUSES, a
- * changed narrative re-designs, a changed project warns and continues, a moved tree re-runs only
- * the stages that read the tree. Collapsing them into a boolean would make every one of those the
- * most expensive of the four.
- */
-export const designStaleness = (design, now) => {
-    if (design.version !== STORY_DESIGN_VERSION) {
-        return DesignStaleness.Version;
-    }
-    if (design.provenance.narrativeHash !== now.narrativeHash) {
-        return DesignStaleness.Narrative;
-    }
-    if (design.provenance.projectHash !== now.projectHash) {
-        return DesignStaleness.Project;
-    }
-    if (design.provenance.registryHash !== now.registryHash) {
-        return DesignStaleness.Tree;
-    }
-    return DesignStaleness.Fresh;
-};
-/**
- * A stable, dependency-free hash of arbitrary text.
- *
- * FNV-1a, because what is being detected is "did this change", not "is this authentic" - and a
- * design record must be readable by a browser bundle, a worker and a test with no crypto import
- * between them.
- */
-export const designHash = (...parts) => {
-    const text = parts.filter(part => part != null).join(' ');
-    let hash = 0x811c9dc5;
-    for (let at = 0; at < text.length; at += 1) {
-        hash ^= text.charCodeAt(at);
-        hash = Math.imul(hash, 0x01000193) >>> 0;
-    }
-    return hash.toString(16).padStart(8, '0');
-};
-/** An empty design, so every stage can fill its own slice without inventing the shape. */
-export const emptyStoryDesign = (input) => ({
-    version: STORY_DESIGN_VERSION,
-    reserved: {},
-    entities: [],
-    screens: [],
-    components: [],
-    types: [],
-    resources: [],
-    models: [],
-    api: [],
-    stores: [],
-    transitions: [],
-    access: { list: {}, resolvedAt: {} },
-    provenance: {
-        designedAt: new Date().toISOString(),
-        narrativeHash: '',
-        projectHash: '',
-        registryHash: '',
-        paths: [],
-    },
-    ...input,
-});
-/**
- * The design, small enough to hand a model, complete enough to act on.
- *
- * What a free-flight agent needs is names and counts: which screens exist, what is on them, which
- * types and endpoints the story implies. The UX and UI prose is the bulk of a design and none of
- * it helps an agent decide what to do next, so it is deliberately left out.
- */
-export const designDigest = (design) => {
-    const lines = [
-        `Story ${design.code} (${design.area}): ${design.narrative}`,
-    ];
-    if (design.reserved.section != null || design.reserved.screen != null) {
-        lines.push(`Reserved: section=${design.reserved.section ?? '-'} screen=${design.reserved.screen ?? '-'}`);
-    }
-    lines.push('', 'Screens:');
-    for (const screen of design.screens) {
-        lines.push(`- ${screen.name} -> ${screen.path} (alias ${screen.alias}`
-            + `${screen.section != null ? `, section ${screen.section}` : ''}`
-            + `${screen.adopted ? ', existing' : ''}) renders ${screen.components.join(', ') || '-'}`);
-    }
-    lines.push('', 'Components:');
-    for (const component of design.components) {
-        lines.push(`- ${component.name} -> ${component.path} (+ ${component.viewModelPath})`
-            + `${component.entities.length > 0 ? ` about ${component.entities.join(', ')}` : ''}`);
-    }
-    lines.push('', 'Data layer:');
-    for (const type of design.types) {
-        lines.push(`- type ${type.path} (${type.entity})`);
-    }
-    for (const resource of design.resources) {
-        lines.push(`- resource ${resource.path} (${resource.entity})`);
-    }
-    for (const model of design.models) {
-        lines.push(`- model ${model.path} (${model.entities.join(', ')})`);
-    }
-    for (const api of design.api) {
-        lines.push(`- api ${api.path} (${api.entity})`
-            + `${api.endpoints.length > 0 ? `: ${api.endpoints.map(e => e.alias).join(', ')}` : ''}`);
-    }
-    for (const store of design.stores) {
-        lines.push(`- store ${store.path} (${store.entity})`);
-    }
-    if (design.transitions.length > 0) {
-        lines.push('', 'Transitions:');
-        for (const transition of design.transitions) {
-            lines.push(`- ${transition.from} -> ${transition.to} (${transition.action})`);
-        }
-    }
-    const guarded = Object.keys(design.access.list);
-    if (guarded.length > 0) {
-        lines.push('', `Access declared on: ${guarded.join(', ')}`);
-    }
-    return lines.join('\n');
-};
-/**
- * Apply a patch to a design, refusing anything that would rename an allocated artifact.
- *
- * A path or an alias is registry-owned. Changing one behind the registry's back leaves two
- * spellings of the same thing in a project, and no number of fix attempts repairs that — the
- * compiler sees a missing module and the fixer, reasonably, renames the reference to match
- * whichever spelling it found first.
- *
- * Returns the reason as a STRING when it refuses, so a model can read it and take the other route.
- */
-export const amendStoryDesign = (design, patch) => {
-    const forbidden = [];
-    const checkList = (key, current, next) => {
-        if (!Array.isArray(next))
-            return;
-        for (const entry of next) {
-            const known = current.find(item => item.name === entry.name);
-            if (known == null)
-                continue;
-            if (entry.path != null && known.path != null && entry.path !== known.path) {
-                forbidden.push(`${key}.${String(entry.name)}.path`);
-            }
-            if (entry.alias != null && known.alias != null && entry.alias !== known.alias) {
-                forbidden.push(`${key}.${String(entry.name)}.alias`);
-            }
-        }
-    };
-    checkList('screens', design.screens, patch.screens);
-    checkList('components', design.components, patch.components);
-    if (forbidden.length > 0) {
-        return `Refused: ${forbidden.join(', ')} name artifacts the project's registry allocated. `
-            + 'A design may change what a screen or a component DOES - its UX, its UI, its section, its '
-            + 'endpoints - but never where it lives or what it is called. Rename through the registry, '
-            + 'or leave the name alone and change the behaviour.';
-    }
-    return { ...design, ...patch };
-};
+import { storyDesignHelper } from './story.js';
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.userStoryOfDesign(…)` */
+export const userStoryOfDesign = (design) => storyDesignHelper.userStoryOfDesign(design);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.screenMapOf(…)` */
+export const screenMapOf = (design) => storyDesignHelper.screenMapOf(design);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designPaths(…)` */
+export const designPaths = (design) => storyDesignHelper.designPaths(design);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designStaleness(…)` */
+export const designStaleness = (design, now) => storyDesignHelper.designStaleness(design, now);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designHash(…)` */
+export const designHash = (...parts) => storyDesignHelper.designHash(...parts);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.emptyStoryDesign(…)` */
+export const emptyStoryDesign = (input) => storyDesignHelper.emptyStoryDesign(input);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.designDigest(…)` */
+export const designDigest = (design) => storyDesignHelper.designDigest(design);
+/** @deprecated compat:factory-refactor — use `storyDesignHelper.amendStoryDesign(…)` */
+export const amendStoryDesign = (design, patch) => storyDesignHelper.amendStoryDesign(design, patch);
 //# sourceMappingURL=helpers.js.map

package/build/design/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/design/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/design/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAG9C,yFAAyF;AACzF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAmB,EAAa,EAAE,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAA;AAEhH,mFAAmF;AACnF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAmB,EAA4B,EAAE,CAAC,iBAAiB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AAEnH,mFAAmF;AACnF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAmB,EAAY,EAAE,CAAC,iBAAiB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AAEnG,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAAmB,EACnB,GAAyE,EACxD,EAAE,CAAC,iBAAiB,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAEpE,kFAAkF;AAClF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAG,KAAgC,EAAU,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,CAAA;AAEjH,wFAAwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,KAA8E,EACjE,EAAE,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;AAE3D,oFAAoF;AACpF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAmB,EAAU,EAAE,CAAC,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;AAEnG,wFAAwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAmB,EAAE,KAA8B,EAAwB,EAAE,CAC5G,iBAAiB,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA"}

package/build/design/index.d.ts

@@ -1,6 +1,9 @@
 export * from './consts.js';
+export * from './story.js';
 export * from './helpers.js';
 export * from './schemas.js';
 export type * from './types.js';
+export type * from './story/types.js';
+export type * from './runtime/types.js';
 export * from './runtime.js';
 //# sourceMappingURL=index.d.ts.map

package/build/design/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/design/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/design/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,oBAAoB,CAAA;AACvC,cAAc,cAAc,CAAA"}

package/build/design/index.js

@@ -1,4 +1,5 @@
 export * from './consts.js';
+export * from './story.js';
 export * from './helpers.js';
 export * from './schemas.js';
 export * from './runtime.js';

package/build/design/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/design/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAE5B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/design/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAI5B,cAAc,cAAc,CAAA"}

package/build/design/runtime/types.d.ts

@@ -0,0 +1,16 @@
+import type { StoryActor } from '../consts.js';
+import type { StoryDesignRuntime } from '../types.js';
+/**
+ * What a story needs BEYOND a screen, an endpoint and a table — and the standing answer is
+ * "nothing". See `design/runtime.ts`.
+ */
+export interface StoryRuntimeHelper {
+    isEphemeralActor: (actor?: StoryActor) => boolean;
+    /** Read the gate off a design, total over a design that predates it. */
+    runtimeOf: (design?: {
+        runtime?: StoryDesignRuntime;
+    }) => StoryDesignRuntime;
+    /** Whether anything at all was asked for — the one check every new step is gated on. */
+    needsRuntime: (runtime: StoryDesignRuntime) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/design/runtime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/design/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,CAAC,KAAK,CAAC,EAAE,UAAU,KAAK,OAAO,CAAA;IACjD,wEAAwE;IACxE,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,kBAAkB,CAAA;KAAE,KAAK,kBAAkB,CAAA;IAC5E,wFAAwF;IACxF,YAAY,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAA;CACvD"}

package/build/design/runtime/types.js

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

package/build/design/runtime/types.js.map

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

package/build/design/runtime.d.ts

@@ -15,11 +15,15 @@
  */
 import { StoryActor } from './consts.js';
 import type { StoryDesignRuntime } from './types.js';
+import type { StoryRuntimeHelper } from './runtime/types.js';
+export declare const createStoryRuntimeHelper: () => StoryRuntimeHelper;
+export declare const storyRuntimeHelper: StoryRuntimeHelper;
+/** @deprecated compat:factory-refactor — use `storyRuntimeHelper.isEphemeralActor(…)` */
 export declare const isEphemeralActor: (actor?: StoryActor) => boolean;
-/** Read the gate off a design, total over a design that predates it. */
+/** @deprecated compat:factory-refactor — use `storyRuntimeHelper.runtimeOf(…)` */
 export declare const runtimeOf: (design?: {
     runtime?: StoryDesignRuntime;
 }) => StoryDesignRuntime;
-/** Whether anything at all was asked for — the one check every new step is gated on. */
+/** @deprecated compat:factory-refactor — use `storyRuntimeHelper.needsRuntime(…)` */
 export declare const needsRuntime: (runtime: StoryDesignRuntime) => boolean;
 //# sourceMappingURL=runtime.d.ts.map

package/build/design/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/design/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAgC,UAAU,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD,eAAO,MAAM,gBAAgB,WAAY,UAAU,KAAG,OACH,CAAA;AAEnD,wEAAwE;AACxE,eAAO,MAAM,SAAS,YAAa;IAAE,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAAE,KAAG,kBACvC,CAAA;AAE/B,wFAAwF;AACxF,eAAO,MAAM,YAAY,YAAa,kBAAkB,KAAG,OACa,CAAA"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/design/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAgC,UAAU,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAE5D,eAAO,MAAM,wBAAwB,QAAO,kBAW3C,CAAA;AAED,eAAO,MAAM,kBAAkB,oBAA6B,CAAA;AAE5D,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,WAAY,UAAU,KAAG,OAAqD,CAAA;AAE3G,kFAAkF;AAClF,eAAO,MAAM,SAAS,YAAa;IAAE,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAAE,KAAG,kBAChC,CAAA;AAEtC,qFAAqF;AACrF,eAAO,MAAM,YAAY,YAAa,kBAAkB,KAAG,OAAmD,CAAA"}

package/build/design/runtime.js

@@ -14,9 +14,17 @@
  * emits exactly the tree it emitted before any of this existed.
  */
 import { EPHEMERAL_ACTORS, NO_RUNTIME } from './consts.js';
-export const isEphemeralActor = (actor) => actor != null && EPHEMERAL_ACTORS.includes(actor);
-/** Read the gate off a design, total over a design that predates it. */
-export const runtimeOf = (design) => design?.runtime ?? NO_RUNTIME;
-/** Whether anything at all was asked for — the one check every new step is gated on. */
-export const needsRuntime = (runtime) => runtime.worker || runtime.jobs.length > 0 || runtime.agents.length > 0;
+export const createStoryRuntimeHelper = () => {
+    const isEphemeralActor = (actor) => actor != null && EPHEMERAL_ACTORS.includes(actor);
+    const runtimeOf = (design) => design?.runtime ?? NO_RUNTIME;
+    const needsRuntime = (runtime) => runtime.worker || runtime.jobs.length > 0 || runtime.agents.length > 0;
+    return { isEphemeralActor, runtimeOf, needsRuntime };
+};
+export const storyRuntimeHelper = createStoryRuntimeHelper();
+/** @deprecated compat:factory-refactor — use `storyRuntimeHelper.isEphemeralActor(…)` */
+export const isEphemeralActor = (actor) => storyRuntimeHelper.isEphemeralActor(actor);
+/** @deprecated compat:factory-refactor — use `storyRuntimeHelper.runtimeOf(…)` */
+export const runtimeOf = (design) => storyRuntimeHelper.runtimeOf(design);
+/** @deprecated compat:factory-refactor — use `storyRuntimeHelper.needsRuntime(…)` */
+export const needsRuntime = (runtime) => storyRuntimeHelper.needsRuntime(runtime);
 //# sourceMappingURL=runtime.js.map

package/build/design/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/design/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAc,MAAM,aAAa,CAAA;AAGtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAkB,EAAW,EAAE,CAC9D,KAAK,IAAI,IAAI,IAAI,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAEnD,wEAAwE;AACxE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAyC,EAAsB,EAAE,CACzF,MAAM,EAAE,OAAO,IAAI,UAAU,CAAA;AAE/B,wFAAwF;AACxF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAA2B,EAAW,EAAE,CACnE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/design/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAc,MAAM,aAAa,CAAA;AAItE,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAuB,EAAE;IAC/D,MAAM,gBAAgB,GAAG,CAAC,KAAkB,EAAW,EAAE,CACvD,KAAK,IAAI,IAAI,IAAI,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEnD,MAAM,SAAS,GAAG,CAAC,MAAyC,EAAsB,EAAE,CAClF,MAAM,EAAE,OAAO,IAAI,UAAU,CAAA;IAE/B,MAAM,YAAY,GAAG,CAAC,OAA2B,EAAW,EAAE,CAC5D,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;IAExE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA;AACtD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,EAAE,CAAA;AAE5D,yFAAyF;AACzF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAkB,EAAW,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;AAE3G,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAyC,EAAsB,EAAE,CACzF,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;AAEtC,qFAAqF;AACrF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAA2B,EAAW,EAAE,CAAC,kBAAkB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA"}

package/build/design/story/types.d.ts

@@ -0,0 +1,67 @@
+import type { UserStory } from '../../ba/types.js';
+import type { DesignStaleness } from '../consts.js';
+import type { StoryDesign } from '../types.js';
+/** Reading, digesting, hashing and amending a story's design record. */
+export interface StoryDesignHelper {
+    /**
+     * The in-memory aggregate the coders take, derived from the design ALONE.
+     *
+     * Derived rather than stored, and derived HERE rather than at the platform: the aggregate is what
+     * every generation helper reads, and a second place that assembles it is a second place that can
+     * assemble it differently. The `code` in particular is load-bearing - the scaffold stamps every
+     * placeholder it draws with it, so a run keyed by anything else cannot recognise its own
+     * reservation.
+     *
+     * For a context with no card behind it. Where a story card exists, `userStoryOf(card, design)` is
+     * the reader: the card wins on the narrative, code, area and actor, which a person may have
+     * changed since the design was written.
+     */
+    userStoryOfDesign: (design: StoryDesign) => UserStory;
+    /** Screen name to component names - the shape every UX and UI prompt takes. */
+    screenMapOf: (design: StoryDesign) => Record<string, string[]>;
+    /** Every path the design names, in the order the implementation stage visits them. */
+    designPaths: (design: StoryDesign) => string[];
+    /**
+     * How far the world has moved since the design was written.
+     *
+     * Ordered by severity, and each answer has one correct reaction: a version mismatch REFUSES, a
+     * changed narrative re-designs, a changed project warns and continues, a moved tree re-runs only
+     * the stages that read the tree. Collapsing them into a boolean would make every one of those the
+     * most expensive of the four.
+     */
+    designStaleness: (design: StoryDesign, now: {
+        narrativeHash: string;
+        projectHash: string;
+        registryHash: string;
+    }) => DesignStaleness;
+    /**
+     * A stable, dependency-free hash of arbitrary text.
+     *
+     * FNV-1a, because what is being detected is "did this change", not "is this authentic" - and a
+     * design record must be readable by a browser bundle, a worker and a test with no crypto import
+     * between them.
+     */
+    designHash: (...parts: Array<string | undefined>) => string;
+    /** An empty design, so every stage can fill its own slice without inventing the shape. */
+    emptyStoryDesign: (input: Pick<StoryDesign, 'code' | 'narrative' | 'area'> & Partial<StoryDesign>) => StoryDesign;
+    /**
+     * The design, small enough to hand a model, complete enough to act on.
+     *
+     * What a free-flight agent needs is names and counts: which screens exist, what is on them, which
+     * types and endpoints the story implies. The UX and UI prose is the bulk of a design and none of
+     * it helps an agent decide what to do next, so it is deliberately left out.
+     */
+    designDigest: (design: StoryDesign) => string;
+    /**
+     * Apply a patch to a design, refusing anything that would rename an allocated artifact.
+     *
+     * A path or an alias is registry-owned. Changing one behind the registry's back leaves two
+     * spellings of the same thing in a project, and no number of fix attempts repairs that — the
+     * compiler sees a missing module and the fixer, reasonably, renames the reference to match
+     * whichever spelling it found first.
+     *
+     * Returns the reason as a STRING when it refuses, so a model can read it and take the other route.
+     */
+    amendStoryDesign: (design: StoryDesign, patch: Record<string, unknown>) => StoryDesign | string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/design/story/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/design/story/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;OAYG;IACH,iBAAiB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAA;IACrD,+EAA+E;IAC/E,WAAW,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC9D,sFAAsF;IACtF,WAAW,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,EAAE,CAAA;IAC9C;;;;;;;OAOG;IACH,eAAe,EAAE,CACf,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,KAC3F,eAAe,CAAA;IACpB;;;;;;OAMG;IACH,UAAU,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,KAAK,MAAM,CAAA;IAC3D,0FAA0F;IAC1F,gBAAgB,EAAE,CAChB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,KAC3E,WAAW,CAAA;IAChB;;;;;;OAMG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,CAAA;IAC7C;;;;;;;;;OASG;IACH,gBAAgB,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,WAAW,GAAG,MAAM,CAAA;CAChG"}

package/build/design/story/types.js

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

package/build/design/story/types.js.map

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

package/build/design/story.d.ts

@@ -0,0 +1,4 @@
+import type { StoryDesignHelper } from './story/types.js';
+export declare const createStoryDesignHelper: () => StoryDesignHelper;
+export declare const storyDesignHelper: StoryDesignHelper;
+//# sourceMappingURL=story.d.ts.map

package/build/design/story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.d.ts","sourceRoot":"","sources":["../../src/design/story.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,eAAO,MAAM,uBAAuB,QAAO,iBAoN1C,CAAA;AAED,eAAO,MAAM,iBAAiB,mBAA4B,CAAA"}