@happyvertical/smrt-manufacturing 0.53.5 → 0.54.0

package/dist/svelte/index.d.ts

@@ -2,10 +2,11 @@
  * @happyvertical/smrt-manufacturing/svelte
  *
  * Props-driven Svelte 5 surfaces: the managed list of operations (a list with
- * retire and reinstate, and a form), and assemblies (a list, a policy-driven
- * form, and a bill-of-materials editor whose sub-assemblies expand to their own
- * bills). Hosts load data through the package services and collections and
- * pass plain view objects.
+ * retire and reinstate, and a form), and assemblies (a list, a form, and a
+ * bill-of-materials editor whose sub-assemblies expand to their own bills),
+ * production runs with their progress and completion reporting, and
+ * the read-only exploded requirements of a bill. Hosts load data through the
+ * package services and collections and pass plain view objects.
  * Auto-registers components with ModuleUIRegistry on import.
  *
  * @packageDocumentation
@@ -17,12 +18,16 @@ import BomEditor from './components/BomEditor.svelte';
 import BomStructureTree from './components/BomStructureTree.svelte';
 import OperationForm from './components/OperationForm.svelte';
 import OperationList from './components/OperationList.svelte';
-export { AssemblyForm, AssemblyList, BomEditor, BomStructureTree, OperationForm, OperationList, };
+import ProductionRunList from './components/ProductionRunList.svelte';
+import RequirementsTree from './components/RequirementsTree.svelte';
+export { AssemblyForm, AssemblyList, BomEditor, BomStructureTree, OperationForm, OperationList, ProductionRunList, RequirementsTree, };
 export type AssemblyFormProps = ComponentProps<typeof AssemblyForm>;
 export type AssemblyListProps = ComponentProps<typeof AssemblyList>;
 export type BomEditorProps = ComponentProps<typeof BomEditor>;
 export type BomStructureTreeProps = ComponentProps<typeof BomStructureTree>;
 export type OperationFormProps = ComponentProps<typeof OperationForm>;
 export type OperationListProps = ComponentProps<typeof OperationList>;
-export { type AssemblyView, type BomComponentOption, type BomEditorLine, type BomLineDraft, type BomLineDraftField, type BomLineInput, type BomLineValidation, type ComponentKind, componentKindLabelKey, type OperationFormDraft, type OperationFormField, type OperationFormInitial, type OperationFormValidation, type OperationFormValues, type OperationView, operationStatusBadgeKey, splitLabourMinutes, toAssemblyView, toBomEditorLine, toBomEditorLines, validateBomLineInput, validateOperationForm, } from './types.js';
+export type ProductionRunListProps = ComponentProps<typeof ProductionRunList>;
+export type RequirementsTreeProps = ComponentProps<typeof RequirementsTree>;
+export { type AssemblyFieldPolicy, type AssemblyFormDraft, type AssemblyFormField, type AssemblyFormInitial, type AssemblyFormInvalidField, type AssemblyFormValidation, type AssemblyFormValues, type AssemblyView, assemblyFormDraft, type BomComponentOption, type BomEditorLine, type BomLineDraft, type BomLineDraftField, type BomLineInput, type BomLineValidation, type CompletionQtyValidation, type ComponentKind, componentKindLabelKey, currencyExponent, formatPriceInput, isProductionRunOpen, keepProtectedFields, type OperationFormDraft, type OperationFormField, type OperationFormInitial, type OperationFormValidation, type OperationFormValues, type OperationView, operationStatusBadgeKey, type ProductionRunStatus, type ProductionRunView, productionRunStatusLabelKey, productionRunStatusTone, type RequirementLineView, type RequirementTotalView, splitLabourMinutes, toAssemblyView, toBomEditorLine, toBomEditorLines, toProductionRunView, toRequirementTotals, toRequirementTree, validateAssemblyForm, validateBomLineInput, validateCompletionQty, validateOperationForm, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/svelte/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,YAAY,MAAM,kCAAkC,CAAC;AAC5D,OAAO,YAAY,MAAM,kCAAkC,CAAC;AAC5D,OAAO,SAAS,MAAM,+BAA+B,CAAC;AACtD,OAAO,gBAAgB,MAAM,sCAAsC,CAAC;AACpE,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAC9D,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAE9D,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC;AACpE,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE5E,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,aAAa,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,aAAa,CAAC,CAAC;AAEtE,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,YAAY,MAAM,kCAAkC,CAAC;AAC5D,OAAO,YAAY,MAAM,kCAAkC,CAAC;AAC5D,OAAO,SAAS,MAAM,+BAA+B,CAAC;AACtD,OAAO,gBAAgB,MAAM,sCAAsC,CAAC;AACpE,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAC9D,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAC9D,OAAO,iBAAiB,MAAM,uCAAuC,CAAC;AACtE,OAAO,gBAAgB,MAAM,sCAAsC,CAAC;AAEpE,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC;AACpE,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE5E,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,aAAa,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,aAAa,CAAC,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE5E,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,2BAA2B,EAC3B,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/svelte/index.js

@@ -2,10 +2,11 @@
  * @happyvertical/smrt-manufacturing/svelte
  *
  * Props-driven Svelte 5 surfaces: the managed list of operations (a list with
- * retire and reinstate, and a form), and assemblies (a list, a policy-driven
- * form, and a bill-of-materials editor whose sub-assemblies expand to their own
- * bills). Hosts load data through the package services and collections and
- * pass plain view objects.
+ * retire and reinstate, and a form), and assemblies (a list, a form, and a
+ * bill-of-materials editor whose sub-assemblies expand to their own bills),
+ * production runs with their progress and completion reporting, and
+ * the read-only exploded requirements of a bill. Hosts load data through the
+ * package services and collections and pass plain view objects.
  * Auto-registers components with ModuleUIRegistry on import.
  *
  * @packageDocumentation
