@appinternalleads/ui 0.2.0

package/dist/cjs/native/RiveReceiptStage.js

@@ -0,0 +1,180 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RiveReceiptStage = RiveReceiptStage;
+exports.NativeReceiptPrinter = NativeReceiptPrinter;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_native_1 = require("@rive-app/react-native");
+const core_1 = require("../core");
+const tokens_1 = require("../tokens");
+const ReceiptPaper_1 = require("../components/onboarding/receipt-printer/ReceiptPaper");
+const riv_1 = require("../components/onboarding/receipt-printer/riv");
+const ReceiptStage_types_1 = require("../components/onboarding/receipt-printer/ReceiptStage.types");
+const ReceiptPrinterView_1 = require("../components/onboarding/receipt-printer/ReceiptPrinterView");
+/**
+ * **The Receipt Printer's Rive printer, on iOS and Android** — the same `.riv`, the same feed, the
+ * same tear-off as the web, through `@rive-app/react-native` (which needs
+ * `react-native-nitro-modules`, and a `pod install`).
+ *
+ * It keeps the web stage's contract exactly (`ReceiptStage.web.tsx`): the lines go onto the
+ * `Receipt` view model before a trigger fires; a printed receipt that is tearing off keeps its text
+ * until the machine leaves it; `status` = `printed` says the paper is at rest; and if the runtime or
+ * the file cannot load, the still (`ReceiptPaper`) is drawn and a print completes at once. Two
+ * differences: the native runtime's view-model calls are asynchronous, so every write goes through
+ * one queue, in order; and a native view stops advancing once its machine settles, so every write
+ * and trigger is followed by `playIfNeeded()`. Found on Android: without it, Print again after a
+ * print fired the trigger into a paused view, and nothing moved.
+ *
+ * Its own entry point — importing it is the opt-in, and it pulls in nothing else native:
+ *
+ *   import { NativeReceiptPrinter } from '@comppack/ui/native/receipt-printer';
+ *   <NativeReceiptPrinter preset="case1" />
+ *   // or: <ReceiptPrinter stage={RiveReceiptStage} />
+ */
+const ARTBOARD = 'ReceiptPrinter';
+const MACHINE = 'ReceiptPrinterMachine';
+const LINE_KEYS = ['title', 'badge', 'total', 'meta', 'paymentMethod', 'message', 'paymentLabel', 'totalLabel'];
+let bytes = null;
+function rivBytes() {
+    if (!bytes) {
+        const bin = atob(riv_1.RECEIPT_PRINTER_RIV);
+        const out = new Uint8Array(bin.length);
+        for (let i = 0; i < bin.length; i++)
+            out[i] = bin.charCodeAt(i);
+        bytes = out.buffer;
+    }
+    return bytes;
+}
+/** One file per app: parsing 280 kB once is enough for every printer on every screen. */
+let filePromise = null;
+const loadFile = () => (filePromise ??= react_native_1.RiveFileFactory.fromBytes(rivBytes(), undefined, false)
+    /* A load that failed is not kept: the next printer to mount tries again. */
+    .catch(e => { filePromise = null; throw e; }));
+async function syncList(vm, path, model, rows) {
+    const list = vm.listProperty(path);
+    if (!list)
+        return;
+    let length = await list.getLengthAsync();
+    while (length > rows.length) {
+        await list.removeInstanceAtAsync(length - 1);
+        length--;
+    }
+    while (length < rows.length && model) {
+        const inst = await model.createBlankInstanceAsync();
+        if (!inst)
+            break;
+        await list.addInstanceAsync(inst);
+        length++;
+    }
+    for (let i = 0; i < rows.length; i++) {
+        const inst = await list.getInstanceAtAsync(i);
+        for (const [k, v] of Object.entries(rows[i]))
+            inst?.stringProperty(k)?.set(v);
+    }
+}
+async function writeLines(l, lines) {
+    for (const k of LINE_KEYS)
+        l.vm.stringProperty(k)?.set(lines[k]);
+    await syncList(l.vm, 'details', l.models.detail, lines.details);
+    await syncList(l.vm, 'items', l.models.item, lines.items);
+    l.vm.numberProperty('lineCount')?.set(Math.max(1, lines.items.length));
+    l.vm.numberProperty('detailCount')?.set(lines.details.length);
+}
+function RiveReceiptStage({ lines, job, phase, reduceMotion, onPrinted, label, maxWidth, testID }) {
+    const [loaded, setLoaded] = (0, react_1.useState)(null);
+    const [failed, setFailed] = (0, react_1.useState)(false);
+    const [shown, setShown] = (0, react_1.useState)({ lines: Math.max(1, lines.items.length), fields: lines.details.length });
+    const view = (0, react_1.useRef)(null);
+    const queue = (0, react_1.useRef)(Promise.resolve());
+    /* Every change to the view model, in order — then wake the view, which pauses once it settles. */
+    const enqueue = (work) => {
+        queue.current = queue.current.then(work).then(() => view.current?.playIfNeeded()).catch(() => { });
+    };
+    const status = (0, react_1.useRef)('idle');
+    const started = (0, react_1.useRef)(null);
+    const latest = (0, react_1.useRef)(lines);
+    latest.current = lines;
+    const printed = (0, react_1.useRef)(onPrinted);
+    printed.current = onPrinted;
+    const write = (l, next) => enqueue(async () => {
+        await writeLines(l, next);
+        setShown({ lines: Math.max(1, next.items.length), fields: next.details.length });
+    });
+    /* Load the file, make the `Receipt` instance this view binds, and listen to where the paper is. */
+    (0, react_1.useEffect)(() => {
+        let alive = true;
+        let stop;
+        (async () => {
+            const file = await loadFile();
+            const model = await file.viewModelByNameAsync('Receipt');
+            const vm = await model?.createDefaultInstanceAsync();
+            if (!vm)
+                throw new Error('The Receipt view model is missing.');
+            const l = {
+                file, vm,
+                models: { detail: await file.viewModelByNameAsync('ReceiptDetail'), item: await file.viewModelByNameAsync('ReceiptItem') },
+            };
+            /* The first lines go on before the view mounts, so its first frame is this receipt's length. */
+            await writeLines(l, latest.current);
+            if (!alive)
+                return;
+            setShown({ lines: Math.max(1, latest.current.items.length), fields: latest.current.details.length });
+            stop = vm.stringProperty('status')?.addListener(value => {
+                status.current = value;
+                /* Past a tear-off — a fresh feed, or the idle stub: the lines held back go on now. */
+                if (value === 'printing' || value === 'idle')
+                    write(l, latest.current);
+                if (value === 'printed' && started.current !== null)
+                    printed.current(started.current);
+            });
+            setLoaded(l);
+        })().catch(() => { if (alive)
+            setFailed(true); });
+        return () => { alive = false; stop?.(); };
+    }, []);
+    /* 1 · The lines — never onto a receipt on its way out (a reprint or a reset, with motion). */
+    (0, react_1.useEffect)(() => {
+        if (!loaded)
+            return;
+        loaded.vm.booleanProperty('reduceMotion')?.set(reduceMotion);
+        const leaving = status.current === 'tearing'
+            || (status.current === 'printed' && !reduceMotion && (phase === 'idle' || started.current !== job));
+        if (!leaving)
+            write(loaded, lines);
+    }, [loaded, lines, phase, job, reduceMotion]);
+    /* 2 · The phase, as triggers — queued behind the lines. Each job is started once. */
+    (0, react_1.useEffect)(() => {
+        if (!loaded)
+            return;
+        if (phase === 'idle') {
+            started.current = null;
+            enqueue(() => { if (status.current !== 'idle')
+                loaded.vm.triggerProperty('reset')?.trigger(); });
+            return;
+        }
+        if (started.current === job)
+            return;
+        started.current = job;
+        const reveal = reduceMotion || phase === 'printed';
+        enqueue(() => {
+            /* A reveal over a receipt already at rest changes no status: the new lines are this job's paper. */
+            if (reveal && status.current === 'printed') {
+                printed.current(job);
+                return;
+            }
+            loaded.vm.triggerProperty(reveal ? 'reveal' : 'print')?.trigger();
+        });
+    }, [loaded, phase, job, reduceMotion]);
+    /* Without the runtime, the still — and a print completes at once. */
+    (0, react_1.useEffect)(() => { if (failed && phase === 'printing')
+        onPrinted(job); }, [failed, phase, job]);
+    if (failed)
+        return (0, jsx_runtime_1.jsx)(ReceiptPaper_1.ReceiptPaper, { lines: lines, phase: phase, maxWidth: maxWidth, label: label, testID: testID });
+    return ((0, jsx_runtime_1.jsx)(core_1.Box, { testID: testID, role: "img", "aria-label": label, style: { width: '100%', maxWidth, aspectRatio: (0, ReceiptStage_types_1.stageAspect)(shown.lines, shown.fields), borderRadius: tokens_1.blockRadii.mid, overflow: 'hidden', backgroundColor: tokens_1.HUE.butter.hs }, children: loaded ? ((0, jsx_runtime_1.jsx)(react_native_1.RiveView, { file: loaded.file, artboardName: ARTBOARD, stateMachineName: MACHINE, dataBind: loaded.vm, autoPlay: true, fit: react_native_1.Fit.Contain, onError: () => setFailed(true), hybridRef: { f: (ref) => { view.current = ref; } }, style: { width: '100%', height: '100%' } })) : null }));
+}
+/** `ReceiptPrinter` with the animated Rive printer — for React Native apps that installed the runtime. */
+function NativeReceiptPrinter(props) {
+    return (0, jsx_runtime_1.jsx)(ReceiptPrinterView_1.ReceiptPrinter, { ...props, stage: RiveReceiptStage });
+}
+//# sourceMappingURL=RiveReceiptStage.js.map

