@owlmeans/viable-common 0.0.44 → 0.0.46

package/build/slot/utils.js

@@ -1,41 +1,6 @@
-import { COMMAND_DEADLINES, COMMAND_TIMEOUTS, DEFAULT_COMMAND_DEADLINE, DEFAULT_COMMAND_TIMEOUT, DEFAULT_FILE_COMMAND_DEADLINE, DEFAULT_GIT_COMMAND_DEADLINE, FILE_COMMAND_DEADLINES, FILE_COMMAND_TIMEOUTS, GIT_COMMAND_DEADLINES, GIT_COMMAND_TIMEOUTS, SHELL_COMMAND_TIMEOUTS, SlotCommandType } from './consts.js';
-/** The per-command caller bound for one command, or nothing where its type's default is right. */
-const perCommandTimeout = (type, command) => {
-    switch (type) {
-        case SlotCommandType.Shell: return SHELL_COMMAND_TIMEOUTS[command];
-        case SlotCommandType.Git: return GIT_COMMAND_TIMEOUTS[command];
-        case SlotCommandType.Database: return COMMAND_TIMEOUTS[SlotCommandType.Database];
-        default: return FILE_COMMAND_TIMEOUTS[command];
-    }
-};
-/**
- * Resolve the caller-side bound for one command.
- *
- * One function rather than three lookups at each call site: an asker that forgets the per-command
- * table inherits twenty minutes for a fifteen-second command, which is the failure this table was
- * added to stop.
- */
-export const commandTimeout = (type, command, override) => override
-    ?? perCommandTimeout(type, command)
-    ?? COMMAND_TIMEOUTS[type]
-    ?? DEFAULT_COMMAND_TIMEOUT;
-/**
- * Resolve the executor-side deadline for one command.
- *
- * Per-command first, per-type second. It was per-type only, which is how a clone inherited the
- * bound of a `git status` — the same shape as the shell table above, and added for the same
- * reason.
- */
-export const commandDeadline = (type, command) => {
-    switch (type) {
-        case SlotCommandType.Shell:
-            return COMMAND_DEADLINES[command] ?? DEFAULT_COMMAND_DEADLINE;
-        case SlotCommandType.Git:
-            return GIT_COMMAND_DEADLINES[command] ?? DEFAULT_GIT_COMMAND_DEADLINE;
-        case SlotCommandType.Database:
-            return 30_000;
-        default:
-            return FILE_COMMAND_DEADLINES[command] ?? DEFAULT_FILE_COMMAND_DEADLINE;
-    }
-};
+import { slotCommandHelper } from './command.js';
+/** @deprecated compat:factory-refactor — use `slotCommandHelper.commandTimeout(…)` */
+export const commandTimeout = (type, command, override) => slotCommandHelper.commandTimeout(type, command, override);
+/** @deprecated compat:factory-refactor — use `slotCommandHelper.commandDeadline(…)` */
+export const commandDeadline = (type, command) => slotCommandHelper.commandDeadline(type, command);
 //# sourceMappingURL=utils.js.map

package/build/slot/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/slot/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,eAAe,EAAmC,MAAM,aAAa,CAAA;AAEvV,kGAAkG;AAClG,MAAM,iBAAiB,GAAG,CAAC,IAAqB,EAAE,OAAe,EAAsB,EAAE;IACvF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,eAAe,CAAC,KAAK,EAAE,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAA;QAClE,KAAK,eAAe,CAAC,GAAG,EAAE,OAAO,oBAAoB,CAAC,OAAyB,CAAC,CAAA;QAChF,KAAK,eAAe,CAAC,QAAQ,EAAE,OAAO,gBAAgB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAA;QAChF,SAAS,OAAO,qBAAqB,CAAC,OAA0B,CAAC,CAAA;IACnE,CAAC;AACH,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAAqB,EAAE,OAAe,EAAE,QAAiB,EACjD,EAAE,CAAC,QAAQ;OAChB,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC;OAChC,gBAAgB,CAAC,IAAI,CAAC;OACtB,uBAAuB,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAqB,EAAE,OAAe,EAAU,EAAE;IAChF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,eAAe,CAAC,KAAK;YACxB,OAAO,iBAAiB,CAAC,OAAO,CAAC,IAAI,wBAAwB,CAAA;QAC/D,KAAK,eAAe,CAAC,GAAG;YACtB,OAAO,qBAAqB,CAAC,OAAyB,CAAC,IAAI,4BAA4B,CAAA;QACzF,KAAK,eAAe,CAAC,QAAQ;YAC3B,OAAO,MAAM,CAAA;QACf;YACE,OAAO,sBAAsB,CAAC,OAA0B,CAAC,IAAI,6BAA6B,CAAA;IAC9F,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/slot/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAGhD,sFAAsF;AACtF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAqB,EAAE,OAAe,EAAE,QAAiB,EAAU,EAAE,CAClG,iBAAiB,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;AAE3D,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAqB,EAAE,OAAe,EAAU,EAAE,CAChF,iBAAiB,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA"}

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