@@ -18,8 +19,10 @@ import BomEditor from './components/BomEditor.svelte';
 import BomStructureTree from './components/BomStructureTree.svelte';
 import OperationForm from './components/OperationForm.svelte';
 import OperationList from './components/OperationList.svelte';
-export { AssemblyForm, AssemblyList, BomEditor, BomStructureTree, OperationForm, OperationList, };
-export { componentKindLabelKey, operationStatusBadgeKey, splitLabourMinutes, toAssemblyView, toBomEditorLine, toBomEditorLines, validateBomLineInput, validateOperationForm, } from './types.js';
+import ProductionRunList from './components/ProductionRunList.svelte';
+import RequirementsTree from './components/RequirementsTree.svelte';
+export { AssemblyForm, AssemblyList, BomEditor, BomStructureTree, OperationForm, OperationList, ProductionRunList, RequirementsTree, };
+export { assemblyFormDraft, componentKindLabelKey, currencyExponent, formatPriceInput, isProductionRunOpen, keepProtectedFields, operationStatusBadgeKey, productionRunStatusLabelKey, productionRunStatusTone, splitLabourMinutes, toAssemblyView, toBomEditorLine, toBomEditorLines, toProductionRunView, toRequirementTotals, toRequirementTree, validateAssemblyForm, validateBomLineInput, validateCompletionQty, validateOperationForm, } from './types.js';
 // Auto-register with ModuleUIRegistry
 ModuleUIRegistry.registerModule(MANUFACTURING_MODULE_META);
 ModuleUIRegistry.register('@happyvertical/smrt-manufacturing', 'operation-list', OperationList);