package/dist/cjs/native/RiveReceiptStage.js.map

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

package/dist/cjs/native/index.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeDatePicker = exports.NativeSlider = void 0;
+/**
+ * **The OS-backed controls, and the only place this package names a native module.**
+ *
+ * `@comppack/ui` itself has no optional peers any more — the default `Slider` and `DatePicker` are
+ * built from React Native primitives, so an app that imports from the main entry point installs
+ * nothing beyond `react-native-svg` and `react-native-safe-area-context`.
+ *
+ * That word *optional* used to be untrue. A barrel export is a static import, so Metro resolved
+ * `@react-native-community/datetimepicker` on the first import of **anything** from this package,
+ * and a fresh app red-screened before drawing a card. Nothing caught it for weeks: all four
+ * consuming apps already had the peers installed for their own reasons.
+ *
+ * **This entry point is where the peers live now, and importing it is the opt-in.**
+ *
+ * ```ts
+ * // requires @react-native-community/slider and .../datetimepicker
+ * import { NativeSlider, NativeDatePicker } from '@comppack/ui/native';
+ * ```
+ *
+ * **The Receipt Printer's animated printer is NOT here** — it has its own entry point,
+ * `@comppack/ui/native/receipt-printer` (`RiveReceiptStage.tsx`), because it needs different peers
+ * (`@rive-app/react-native`, `react-native-nitro-modules`). Exported from this barrel, it would make
+ * every app that wants a native slider install Rive, and every app that wants the printer install
+ * the slider and the date picker — the defect this entry point exists to prevent, twice. Found by
+ * building a React Native app against the packed package (27 Sep 2026).
+ *
+ * Prefer these when you want the platform's own wheel and momentum — an iOS date wheel is a thing
+ * users recognise, and no primitive reimplementation is mistaken for it. Prefer the defaults when
+ * you would rather not add two pods to a build.
+ *
+ * ⚠ **Nothing in the main entry point may import this file**, or the peers stop being optional
+ * again. `tests/peers.test.ts` fails the build if it does.
+ */
+var NativeSlider_1 = require("./NativeSlider");
+Object.defineProperty(exports, "NativeSlider", { enumerable: true, get: function () { return NativeSlider_1.NativeSlider; } });
+var NativeDatePicker_1 = require("./NativeDatePicker");
+Object.defineProperty(exports, "NativeDatePicker", { enumerable: true, get: function () { return NativeDatePicker_1.NativeDatePicker; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/native/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/native/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

package/dist/cjs/next/config.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * **`next.config` for a package that renders through `react-native-web`.**
+ *
+ * Loaded by Node at build time, so this file imports **no React and no `react-native`** — that is
+ * why it is its own entry point (`@comppack/ui/next/config`) rather than part of `@comppack/ui/next`,
+ * which is a client component and would drag both into the config graph.
+ *
+ * It sets the same two things `docs/INTEGRATION.md` §2b sets for Vite, plus the one Metro and Vite
+ * both get for free.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withCompPack = withCompPack;
+/**
+ * The packages Next must hand to its own compiler rather than treat as pre-built.
+ *
+ * **`phosphor-react-native` is the one that is not optional.** Its `exports` map resolves to
+ * `.tsx` SOURCE — the deep-import trade documented in `src/core/Icon.tsx` — and webpack does not
+ * transpile TypeScript out of `node_modules` unless told to. Without it the build fails on the
+ * first glyph, in a file the consumer does not own.
+ */
+const TRANSPILE = [
+    '@comppack/ui',
+    'react-native-web',
+    'react-native-svg-web',
+    'phosphor-react-native',
+    'react-native-safe-area-context',
+];
+/**
+ * Wrap a Next config so `@comppack/ui` resolves the way Metro, Vitest, Storybook and the Vite demo
+ * already resolve it.
+ *
+ * ```js
+ * // next.config.mjs
+ * import { withCompPack } from '@comppack/ui/next/config';
+ * export default withCompPack({ reactStrictMode: true });
+ * ```
+ */
+function withCompPack(nextConfig = {}) {
+    return {
+        ...nextConfig,
+        transpilePackages: [
+            ...new Set([...(nextConfig.transpilePackages ?? []), ...TRANSPILE]),
+        ],
+        webpack(config, options) {
+            config.resolve.alias = {
+                ...config.resolve.alias,
+                /**
+                 * **The `$` is exact-match, and it is the whole point.**
+                 *
+                 * A bare `'react-native'` key matches by PREFIX in webpack exactly as a bare string alias
+                 * does in Vite, so it also rewrites `react-native/Libraries/Utilities/codegenNativeComponent`
+                 * — which `react-native-safe-area-context` imports — into a path under `react-native-web`
+                 * that does not exist. `vitest.config.ts` carries the same scar as a regex.
+                 */
+                'react-native$': 'react-native-web',
+                'react-native-svg$': 'react-native-svg-web',
+            };
+            /**
+             * **`.web.*` FIRST, or you silently get the native half of every split primitive.**
+             *
+             * `Slider` and `DatePicker` ship two halves each. The native ones are built from RN
+             * primitives, so under `react-native-web` they render and work — you just lose
+             * `<input type="range">`'s keyboard support and `<input type="date">`'s locale calendar,
+             * with nothing to report it. `LIBRARY-QUESTIONNAIRE.md` §10.3 #1 is this failure.
+             */
+            const existing = config.resolve.extensions ?? [];
+            config.resolve.extensions = [
+                ...['.web.js', '.web.jsx', '.web.ts', '.web.tsx'].filter(e => !existing.includes(e)),
+                ...existing,
+            ];
+            return typeof nextConfig.webpack === 'function'
+                ? nextConfig.webpack(config, options)
+                : config;
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/cjs/next/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/next/config.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAqDH,oCA0CC;AApED;;;;;;;GAOG;AACH,MAAM,SAAS,GAAG;IAChB,cAAc;IACd,kBAAkB;IAClB,sBAAsB;IACtB,uBAAuB;IACvB,gCAAgC;CACjC,CAAC;AAEF;;;;;;;;;GASG;AACH,SAAgB,YAAY,CAC1B,aAAgB,EAAO;IAEvB,OAAO;QACL,GAAG,UAAU;QACb,iBAAiB,EAAE;YACjB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,IAAI,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;SACpE;QACD,OAAO,CAAC,MAAqB,EAAE,OAAgB;YAC7C,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG;gBACrB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK;gBACvB;;;;;;;mBAOG;gBACH,eAAe,EAAE,kBAAkB;gBACnC,mBAAmB,EAAE,sBAAsB;aAC5C,CAAC;YAEF;;;;;;;eAOG;YACH,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;YACjD,MAAM,CAAC,OAAO,CAAC,UAAU,GAAG;gBAC1B,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACpF,GAAG,QAAQ;aACZ,CAAC;YAEF,OAAO,OAAO,UAAU,CAAC,OAAO,KAAK,UAAU;gBAC7C,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;gBACrC,CAAC,CAAC,MAAM,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cjs/next/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompPackRegistry = void 0;
+/**
+ * **Next.js support — the client half.**
+ *
+ * Its sibling `@comppack/ui/next/config` is the build half, and the two are separate entry points on
+ * purpose: `next.config` is loaded by Node, and this file is a client component that imports
+ * `react-native`. Merging them would put both into the config graph.
+ */
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "CompPackRegistry", { enumerable: true, get: function () { return registry_1.CompPackRegistry; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/next/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/next/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,uCAA8C;AAArC,4GAAA,gBAAgB,OAAA"}

package/dist/cjs/next/registry.js

@@ -0,0 +1,28 @@
+'use client';
+"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompPackRegistry = CompPackRegistry;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const navigation_1 = require("next/navigation");
+function CompPackRegistry({ children }) {
+    const flushed = (0, react_1.useRef)(false);
+    (0, navigation_1.useServerInsertedHTML)(() => {
+        if (flushed.current)
+            return null;
+        flushed.current = true;
+        /**
+         * A no-op root. `getApplication` is RNW's only public way to reach the sheet, and it requires
+         * a registered component — we want the styles, not the element, so the cheapest legal
+         * component is the one that renders nothing.
+         */
+        react_native_1.AppRegistry.registerComponent('comppack', () => () => null);
+        return react_native_1.AppRegistry
+            .getApplication('comppack', {})
+            .getStyleElement();
+    });
+    return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: children });
+}
+//# sourceMappingURL=registry.js.map

package/dist/cjs/next/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/next/registry.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAC;;AA6Cb,4CAmBC;;AA9DD,iCAA+C;AAC/C,+CAA2C;AAC3C,gDAAwD;AAyCxD,SAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAA2B;IACpE,MAAM,OAAO,GAAG,IAAA,cAAM,EAAC,KAAK,CAAC,CAAC;IAE9B,IAAA,kCAAqB,EAAC,GAAG,EAAE;QACzB,IAAI,OAAO,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QACjC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QAEvB;;;;WAIG;QACH,0BAAW,CAAC,iBAAiB,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5D,OAAQ,0BAAyC;aAC9C,cAAc,CAAC,UAAU,EAAE,EAAE,CAAC;aAC9B,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,OAAO,2DAAG,QAAQ,GAAI,CAAC;AACzB,CAAC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/runtime/operations/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * **The shared operations runtime.** `OperationStatus` · `useOperationRunner` · `abortableDelay` ·
+ * `resolveLatency`, plus the `AppError` model shared with `src/runtime/query`.
+ *
+ * Built for the File Upload engine, extracted here the moment a second family needed the same
+ * one-shot-command lifecycle — `components/checklist`. That was the documented trigger in
+ * `docs/architecture/COMPONENT-FAMILIES.md` §3. `src/widgets/fileUploadEngine.ts` keeps its entire
+ * public surface and now runs its transfers through this module.
+ *
+ * Nothing here knows about a transport. A host supplies the operation; this owns its lifecycle.
+ */
+__exportStar(require("./operations"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/runtime/operations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/operations/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;GAUG;AACH,+CAA6B"}

package/dist/cjs/runtime/operations/operations.js

@@ -0,0 +1,91 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toAppError = void 0;
+exports.useOperationRunner = useOperationRunner;
+exports.abortableDelay = abortableDelay;
+exports.resolveLatency = resolveLatency;
+const react_1 = require("react");
+const query_1 = require("../query");
+Object.defineProperty(exports, "toAppError", { enumerable: true, get: function () { return query_1.toAppError; } });
+/**
+ * Owns every in-flight operation of one component. Independent lifecycles keyed by id, and no
+ * shared epoch anywhere — that absence is the whole difference from `useQueryMachine`.
+ */
+function useOperationRunner() {
+    const controllers = (0, react_1.useRef)(new Map());
+    const mounted = (0, react_1.useRef)(true);
+    (0, react_1.useEffect)(() => {
+        mounted.current = true;
+        const live = controllers.current;
+        return () => {
+            mounted.current = false;
+            /* A component that can no longer receive a result must not leave requests running. */
+            for (const c of live.values())
+                c.abort();
+            live.clear();
+        };
+    }, []);
+    const run = (0, react_1.useCallback)((id, work, handlers) => {
+        controllers.current.get(id)?.abort();
+        const controller = new AbortController();
+        controllers.current.set(id, controller);
+        /* The real guard. Even an unaborted late response is discarded when it is no longer the
+           current attempt for its id — the File Upload engine's §19 rule, kept verbatim. */
+        const isCurrent = () => controllers.current.get(id) === controller && mounted.current;
+        work({ signal: controller.signal, isCurrent }).then(value => {
+            if (!isCurrent())
+                return;
+            controllers.current.delete(id);
+            handlers.onOk(value);
+        }, err => {
+            if (!isCurrent())
+                return;
+            if (controller.signal.aborted)
+                return; // a deliberate cancel, not a failure
+            controllers.current.delete(id);
+            handlers.onError((0, query_1.toAppError)(err));
+        });
+    }, []);
+    const cancel = (0, react_1.useCallback)((id) => {
+        controllers.current.get(id)?.abort();
+        controllers.current.delete(id);
+    }, []);
+    const isRunning = (0, react_1.useCallback)((id) => controllers.current.has(id), []);
+    const abortAll = (0, react_1.useCallback)(() => {
+        for (const c of controllers.current.values())
+            c.abort();
+        controllers.current.clear();
+    }, []);
+    return { run, cancel, isRunning, abortAll };
+}
+/**
+ * **The deterministic delay every mock operation is built from.** A timer that rejects the moment
+ * its signal aborts, and never a random one — `createMockAdapter` and `createMockUploadOperations`
+ * already hold that line (no `Math.random`, no `Date.now`), because a test that can make call 1
+ * slower than call 2 can *prove* race safety while a random one can only prove it usually.
+ */
+function abortableDelay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        const abort = () => reject(new DOMException('aborted', 'AbortError'));
+        if (signal.aborted) {
+            abort();
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => { clearTimeout(timer); abort(); };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/**
+ * Resolve a latency option that is either a fixed number or a function of the payload and the
+ * 0-based call index. The shape `MockAdapterOptions.latencyMs` established; shared so every mock
+ * in the library reads the same way.
+ */
+function resolveLatency(latency, payload, callIndex) {
+    return typeof latency === 'function' ? latency(payload, callIndex) : (latency ?? 0);
+}
+//# sourceMappingURL=operations.js.map

package/dist/cjs/runtime/operations/operations.js.map

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

package/dist/cjs/runtime/query/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * **The shared query runtime.** `errorModel` · `asyncOperation` · `epochGuard` · `DataAdapter` ·
+ * `MockAdapter` · `queryMachine` · the filter primitive.
+ *
+ * Built for the Output `list` renderer (`design_handoff_output_list`), extracted here the moment a
+ * second family needed it — `components/directory`. That was the documented trigger in
+ * `docs/architecture/COMPONENT-FAMILIES.md` §3: extract when ≥2 families genuinely need it, not
+ * before. `src/widgets/output/queryEngine.ts` is now a re-export of this module, so every existing
+ * `list` import and the package's public surface are unchanged.
+ *
+ * Nothing here knows about a transport. A host supplies a `DataAdapter`; this owns the lifecycle.
+ */
+__exportStar(require("./queryEngine"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/runtime/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/query/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;GAWG;AACH,gDAA8B"}