@@ -0,0 +1,21 @@
+import type { TopologyDescriptor, TopologyMeta } from '../types.js';
+/** The topology file `.agents/memory/topology.md`: its frontmatter, read and written, and its body. */
+export interface TopologyCardHelper {
+    /**
+     * Narrow a parsed frontmatter block into a topology, or answer `null`.
+     *
+     * `null` means "use the layout default", and every caller treats it that way. A topology file
+     * written by a platform version this one cannot read must not stop a project from building — the
+     * arrangement it describes is almost certainly still the default one.
+     */
+    parseTopologyMeta: (data: unknown) => TopologyDescriptor | null;
+    topologyMeta: (topology: TopologyDescriptor) => TopologyMeta;
+    /**
+     * The body of `.agents/memory/topology.md` — what a model reads, and what a person reads.
+     *
+     * Rendered from the descriptor rather than maintained beside it, for the same reason the layout
+     * tables are: a card that disagrees with the frontmatter teaches the wrong tree.
+     */
+    renderTopologyCard: (topology: TopologyDescriptor) => string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/topology/card/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEnE,uGAAuG;AACvG,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,kBAAkB,GAAG,IAAI,CAAA;IAC/D,YAAY,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,YAAY,CAAA;IAC5D;;;;;OAKG;IACH,kBAAkB,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,MAAM,CAAA;CAC7D"}

package/build/topology/card/types.js

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

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

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

package/build/topology/card.d.ts

@@ -1,18 +1,11 @@
 import type { TopologyDescriptor, TopologyMeta } from './types.js';
-/**
- * Narrow a parsed frontmatter block into a topology, or answer `null`.
- *
- * `null` means "use the layout default", and every caller treats it that way. A topology file
- * written by a platform version this one cannot read must not stop a project from building — the
- * arrangement it describes is almost certainly still the default one.
- */
+import type { TopologyCardHelper } from './card/types.js';
+export declare const createTopologyCardHelper: () => TopologyCardHelper;
+export declare const topologyCardHelper: TopologyCardHelper;
+/** @deprecated compat:factory-refactor — use `topologyCardHelper.parseTopologyMeta(…)` */
 export declare const parseTopologyMeta: (data: unknown) => TopologyDescriptor | null;
+/** @deprecated compat:factory-refactor — use `topologyCardHelper.topologyMeta(…)` */
 export declare const topologyMeta: (topology: TopologyDescriptor) => TopologyMeta;
-/**
- * The body of `.agents/memory/topology.md` — what a model reads, and what a person reads.
- *
- * Rendered from the descriptor rather than maintained beside it, for the same reason the layout
- * tables are: a card that disagrees with the frontmatter teaches the wrong tree.
- */
+/** @deprecated compat:factory-refactor — use `topologyCardHelper.renderTopologyCard(…)` */
 export declare const renderTopologyCard: (topology: TopologyDescriptor) => string;
 //# sourceMappingURL=card.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/topology/card.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA8C,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAoC9G;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,SAAU,OAAO,KAAG,kBAAkB,GAAG,IActE,CAAA;AAED,eAAO,MAAM,YAAY,aAAc,kBAAkB,KAAG,YAK1D,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,aAAc,kBAAkB,KAAG,MAuBjE,CAAA"}
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/topology/card.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA8C,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEzD,eAAO,MAAM,wBAAwB,QAAO,kBAkF3C,CAAA;AAED,eAAO,MAAM,kBAAkB,oBAA6B,CAAA;AAE5D,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,SAAU,OAAO,KAAG,kBAAkB,GAAG,IAAkD,CAAA;AAEzH,qFAAqF;AACrF,eAAO,MAAM,YAAY,aAAc,kBAAkB,KAAG,YAAyD,CAAA;AAErH,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,aAAc,kBAAkB,KAAG,MAAyD,CAAA"}

package/build/topology/card.js

@@ -1,93 +1,90 @@
 import { TOPOLOGY_VERSION } from './consts.js';
-import { orderPackages } from './helpers.js';
+import { topologyHelper } from './resolve.js';
 import { KINDS, ROLES } from './consts.local.js';
-const asStrings = (value) => Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
-/**
- * Read a package descriptor out of whatever the file held.
- *
- * Everything is narrowed rather than trusted: the file is on the target's volume, where a person,
- * a GitHub pull or a previous platform version may have written it. A descriptor that cannot be
- * narrowed is DROPPED, never repaired — a package with no name or no recognisable role would
- * otherwise resolve a path somewhere real and wrong.
- */
-const parsePackage = (value) => {
-    if (value == null || typeof value !== 'object')
-        return null;
-    const raw = value;
-    const name = typeof raw.name === 'string' ? raw.name.trim() : '';
-    if (name === '' || name.includes('/') || name.startsWith('.'))
-        return null;
-    const roles = asStrings(raw.roles).filter((role) => ROLES.has(role));
-    if (roles.length === 0)
-        return null;
-    const kind = KINDS.has(raw.kind) ? raw.kind : 'bundle';
-    const areas = asStrings(raw.areas);
-    const queues = asStrings(raw.queues);
-    return {
-        name,
-        roles,
-        kind,
-        dependsOn: asStrings(raw.dependsOn),
-        ...(areas.length > 0 ? { areas: areas } : {}),
-        ...(queues.length > 0 ? { queues } : {}),
+export const createTopologyCardHelper = () => {
+    const asStrings = (value) => Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
+    /**
+     * Read a package descriptor out of whatever the file held.
+     *
+     * Everything is narrowed rather than trusted: the file is on the target's volume, where a person,
+     * a GitHub pull or a previous platform version may have written it. A descriptor that cannot be
+     * narrowed is DROPPED, never repaired — a package with no name or no recognisable role would
+     * otherwise resolve a path somewhere real and wrong.
+     */
+    const parsePackage = (value) => {
+        if (value == null || typeof value !== 'object')
+            return null;
+        const raw = value;
+        const name = typeof raw.name === 'string' ? raw.name.trim() : '';
+        if (name === '' || name.includes('/') || name.startsWith('.'))
+            return null;
+        const roles = asStrings(raw.roles).filter((role) => ROLES.has(role));
+        if (roles.length === 0)
+            return null;
+        const kind = KINDS.has(raw.kind) ? raw.kind : 'bundle';
+        const areas = asStrings(raw.areas);
+        const queues = asStrings(raw.queues);
+        return {
+            name,
+            roles,
+            kind,
+            dependsOn: asStrings(raw.dependsOn),
+            ...(areas.length > 0 ? { areas: areas } : {}),
+            ...(queues.length > 0 ? { queues } : {}),
+        };
     };
-};
-/**
- * Narrow a parsed frontmatter block into a topology, or answer `null`.
- *
- * `null` means "use the layout default", and every caller treats it that way. A topology file
- * written by a platform version this one cannot read must not stop a project from building — the
- * arrangement it describes is almost certainly still the default one.
- */
-export const parseTopologyMeta = (data) => {
-    if (data == null || typeof data !== 'object')
-        return null;
-    const raw = data;
-    if (typeof raw.dir !== 'string' || raw.dir.trim() === '')
-        return null;
-    const packages = Array.isArray(raw.packages)
-        ? raw.packages.map(parsePackage).filter((pkg) => pkg != null)
-        : [];
-    if (packages.length === 0)
-        return null;
-    return {
-        id: typeof raw.id === 'string' && raw.id !== '' ? raw.id : 'recorded',
-        dir: raw.dir.trim(),
-        packages,
+    const parseTopologyMeta = (data) => {
+        if (data == null || typeof data !== 'object')
+            return null;
+        const raw = data;
+        if (typeof raw.dir !== 'string' || raw.dir.trim() === '')
+            return null;
+        const packages = Array.isArray(raw.packages)
+            ? raw.packages.map(parsePackage).filter((pkg) => pkg != null)
+            : [];
+        if (packages.length === 0)
+            return null;
+        return {
+            id: typeof raw.id === 'string' && raw.id !== '' ? raw.id : 'recorded',
+            dir: raw.dir.trim(),
+            packages,
+        };
     };
-};
-export const topologyMeta = (topology) => ({
-    ...topology,
-    packages: orderPackages(topology.packages),
-    version: TOPOLOGY_VERSION,
-    updatedAt: new Date().toISOString(),
-});
-/**
- * The body of `.agents/memory/topology.md` — what a model reads, and what a person reads.
- *
- * Rendered from the descriptor rather than maintained beside it, for the same reason the layout
- * tables are: a card that disagrees with the frontmatter teaches the wrong tree.
- */
-export const renderTopologyCard = (topology) => {
-    const ordered = orderPackages(topology.packages);
-    const rows = ordered.map(pkg => {
-        const deps = pkg.dependsOn.length > 0 ? pkg.dependsOn.join(', ') : '—';
-        const extra = [
-            ...(pkg.areas != null ? [`areas: ${pkg.areas.join(', ')}`] : []),
-            ...(pkg.queues != null ? [`queues: ${pkg.queues.join(', ')}`] : []),
-        ].join('; ');
-        return `| \`${topology.dir}/${pkg.name}\` | ${pkg.roles.join(', ')} | ${pkg.kind} | ${deps} | ${extra === '' ? '—' : extra} |`;
+    const topologyMeta = (topology) => ({
+        ...topology,
+        packages: topologyHelper.orderPackages(topology.packages),
+        version: TOPOLOGY_VERSION,
+        updatedAt: new Date().toISOString(),
     });
-    return [
-        '# Topology',
-        '',
-        'Which packages this project has, what each one is, and which compile against which.',
-        'Built in the order of the table — a `library` must be built before anything importing it.',
-        '',
-        '| Package | Roles | Kind | Depends on | Notes |',
-        '|---|---|---|---|---|',
-        ...rows,
-        '',
-    ].join('\n');
+    const renderTopologyCard = (topology) => {
+        const ordered = topologyHelper.orderPackages(topology.packages);
+        const rows = ordered.map(pkg => {
+            const deps = pkg.dependsOn.length > 0 ? pkg.dependsOn.join(', ') : '—';
+            const extra = [
+                ...(pkg.areas != null ? [`areas: ${pkg.areas.join(', ')}`] : []),
+                ...(pkg.queues != null ? [`queues: ${pkg.queues.join(', ')}`] : []),
+            ].join('; ');
+            return `| \`${topology.dir}/${pkg.name}\` | ${pkg.roles.join(', ')} | ${pkg.kind} | ${deps} | ${extra === '' ? '—' : extra} |`;
+        });
+        return [
+            '# Topology',
+            '',
+            'Which packages this project has, what each one is, and which compile against which.',
+            'Built in the order of the table — a `library` must be built before anything importing it.',
+            '',
+            '| Package | Roles | Kind | Depends on | Notes |',
+            '|---|---|---|---|---|',
+            ...rows,
+            '',
+        ].join('\n');
+    };
+    return { parseTopologyMeta, topologyMeta, renderTopologyCard };
 };
+export const topologyCardHelper = createTopologyCardHelper();
+/** @deprecated compat:factory-refactor — use `topologyCardHelper.parseTopologyMeta(…)` */
+export const parseTopologyMeta = (data) => topologyCardHelper.parseTopologyMeta(data);
+/** @deprecated compat:factory-refactor — use `topologyCardHelper.topologyMeta(…)` */
+export const topologyMeta = (topology) => topologyCardHelper.topologyMeta(topology);
+/** @deprecated compat:factory-refactor — use `topologyCardHelper.renderTopologyCard(…)` */
+export const renderTopologyCard = (topology) => topologyCardHelper.renderTopologyCard(topology);
 //# sourceMappingURL=card.js.map

package/build/topology/card.js.map

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

package/build/topology/helpers.d.ts

@@ -1,44 +1,18 @@
-import { TargetLayout } from '../integrity/consts.js';
 import type { ProjectArea } from '../areas/consts.js';
 import type { SubProject } from '../slot/consts.js';
 import type { ResolvedTopology, TargetPackageDescriptor, TopologyDescriptor } from './types.js';
-/**
- * Order the packages so that nothing is built before what it compiles against.
- *
- * Kahn's algorithm, with two deliberate tolerances. An edge to a package the topology does not
- * hold is DROPPED rather than fatal — a project may declare a dependency on something a pull has
- * not brought in yet, and refusing to order the tree would take the whole build down over one
- * name. A cycle leaves its members unvisited, and they are appended in declaration order: a cycle
- * cannot be built correctly in any order, so the useful behaviour is to build it in the order
- * somebody wrote rather than to throw.
- */
+/** @deprecated compat:factory-refactor — use `topologyHelper.orderPackages(…)` */
 export declare const orderPackages: (packages: TargetPackageDescriptor[]) => TargetPackageDescriptor[];
-/** Resolve the derived halves — build order, library order and the role index. */
+/** @deprecated compat:factory-refactor — use `topologyHelper.resolveTopology(…)` */
 export declare const resolveTopology: (topology: TopologyDescriptor) => ResolvedTopology;
-/** The default topology for a layout already decided. */
-export declare const topologyOf: (layout: TargetLayout) => TopologyDescriptor;
-/**
- * The directory a role names, or `null` when this topology has no package for it.
- *
- * `null` rather than the role's own name: a command aimed at a package the tree does not have must
- * fail where it is issued. Answering with a plausible directory runs it somewhere real and wrong,
- * which is how a type check once ran against the shared package instead of the one under repair.
- */
+/** @deprecated compat:factory-refactor — use `topologyHelper.packageForRole(…)` */
 export declare const packageForRole: (topology: ResolvedTopology, role: SubProject) => TargetPackageDescriptor | null;
-/** Every package holding a role — more than one only where a topology splits that role. */
-export declare const packagesForRole: (topology: ResolvedTopology, role: SubProject) => TargetPackageDescriptor[];
-/** The package serving an area, for a topology that splits the browser app across several. */
+/** @deprecated compat:factory-refactor — use `topologyHelper.packageForArea(…)` */
 export declare const packageForArea: (topology: ResolvedTopology, role: SubProject, area: ProjectArea) => TargetPackageDescriptor | null;
-/** `<dir>/<package>` — the only place a topology directory is composed. */
+/** @deprecated compat:factory-refactor — use `topologyHelper.packageDir(…)` */
 export declare const packageDir: (topology: TopologyDescriptor, pkg: TargetPackageDescriptor) => string;
-/**
- * Merge a package into a topology, by name.
- *
- * This is the ADOPTION path: a package that arrived with a GitHub pull is classified once and
- * recorded here, so the next run addresses the tree that exists rather than re-deriving one that
- * does not. Replacing by name rather than appending keeps a re-classification idempotent.
- */
+/** @deprecated compat:factory-refactor — use `topologyHelper.withPackage(…)` */
 export declare const withPackage: (topology: TopologyDescriptor, pkg: TargetPackageDescriptor) => TopologyDescriptor;
-/** Whether two topologies describe the same arrangement — used to skip a needless rewrite. */
+/** @deprecated compat:factory-refactor — use `topologyHelper.sameTopology(…)` */
 export declare const sameTopology: (a: TopologyDescriptor, b: TopologyDescriptor) => boolean;
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/topology/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,OAAO,KAAK,EACV,gBAAgB,EAAE,uBAAuB,EAAE,kBAAkB,EAC9D,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,aAAc,uBAAuB,EAAE,KAAG,uBAAuB,EA4C1F,CAAA;AAED,kFAAkF;AAClF,eAAO,MAAM,eAAe,aAAc,kBAAkB,KAAG,gBAgB9D,CAAA;AAED,yDAAyD;AACzD,eAAO,MAAM,UAAU,WAAY,YAAY,KAAG,kBACH,CAAA;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,aACf,gBAAgB,QAAQ,UAAU,KAC3C,uBAAuB,GAAG,IAA0C,CAAA;AAEvE,2FAA2F;AAC3F,eAAO,MAAM,eAAe,aAChB,gBAAgB,QAAQ,UAAU,KAC3C,uBAAuB,EAAiC,CAAA;AAE3D,8FAA8F;AAC9F,eAAO,MAAM,cAAc,aACf,gBAAgB,QAAQ,UAAU,QAAQ,WAAW,KAC9D,uBAAuB,GAAG,IAM5B,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,UAAU,aAAc,kBAAkB,OAAO,uBAAuB,KAAG,MACzD,CAAA;AAE/B;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,aACZ,kBAAkB,OAAO,uBAAuB,KACzD,kBAKD,CAAA;AAEF,8FAA8F;AAC9F,eAAO,MAAM,YAAY,MAAO,kBAAkB,KAAK,kBAAkB,KAAG,OAEtD,CAAA"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/topology/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/F,kFAAkF;AAClF,eAAO,MAAM,aAAa,aAAc,uBAAuB,EAAE,KAAG,uBAAuB,EACnD,CAAA;AAExC,oFAAoF;AACpF,eAAO,MAAM,eAAe,aAAc,kBAAkB,KAAG,gBACrB,CAAA;AAE1C,mFAAmF;AACnF,eAAO,MAAM,cAAc,aAAc,gBAAgB,QAAQ,UAAU,KAAG,uBAAuB,GAAG,IACzD,CAAA;AAE/C,mFAAmF;AACnF,eAAO,MAAM,cAAc,aACf,gBAAgB,QAAQ,UAAU,QAAQ,WAAW,KAC9D,uBAAuB,GAAG,IAA2D,CAAA;AAExF,+EAA+E;AAC/E,eAAO,MAAM,UAAU,aAAc,kBAAkB,OAAO,uBAAuB,KAAG,MAC9C,CAAA;AAE1C,gFAAgF;AAChF,eAAO,MAAM,WAAW,aAAc,kBAAkB,OAAO,uBAAuB,KAAG,kBAC9C,CAAA;AAE3C,iFAAiF;AACjF,eAAO,MAAM,YAAY,MAAO,kBAAkB,KAAK,kBAAkB,KAAG,OACzC,CAAA"}

package/build/topology/helpers.js

@@ -1,112 +1,16 @@
-import { LAYOUT_TOPOLOGIES, DEFAULT_TOPOLOGY } from './consts.js';
-/**
- * Order the packages so that nothing is built before what it compiles against.
- *
- * Kahn's algorithm, with two deliberate tolerances. An edge to a package the topology does not
- * hold is DROPPED rather than fatal — a project may declare a dependency on something a pull has
- * not brought in yet, and refusing to order the tree would take the whole build down over one
- * name. A cycle leaves its members unvisited, and they are appended in declaration order: a cycle
- * cannot be built correctly in any order, so the useful behaviour is to build it in the order
- * somebody wrote rather than to throw.
- */
-export const orderPackages = (packages) => {
-    const known = new Set(packages.map(pkg => pkg.name));
-    const index = new Map(packages.map((pkg, at) => [pkg.name, at]));
-    const pending = new Map(packages.map(pkg => [
-        pkg.name, pkg.dependsOn.filter(dep => known.has(dep) && dep !== pkg.name).length,
-    ]));
-    const dependents = new Map();
-    for (const pkg of packages) {
-        for (const dep of pkg.dependsOn) {
-            if (!known.has(dep) || dep === pkg.name)
-                continue;
-            dependents.set(dep, [...dependents.get(dep) ?? [], pkg.name]);
-        }
-    }
-    const byName = new Map(packages.map(pkg => [pkg.name, pkg]));
-    const out = [];
-    // Ready packages are taken in DECLARATION order, not in the order they became ready. Both are
-    // correct builds; only one is the same list every time and the same list a person wrote, and
-    // this order is compared against the shipped layout tables by a test.
-    const ready = packages.filter(pkg => pending.get(pkg.name) === 0).map(pkg => pkg.name);
-    const take = () => {
-        if (ready.length === 0)
-            return undefined;
-        let at = 0;
-        for (let i = 1; i < ready.length; i++) {
-            if ((index.get(ready[i]) ?? 0) < (index.get(ready[at]) ?? 0))
-                at = i;
-        }
-        return ready.splice(at, 1)[0];
-    };
-    for (let name = take(); name != null; name = take()) {
-        const pkg = byName.get(name);
-        if (pkg == null)
-            continue;
-        out.push(pkg);
-        for (const next of dependents.get(name) ?? []) {
-            const left = (pending.get(next) ?? 0) - 1;
-            pending.set(next, left);
-            if (left === 0)
-                ready.push(next);
-        }
-    }
-    const seen = new Set(out.map(pkg => pkg.name));
-    return [...out, ...packages.filter(pkg => !seen.has(pkg.name))];
-};
-/** Resolve the derived halves — build order, library order and the role index. */
-export const resolveTopology = (topology) => {
-    const ordered = orderPackages(topology.packages);
-    const byRole = {};
-    for (const pkg of ordered) {
-        for (const role of pkg.roles) {
-            byRole[role] = [...byRole[role] ?? [], pkg];
-        }
-    }
-    return {
-        ...topology,
-        packages: ordered,
-        build: ordered.map(pkg => pkg.name),
-        libraries: ordered.filter(pkg => pkg.kind === 'library').map(pkg => pkg.name),
-        byRole,
-    };
-};
-/** The default topology for a layout already decided. */
-export const topologyOf = (layout) => LAYOUT_TOPOLOGIES[layout] ?? DEFAULT_TOPOLOGY;
-/**
- * The directory a role names, or `null` when this topology has no package for it.
- *
- * `null` rather than the role's own name: a command aimed at a package the tree does not have must
- * fail where it is issued. Answering with a plausible directory runs it somewhere real and wrong,
- * which is how a type check once ran against the shared package instead of the one under repair.
- */
-export const packageForRole = (topology, role) => topology.byRole[role]?.[0] ?? null;
-/** Every package holding a role — more than one only where a topology splits that role. */
-export const packagesForRole = (topology, role) => topology.byRole[role] ?? [];
-/** The package serving an area, for a topology that splits the browser app across several. */
-export const packageForArea = (topology, role, area) => {
-    const candidates = packagesForRole(topology, role);
-    return candidates.find(pkg => pkg.areas?.includes(area) === true)
-        ?? candidates.find(pkg => pkg.areas == null)
-        ?? candidates[0]
-        ?? null;
-};
-/** `<dir>/<package>` — the only place a topology directory is composed. */
-export const packageDir = (topology, pkg) => `${topology.dir}/${pkg.name}`;
-/**
- * Merge a package into a topology, by name.
- *
- * This is the ADOPTION path: a package that arrived with a GitHub pull is classified once and
- * recorded here, so the next run addresses the tree that exists rather than re-deriving one that
- * does not. Replacing by name rather than appending keeps a re-classification idempotent.
- */
-export const withPackage = (topology, pkg) => ({
-    ...topology,
-    packages: topology.packages.some(known => known.name === pkg.name)
-        ? topology.packages.map(known => known.name === pkg.name ? pkg : known)
-        : [...topology.packages, pkg],
-});
-/** Whether two topologies describe the same arrangement — used to skip a needless rewrite. */
-export const sameTopology = (a, b) => JSON.stringify(orderPackages(a.packages)) === JSON.stringify(orderPackages(b.packages))
-    && a.dir === b.dir;
+import { topologyHelper } from './resolve.js';
+/** @deprecated compat:factory-refactor — use `topologyHelper.orderPackages(…)` */
+export const orderPackages = (packages) => topologyHelper.orderPackages(packages);
+/** @deprecated compat:factory-refactor — use `topologyHelper.resolveTopology(…)` */
+export const resolveTopology = (topology) => topologyHelper.resolveTopology(topology);
+/** @deprecated compat:factory-refactor — use `topologyHelper.packageForRole(…)` */
+export const packageForRole = (topology, role) => topologyHelper.packageForRole(topology, role);
+/** @deprecated compat:factory-refactor — use `topologyHelper.packageForArea(…)` */
+export const packageForArea = (topology, role, area) => topologyHelper.packageForArea(topology, role, area);
+/** @deprecated compat:factory-refactor — use `topologyHelper.packageDir(…)` */
+export const packageDir = (topology, pkg) => topologyHelper.packageDir(topology, pkg);
+/** @deprecated compat:factory-refactor — use `topologyHelper.withPackage(…)` */
+export const withPackage = (topology, pkg) => topologyHelper.withPackage(topology, pkg);
+/** @deprecated compat:factory-refactor — use `topologyHelper.sameTopology(…)` */
+export const sameTopology = (a, b) => topologyHelper.sameTopology(a, b);
 //# sourceMappingURL=helpers.js.map

package/build/topology/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/topology/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/topology/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAG7C,kFAAkF;AAClF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAmC,EAA6B,EAAE,CAC9F,cAAc,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;AAExC,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAA4B,EAAoB,EAAE,CAChF,cAAc,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAA;AAE1C,mFAAmF;AACnF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAA0B,EAAE,IAAgB,EAAkC,EAAE,CAC7G,cAAc,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;AAE/C,mFAAmF;AACnF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,QAA0B,EAAE,IAAgB,EAAE,IAAiB,EAC/B,EAAE,CAAC,cAAc,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAExF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAA4B,EAAE,GAA4B,EAAU,EAAE,CAC/F,cAAc,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;AAE1C,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAA4B,EAAE,GAA4B,EAAsB,EAAE,CAC5G,cAAc,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;AAE3C,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAqB,EAAE,CAAqB,EAAW,EAAE,CACpF,cAAc,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA"}

package/build/topology/index.d.ts

@@ -1,5 +1,8 @@
 export type * from './types.js';
+export type * from './resolve/types.js';
+export type * from './card/types.js';
 export * from './consts.js';
+export * from './resolve.js';
 export * from './helpers.js';
 export * from './card.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/build/topology/index.js

@@ -1,4 +1,5 @@
 export * from './consts.js';
+export * from './resolve.js';
 export * from './helpers.js';
 export * from './card.js';
 //# sourceMappingURL=index.js.map

package/build/topology/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/topology/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/topology/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}

package/build/topology/resolve/types.d.ts

@@ -0,0 +1,47 @@
+import type { ProjectArea } from '../../areas/consts.js';
+import type { TargetLayout } from '../../integrity/consts.js';
+import type { SubProject } from '../../slot/consts.js';
+import type { ResolvedTopology, TargetPackageDescriptor, TopologyDescriptor } from '../types.js';
+/** A target's package arrangement: build order, the role index, and where each package lives. */
+export interface TopologyHelper {
+    /**
+     * Order the packages so that nothing is built before what it compiles against.
+     *
+     * Kahn's algorithm, with two deliberate tolerances. An edge to a package the topology does not
+     * hold is DROPPED rather than fatal — a project may declare a dependency on something a pull has
+     * not brought in yet, and refusing to order the tree would take the whole build down over one
+     * name. A cycle leaves its members unvisited, and they are appended in declaration order: a cycle
+     * cannot be built correctly in any order, so the useful behaviour is to build it in the order
+     * somebody wrote rather than to throw.
+     */
+    orderPackages: (packages: TargetPackageDescriptor[]) => TargetPackageDescriptor[];
+    /** Resolve the derived halves — build order, library order and the role index. */
+    resolveTopology: (topology: TopologyDescriptor) => ResolvedTopology;
+    /** The default topology for a layout already decided. */
+    topologyOf: (layout: TargetLayout) => TopologyDescriptor;
+    /**
+     * The directory a role names, or `null` when this topology has no package for it.
+     *
+     * `null` rather than the role's own name: a command aimed at a package the tree does not have must
+     * fail where it is issued. Answering with a plausible directory runs it somewhere real and wrong,
+     * which is how a type check once ran against the shared package instead of the one under repair.
+     */
+    packageForRole: (topology: ResolvedTopology, role: SubProject) => TargetPackageDescriptor | null;
+    /** Every package holding a role — more than one only where a topology splits that role. */
+    packagesForRole: (topology: ResolvedTopology, role: SubProject) => TargetPackageDescriptor[];
+    /** The package serving an area, for a topology that splits the browser app across several. */
+    packageForArea: (topology: ResolvedTopology, role: SubProject, area: ProjectArea) => TargetPackageDescriptor | null;
+    /** `<dir>/<package>` — the only place a topology directory is composed. */
+    packageDir: (topology: TopologyDescriptor, pkg: TargetPackageDescriptor) => string;
+    /**
+     * Merge a package into a topology, by name.
+     *
+     * This is the ADOPTION path: a package that arrived with a GitHub pull is classified once and
+     * recorded here, so the next run addresses the tree that exists rather than re-deriving one that
+     * does not. Replacing by name rather than appending keeps a re-classification idempotent.
+     */
+    withPackage: (topology: TopologyDescriptor, pkg: TargetPackageDescriptor) => TopologyDescriptor;
+    /** Whether two topologies describe the same arrangement — used to skip a needless rewrite. */
+    sameTopology: (a: TopologyDescriptor, b: TopologyDescriptor) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map