@@ -27,3 +30,5 @@ ModuleUIRegistry.register('@happyvertical/smrt-manufacturing', 'operation-form',
 ModuleUIRegistry.register('@happyvertical/smrt-manufacturing', 'assembly-list', AssemblyList);
 ModuleUIRegistry.register('@happyvertical/smrt-manufacturing', 'assembly-form', AssemblyForm);
 ModuleUIRegistry.register('@happyvertical/smrt-manufacturing', 'bom-editor', BomEditor);
+ModuleUIRegistry.register('@happyvertical/smrt-manufacturing', 'production-run-list', ProductionRunList);
+ModuleUIRegistry.register('@happyvertical/smrt-manufacturing', 'requirements-tree', RequirementsTree);

package/dist/svelte/types.d.ts

@@ -5,7 +5,9 @@
  * data across the server/client boundary.
  */
 import type { Assembly } from '../models/Assembly.js';
+import type { ProductionRun, ProductionRunStatus } from '../models/ProductionRun.js';
 import type { BillStructure, BillStructureLine, ComponentKind } from '../services/AssemblyService.js';
+import type { Explosion, RequirementsPlan } from '../types.js';
 /** One row of `OperationList`; an `Operation` satisfies it. */
 export interface OperationView {
     /** The `Operation` id. */
@@ -56,6 +58,101 @@ export interface OperationFormDraft {
 export declare function operationStatusBadgeKey(isActive: boolean): string;
 /** Trim a form draft and check the required fields: code and name. */
 export declare function validateOperationForm(draft: Readonly<Partial<OperationFormDraft>>): OperationFormValidation;
+/**
+ * The part of a resolved field policy `AssemblyList` reads: each field's
+ * visibility. smrt-fields' `ResolvedObjectFieldPolicy` satisfies it.
+ */
+export interface AssemblyFieldPolicy {
+    fields: Readonly<Record<string, {
+        visibility?: string;
+    } | undefined>>;
+}
+/** A field of `AssemblyForm`, named as `Assembly` and `Product` name it. */
+export type AssemblyFormField = 'name' | 'description' | 'category' | 'partReference' | 'price' | 'estimatedLabourMinutes' | 'defaultOperationId' | 'tags';
+/** Existing values passed to `AssemblyForm` when editing; an `Assembly` satisfies it. */
+export interface AssemblyFormInitial {
+    name: string;
+    description: string;
+    category: string;
+    partReference: string;
+    /** Catalog price in integer minor units (cents). */
+    price: number;
+    /** Labour to build one unit, in whole minutes. */
+    estimatedLabourMinutes: number;
+    /** The default `Operation` id, or `null` for none. */
+    defaultOperationId: string | null;
+    tags: readonly string[];
+}
+/**
+ * What `AssemblyForm` hands to `onsubmit`; text is trimmed. A hidden or
+ * read-only field carries its initial value unchanged (a default for a new
+ * assembly), so a host can save every key or only the ones that differ.
+ */
+export interface AssemblyFormValues {
+    name: string;
+    description: string;
+    category: string;
+    partReference: string;
+    /** Integer minor units (cents). */
+    price: number;
+    /** A whole number of minutes, zero or more. */
+    estimatedLabourMinutes: number;
+    /** The chosen `Operation` id, or `null` for none. */
+    defaultOperationId: string | null;
+    tags: string[];
+}
+/** A field `validateAssemblyForm` can reject. */
+export type AssemblyFormInvalidField = 'name' | 'price' | 'estimatedLabourMinutes';
+/** The raw text `AssemblyForm` collects, before trimming and checks. */
+export interface AssemblyFormDraft {
+    name: string;
+    description: string;
+    category: string;
+    partReference: string;
+    /** Major units as typed, e.g. `1250.00`. */
+    price: string;
+    estimatedLabourMinutes: string;
+    /** Empty for none. */
+    defaultOperationId: string;
+    /** Comma-separated. */
+    tags: string;
+}
+/** Result of {@link validateAssemblyForm}. */
+export type AssemblyFormValidation = {
+    ok: true;
+    values: AssemblyFormValues;
+} | {
+    ok: false;
+    invalid: AssemblyFormInvalidField[];
+};
+/**
+ * The number of decimal places in a currency's minor unit (2 for USD, 0 for
+ * JPY, 3 for KWD), as `Intl` knows it; 2 when the code is not recognized.
+ */
+export declare function currencyExponent(currency: string): number;
+/**
+ * Format integer minor units as the major-unit text the price field shows,
+ * with `exponent` decimals. A negative value keeps its sign so validation
+ * reports it instead of replacing it.
+ */
+export declare function formatPriceInput(minorUnits: number, exponent?: number): string;
+/** The draft `AssemblyForm` starts from for an assembly, or a blank one. */
+export declare function assemblyFormDraft(initial: AssemblyFormInitial | null, exponent?: number): AssemblyFormDraft;
+/**
+ * `values` with every field in `protectedFields` replaced by its initial
+ * value, exactly as stored (not trimmed or re-split), or its default for a
+ * new assembly. A hidden or read-only field is never rewritten by the form.
+ */
+export declare function keepProtectedFields(values: AssemblyFormValues, initial: AssemblyFormInitial | null, protectedFields: readonly AssemblyFormField[]): AssemblyFormValues;
+/**
+ * Trim a form draft and check it the way the model does: the name is
+ * required, the labour estimate is a whole number of minutes of zero or more
+ * (empty counts as zero), and the price is an amount of zero or more with at
+ * most `exponent` decimals (empty counts as zero; 2 unless the currency says
+ * otherwise). Fields in `skip` (hidden or
+ * read-only in the form) are not checked.
+ */
+export declare function validateAssemblyForm(draft: Readonly<Partial<AssemblyFormDraft>>, skip?: readonly AssemblyFormField[], exponent?: number): AssemblyFormValidation;
 export type { ComponentKind };
 /** One row of {@link AssemblyList}. */
 export interface AssemblyView {
@@ -167,4 +264,89 @@ export declare function splitLabourMinutes(minutes: number): {
     hours: number;
     minutes: number;
 };
+export type { ProductionRunStatus };
+/** One row of `ProductionRunList`. */
+export interface ProductionRunView {
+    /** The run id. */
+    id: string;
+    /** What is being built, as the host names it (an assembly's name, say). */
+    label: string;
+    /** Units to build. */
+    targetQty: number;
+    /** Units reported done. */
+    completedQty: number;
+    /** The run's status. */
+    status: ProductionRunStatus;
+}
+/** Adapt a `ProductionRun` to a {@link ProductionRunView}, with the host's label. */
+export declare function toProductionRunView(run: Pick<ProductionRun, 'id' | 'targetQty' | 'completedQty' | 'status'>, label: string): ProductionRunView;
+/** The message key naming a run status in words. */
+export declare function productionRunStatusLabelKey(status: ProductionRunStatus): "manufacturing.production_run_status.planned" | "manufacturing.production_run_status.in_progress" | "manufacturing.production_run_status.done" | "manufacturing.production_run_status.cancelled";
+/** The `StatusBadge` tone for a run status. */
+export declare function productionRunStatusTone(status: ProductionRunStatus): 'neutral' | 'info' | 'success' | 'warning';
+/** `true` while a run can still take completions. */
+export declare function isProductionRunOpen(status: ProductionRunStatus): boolean;
+/** Result of {@link validateCompletionQty}. */
+export type CompletionQtyValidation = {
+    ok: true;
+    qty: number;
+} | {
+    ok: false;
+    reason: 'invalid' | 'too_many';
+};
+/**
+ * Check a typed completion quantity against what the run has left (the
+ * service checks again under its lock).
+ */
+export declare function validateCompletionQty(raw: string, run: Pick<ProductionRunView, 'targetQty' | 'completedQty'>): CompletionQtyValidation;
+/** One line of `RequirementsTree`, with the lines of its bill when opened. */
+export interface RequirementLineView {
+    /** Unique within the tree: the bills above it plus the line id. */
+    key: string;
+    /** 1 for the top bill's lines. */
+    level: number;
+    /** Component name; empty when it cannot be resolved. */
+    name: string;
+    /** Component SKU code; empty when unknown. */
+    skuCode: string;
+    /** What the component is. */
+    kind: ComponentKind;
+    /** Quantity required for the run (net of stock in a plan). */
+    required: number;
+    /** The line's unit. */
+    uom: string;
+    /** Unallocated available stock; `null` for a gross explosion. */
+    available: number | null;
+    /** How much is short; `null` for a gross explosion. */
+    short: number | null;
+    /** A sub-assembly with an active bill. */
+    buildable: boolean;
+    /** The lines of this sub-assembly's bill that were walked. */
+    children: RequirementLineView[];
+}
+/** One row of the totals table of `RequirementsTree`. */
+export interface RequirementTotalView {
+    /** The component SKU. */
+    componentSkuId: string;
+    /** Component name; empty when it cannot be resolved. */
+    name: string;
+    /** Component SKU code; empty when unknown. */
+    skuCode: string;
+    /** Total required, summed over the lines not opened. */
+    required: number;
+    /** The first line's unit. */
+    uom: string;
+    /** Total short; `null` for a gross explosion. */
+    short: number | null;
+}
+/**
+ * Nest the depth-first lines of an {@link Explosion} or a
+ * {@link RequirementsPlan} for `RequirementsTree`.
+ */
+export declare function toRequirementTree(source: Pick<Explosion | RequirementsPlan, 'lines'>): RequirementLineView[];
+/**
+ * The totals of an {@link Explosion} or a {@link RequirementsPlan}: every line
+ * not opened, summed per component SKU (first unit kept).
+ */
+export declare function toRequirementTotals(source: Pick<Explosion | RequirementsPlan, 'lines'>): RequirementTotalView[];
 //# sourceMappingURL=types.d.ts.map

package/dist/svelte/types.d.ts.map

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

package/dist/svelte/types.js

@@ -33,6 +33,133 @@ export function validateOperationForm(draft) {
         },
     };
 }
+/**
+ * The number of decimal places in a currency's minor unit (2 for USD, 0 for
+ * JPY, 3 for KWD), as `Intl` knows it; 2 when the code is not recognized.
+ */
+export function currencyExponent(currency) {
+    try {
+        return (new Intl.NumberFormat('en', {
+            style: 'currency',
+            currency,
+        }).resolvedOptions().maximumFractionDigits ?? 2);
+    }
+    catch {
+        return 2;
+    }
+}
+/**
+ * Format integer minor units as the major-unit text the price field shows,
+ * with `exponent` decimals. A negative value keeps its sign so validation
+ * reports it instead of replacing it.
+ */
+export function formatPriceInput(minorUnits, exponent = 2) {
+    if (!Number.isSafeInteger(minorUnits))
+        return formatPriceInput(0, exponent);
+    const sign = minorUnits < 0 ? '-' : '';
+    const abs = Math.abs(minorUnits);
+    if (exponent <= 0)
+        return `${sign}${abs}`;
+    const scale = 10 ** exponent;
+    const whole = Math.floor(abs / scale);
+    return `${sign}${whole}.${String(abs - whole * scale).padStart(exponent, '0')}`;
+}
+/** The draft `AssemblyForm` starts from for an assembly, or a blank one. */
+export function assemblyFormDraft(initial, exponent = 2) {
+    return {
+        name: initial?.name ?? '',
+        description: initial?.description ?? '',
+        category: initial?.category ?? '',
+        partReference: initial?.partReference ?? '',
+        price: formatPriceInput(initial?.price ?? 0, exponent),
+        estimatedLabourMinutes: String(initial?.estimatedLabourMinutes ?? 0),
+        defaultOperationId: initial?.defaultOperationId ?? '',
+        tags: (initial?.tags ?? []).join(', '),
+    };
+}
+/**
+ * `values` with every field in `protectedFields` replaced by its initial
+ * value, exactly as stored (not trimmed or re-split), or its default for a
+ * new assembly. A hidden or read-only field is never rewritten by the form.
+ */
+export function keepProtectedFields(values, initial, protectedFields) {
+    const kept = { ...values };
+    const original = {
+        name: initial?.name ?? '',
+        description: initial?.description ?? '',
+        category: initial?.category ?? '',
+        partReference: initial?.partReference ?? '',
+        price: initial?.price ?? 0,
+        estimatedLabourMinutes: initial?.estimatedLabourMinutes ?? 0,
+        defaultOperationId: initial?.defaultOperationId ?? null,
+        tags: [...(initial?.tags ?? [])],
+    };
+    for (const field of protectedFields) {
+        kept[field] = original[field];
+    }
+    return kept;
+}
+function parseTags(raw) {
+    const tags = [];
+    for (const part of raw.split(',')) {
+        const tag = part.trim();
+        if (tag && !tags.includes(tag))
+            tags.push(tag);
+    }
+    return tags;
+}
+/**
+ * Trim a form draft and check it the way the model does: the name is
+ * required, the labour estimate is a whole number of minutes of zero or more
+ * (empty counts as zero), and the price is an amount of zero or more with at
+ * most `exponent` decimals (empty counts as zero; 2 unless the currency says
+ * otherwise). Fields in `skip` (hidden or
+ * read-only in the form) are not checked.
+ */
+export function validateAssemblyForm(draft, skip = [], exponent = 2) {
+    const invalid = [];
+    const name = textOf(draft.name);
+    const minutesText = textOf(draft.estimatedLabourMinutes);
+    const priceText = textOf(draft.price);
+    let estimatedLabourMinutes = 0;
+    if (minutesText !== '') {
+        estimatedLabourMinutes = /^\d+$/.test(minutesText)
+            ? Number(minutesText)
+            : Number.NaN;
+    }
+    let price = 0;
+    if (priceText !== '') {
+        const match = new RegExp(exponent > 0 ? `^(\\d+)(?:\\.(\\d{1,${exponent}}))?$` : '^(\\d+)$').exec(priceText);
+        price = match
+            ? Number(match[1]) * 10 ** exponent +
+                Number((match[2] ?? '').padEnd(exponent, '0') || 0)
+            : Number.NaN;
+    }
+    if (!name && !skip.includes('name'))
+        invalid.push('name');
+    if (!Number.isSafeInteger(price) && !skip.includes('price'))
+        invalid.push('price');
+    if (!Number.isSafeInteger(estimatedLabourMinutes) &&
+        !skip.includes('estimatedLabourMinutes'))
+        invalid.push('estimatedLabourMinutes');
+    if (invalid.length > 0)
+        return { ok: false, invalid };
+    return {
+        ok: true,
+        values: {
+            name,
+            description: textOf(draft.description),
+            category: textOf(draft.category),
+            partReference: textOf(draft.partReference),
+            price: Number.isSafeInteger(price) ? price : 0,
+            estimatedLabourMinutes: Number.isSafeInteger(estimatedLabourMinutes)
+                ? estimatedLabourMinutes
+                : 0,
+            defaultOperationId: textOf(draft.defaultOperationId) || null,
+            tags: parseTags(draft.tags ?? ''),
+        },
+    };
+}
 /**
  * Build an {@link AssemblyView} from an `Assembly` plus the facts the list
  * shows that live on its neighbours: its SKU codes and its active bill.
@@ -124,3 +251,126 @@ export function splitLabourMinutes(minutes) {
     const whole = Math.max(0, Math.round(minutes));
     return { hours: Math.floor(whole / 60), minutes: whole % 60 };
 }
+/** Adapt a `ProductionRun` to a {@link ProductionRunView}, with the host's label. */
+export function toProductionRunView(run, label) {
+    return {
+        id: run.id,
+        label,
+        targetQty: Number(run.targetQty),
+        completedQty: Number(run.completedQty),
+        status: run.status,
+    };
+}
+/** The message key naming a run status in words. */
+export function productionRunStatusLabelKey(status) {
+    switch (status) {
+        case 'planned':
+            return M['manufacturing.production_run_status.planned'];
+        case 'in_progress':
+            return M['manufacturing.production_run_status.in_progress'];
+        case 'done':
+            return M['manufacturing.production_run_status.done'];
+        default:
+            return M['manufacturing.production_run_status.cancelled'];
+    }
+}
+/** The `StatusBadge` tone for a run status. */
+export function productionRunStatusTone(status) {
+    switch (status) {
+        case 'in_progress':
+            return 'info';
+        case 'done':
+            return 'success';
+        case 'cancelled':
+            return 'warning';
+        default:
+            return 'neutral';
+    }
+}
+/** `true` while a run can still take completions. */
+export function isProductionRunOpen(status) {
+    return status === 'planned' || status === 'in_progress';
+}
+/**
+ * Check a typed completion quantity against what the run has left (the
+ * service checks again under its lock).
+ */
+export function validateCompletionQty(raw, run) {
+    const text = raw.trim();
+    const qty = text === '' ? Number.NaN : Number(text);
+    if (!Number.isFinite(qty) || qty <= 0)
+        return { ok: false, reason: 'invalid' };
+    // Whole millionths compared exactly, as ProductionRunService does
+    // (QUANTITY_DECIMALS = 6, MAX_QUANTITY = 999,999,999).
+    const millionths = (value) => Number(value.toFixed(6).replace('.', ''));
+    const rounded = Number(qty.toFixed(6));
+    if (rounded <= 0 || rounded > 999_999_999)
+        return { ok: false, reason: 'invalid' };
+    const remaining = millionths(run.targetQty) - millionths(run.completedQty);
+    if (millionths(rounded) > remaining)
+        return { ok: false, reason: 'too_many' };
+    return { ok: true, qty: rounded };
+}
+function isPlanned(line) {
+    return 'short' in line;
+}
+/**
+ * Nest the depth-first lines of an {@link Explosion} or a
+ * {@link RequirementsPlan} for `RequirementsTree`.
+ */
+export function toRequirementTree(source) {
+    const roots = [];
+    const open = [];
+    for (const line of source.lines) {
+        const view = {
+            key: [...line.path.map((entry) => entry.bomId), line.lineId].join('/'),
+            level: line.level,
+            name: line.name,
+            skuCode: line.skuCode,
+            kind: line.kind,
+            required: line.totalQty,
+            uom: line.uom,
+            available: isPlanned(line) ? line.available : null,
+            short: isPlanned(line) ? line.short : null,
+            buildable: line.buildable,
+            children: [],
+        };
+        open.length = Math.min(open.length, line.level - 1);
+        const parent = open[line.level - 2];
+        if (line.level > 1 && parent)
+            parent.children.push(view);
+        else
+            roots.push(view);
+        open[line.level - 1] = view;
+    }
+    return roots;
+}
+/**
+ * The totals of an {@link Explosion} or a {@link RequirementsPlan}: every line
+ * not opened, summed per component SKU (first unit kept).
+ */
+export function toRequirementTotals(source) {
+    const totals = new Map();
+    for (const line of source.lines) {
+        if (line.expanded)
+            continue;
+        const short = isPlanned(line) ? line.short : null;
+        const existing = totals.get(line.componentSkuId);
+        if (existing) {
+            existing.required += line.totalQty;
+            if (existing.short !== null && short !== null)
+                existing.short += short;
+        }
+        else {
+            totals.set(line.componentSkuId, {
+                componentSkuId: line.componentSkuId,
+                name: line.name,
+                skuCode: line.skuCode,
+                required: line.totalQty,
+                uom: line.uom,
+                short,
+            });
+        }
+    }
+    return Array.from(totals.values());
+}

package/dist/tenant-scope.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Reading a structure in its owner's tenant: the owner's rows and global
+ * ones, whatever tenant context is active.
+ *
+ * Under a tenant context the tenancy interceptor narrows every read to that
+ * tenant, which hides global rows (a shared material, a global bill, global
+ * stock); without a context it narrows nothing, which shows every tenant's
+ * rows. Neither is a bill's structure. {@link readOwnAndGlobal} runs list
+ * reads through `withTenantGlobalRead` (tenant rows plus global rows, refused
+ * for a tenant the active context may not read), and callers keep
+ * {@link isOwnOrGlobal} rows, which also covers tenancy being disabled.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Run `read` so its list reads return `owner`'s rows and global ones. For a
+ * global owner (`null`), reads see the active tenant's rows and global ones,
+ * and callers keep the global rows.
+ */
+export declare function readOwnAndGlobal<T>(owner: string | null, read: () => Promise<T>): Promise<T>;
+/** `true` for a global row or one of `owner`'s rows. */
+export declare function isOwnOrGlobal(row: {
+    tenantId?: string | null;
+}, owner: string | null): boolean;
+//# sourceMappingURL=tenant-scope.d.ts.map

package/dist/tenant-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-scope.d.ts","sourceRoot":"","sources":["../src/tenant-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,CAAC,CAGZ;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAC3B,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,OAAO,CAGT"}