@happyvertical/smrt-manufacturing 0.53.4 → 0.53.6

package/dist/svelte/i18n.js

@@ -0,0 +1,119 @@
+import { defineMessages } from '@happyvertical/smrt-ui/i18n';
+/**
+ * Message catalog for the manufacturing components. Keys are
+ * `manufacturing.<component>.<key>`.
+ */
+export const M = defineMessages({
+    'manufacturing.operation_list.caption': 'Operations',
+    'manufacturing.operation_list.empty': 'No operations',
+    'manufacturing.operation_list.code': 'Code',
+    'manufacturing.operation_list.name': 'Name',
+    'manufacturing.operation_list.category': 'Category',
+    'manufacturing.operation_list.status': 'Status',
+    'manufacturing.operation_list.actions': 'Actions',
+    'manufacturing.operation_list.active': 'Active',
+    'manufacturing.operation_list.retired': 'Retired',
+    'manufacturing.operation_list.none': 'None',
+    'manufacturing.operation_list.select_aria': 'Edit operation: {name}',
+    'manufacturing.operation_list.retire': 'Retire',
+    'manufacturing.operation_list.retire_aria': 'Retire operation: {name}',
+    'manufacturing.operation_list.reinstate': 'Reinstate',
+    'manufacturing.operation_list.reinstate_aria': 'Reinstate operation: {name}',
+    'manufacturing.operation_form.code': 'Code',
+    'manufacturing.operation_form.code_edit_help': 'The code cannot be changed.',
+    'manufacturing.operation_form.name': 'Name',
+    'manufacturing.operation_form.category': 'Category',
+    'manufacturing.operation_form.category_help': 'Optional. Groups operations in lists.',
+    'manufacturing.operation_form.qualification': 'Required qualification',
+    'manufacturing.operation_form.qualification_help': 'Optional. The id of the qualification a worker needs to start this operation.',
+    'manufacturing.operation_form.submit_add': 'Add operation',
+    'manufacturing.operation_form.submit_edit': 'Save changes',
+    'manufacturing.operation_form.saving': 'Saving...',
+    'manufacturing.operation_form.cancel': 'Cancel',
+    'manufacturing.operation_form.error_code': 'Enter a code.',
+    'manufacturing.operation_form.error_name': 'Enter a name.',
+    'manufacturing.assembly_list.caption': 'Assemblies',
+    'manufacturing.assembly_list.empty': 'No assemblies',
+    'manufacturing.assembly_list.name': 'Name',
+    'manufacturing.assembly_list.assembly': 'Assembly',
+    'manufacturing.assembly_list.unnamed': 'Unnamed assembly',
+    'manufacturing.assembly_list.part_reference': 'Part reference',
+    'manufacturing.assembly_list.sku': 'SKU',
+    'manufacturing.assembly_list.price': 'Price',
+    'manufacturing.assembly_list.labour': 'Labour',
+    'manufacturing.assembly_list.bill': 'Bill of materials',
+    'manufacturing.assembly_list.select_aria': 'Open assembly: {name}',
+    'manufacturing.assembly_list.none': 'None',
+    'manufacturing.assembly_list.bill_active': 'Version {version}',
+    'manufacturing.assembly_list.bill_missing': 'No active bill',
+    'manufacturing.labour.minutes': '{minutes} min',
+    'manufacturing.labour.hours_minutes': '{hours} h {minutes} min',
+    'manufacturing.labour.not_estimated': 'Not estimated',
+    'manufacturing.kind.assembly': 'Sub-assembly',
+    'manufacturing.kind.material': 'Material',
+    'manufacturing.kind.bought': 'Bought item',
+    'manufacturing.kind.missing': 'Missing',
+    'manufacturing.bom_editor.caption': 'Bill of materials',
+    'manufacturing.bom_editor.empty': 'This bill has no lines yet',
+    'manufacturing.bom_editor.component': 'Component',
+    'manufacturing.bom_editor.kind': 'Kind',
+    'manufacturing.bom_editor.qty_per_unit': 'Quantity per unit',
+    'manufacturing.bom_editor.uom': 'Unit',
+    'manufacturing.bom_editor.waste_percent': 'Waste %',
+    'manufacturing.bom_editor.actions': 'Actions',
+    'manufacturing.bom_editor.qty_aria': 'Quantity per unit for {component}',
+    'manufacturing.bom_editor.uom_aria': 'Unit for {component}',
+    'manufacturing.bom_editor.waste_aria': 'Waste percent for {component}',
+    'manufacturing.bom_editor.save': 'Save',
+    'manufacturing.bom_editor.save_aria': 'Save line: {component}',
+    'manufacturing.bom_editor.remove': 'Remove',
+    'manufacturing.bom_editor.remove_aria': 'Remove line: {component}',
+    'manufacturing.bom_editor.has_bill': 'Has its own bill',
+    'manufacturing.bom_editor.no_bill': 'No active bill',
+    'manufacturing.bom_editor.show_bill': 'Show bill',
+    'manufacturing.bom_editor.hide_bill': 'Hide bill',
+    'manufacturing.bom_editor.show_bill_aria': 'Show the bill of {component}',
+    'manufacturing.bom_editor.hide_bill_aria': 'Hide the bill of {component}',
+    'manufacturing.bom_editor.sub_bill_label': 'Bill of {component}',
+    'manufacturing.bom_editor.loading': 'Loading bill…',
+    'manufacturing.bom_editor.load_failed': 'The bill could not be loaded',
+    'manufacturing.bom_editor.add_heading': 'Add a line',
+    'manufacturing.bom_editor.choose_component': 'Choose a component',
+    'manufacturing.bom_editor.add': 'Add line',
+    'manufacturing.bom_editor.error_component': 'Choose a component.',
+    'manufacturing.bom_editor.error_qty': 'Enter a quantity greater than zero.',
+    'manufacturing.bom_editor.error_uom': 'Enter a unit.',
+    'manufacturing.bom_editor.error_waste': 'Enter a waste percent of zero or more.',
+    'manufacturing.production_run_list.caption': 'Production runs',
+    'manufacturing.production_run_list.empty': 'No production runs',
+    'manufacturing.production_run_list.build': 'Build',
+    'manufacturing.production_run_list.progress': 'Progress',
+    'manufacturing.production_run_list.status': 'Status',
+    'manufacturing.production_run_list.report': 'Report completion',
+    'manufacturing.production_run_list.progress_value': '{completed} of {target} done',
+    'manufacturing.production_run_list.qty_aria': 'Quantity completed for {label}',
+    'manufacturing.production_run_list.submit': 'Report',
+    'manufacturing.production_run_list.submit_aria': 'Report a completion for {label}',
+    'manufacturing.production_run_list.error_qty': 'Enter a quantity greater than zero.',
+    'manufacturing.production_run_list.error_too_many': 'Only {remaining} left to build.',
+    'manufacturing.production_run_list.error_failed': 'The completion could not be recorded.',
+    'manufacturing.production_run_status.planned': 'Planned',
+    'manufacturing.production_run_status.in_progress': 'In progress',
+    'manufacturing.production_run_status.done': 'Done',
+    'manufacturing.production_run_status.cancelled': 'Cancelled',
+    'manufacturing.requirements.label': 'Requirements',
+    'manufacturing.requirements.sub_label': 'Building {component} takes',
+    'manufacturing.requirements.required': 'Required: {qty} {uom}',
+    'manufacturing.requirements.available': 'Available: {qty}',
+    'manufacturing.requirements.short': 'Short: {qty}',
+    'manufacturing.requirements.covered': 'Covered',
+    'manufacturing.requirements.buildable': 'Can be built from its bill',
+    'manufacturing.requirements.no_bill': 'No active bill',
+    'manufacturing.requirements.totals_caption': 'Totals',
+    'manufacturing.requirements.component': 'Component',
+    'manufacturing.requirements.total_required': 'Required',
+    'manufacturing.requirements.uom': 'Unit',
+    'manufacturing.requirements.total_short': 'Short',
+    'manufacturing.requirements.empty': 'Nothing is required',
+    'manufacturing.requirements.unnamed': 'Unknown component',
+});

package/dist/svelte/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @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), 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
+ */
+import type { ComponentProps } from 'svelte';
+import AssemblyForm from './components/AssemblyForm.svelte';
+import AssemblyList from './components/AssemblyList.svelte';
+import BomEditor from './components/BomEditor.svelte';
+import BomStructureTree from './components/BomStructureTree.svelte';
+import OperationForm from './components/OperationForm.svelte';
+import OperationList from './components/OperationList.svelte';
+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 ProductionRunListProps = ComponentProps<typeof ProductionRunList>;
+export type RequirementsTreeProps = ComponentProps<typeof RequirementsTree>;
+export { type AssemblyView, type BomComponentOption, type BomEditorLine, type BomLineDraft, type BomLineDraftField, type BomLineInput, type BomLineValidation, type CompletionQtyValidation, type ComponentKind, componentKindLabelKey, isProductionRunOpen, 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, validateBomLineInput, validateCompletionQty, validateOperationForm, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"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,YAAY,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,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,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,34 @@
+/**
+ * @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), 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
+ */
+import { ModuleUIRegistry } from '@happyvertical/smrt-ui/registry';
+import { MANUFACTURING_MODULE_META } from '../ui.js';
+import AssemblyForm from './components/AssemblyForm.svelte';
+import AssemblyList from './components/AssemblyList.svelte';
+import BomEditor from './components/BomEditor.svelte';
+import BomStructureTree from './components/BomStructureTree.svelte';
+import OperationForm from './components/OperationForm.svelte';
+import OperationList from './components/OperationList.svelte';
+import ProductionRunList from './components/ProductionRunList.svelte';
+import RequirementsTree from './components/RequirementsTree.svelte';
+export { AssemblyForm, AssemblyList, BomEditor, BomStructureTree, OperationForm, OperationList, ProductionRunList, RequirementsTree, };
+export { componentKindLabelKey, isProductionRunOpen, operationStatusBadgeKey, productionRunStatusLabelKey, productionRunStatusTone, splitLabourMinutes, toAssemblyView, toBomEditorLine, toBomEditorLines, toProductionRunView, toRequirementTotals, toRequirementTree, validateBomLineInput, validateCompletionQty, validateOperationForm, } from './types.js';
+// Auto-register with ModuleUIRegistry
+ModuleUIRegistry.registerModule(MANUFACTURING_MODULE_META);
+ModuleUIRegistry.register('@happyvertical/smrt-manufacturing', 'operation-list', OperationList);
+ModuleUIRegistry.register('@happyvertical/smrt-manufacturing', 'operation-form', OperationForm);
+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

@@ -0,0 +1,257 @@
+/**
+ * Serializable view types and pure helpers for the manufacturing components.
+ *
+ * Components take plain view objects (not model instances) so hosts can pass
+ * 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. */
+    id: string;
+    code: string;
+    name: string;
+    category: string;
+    isActive: boolean;
+    /** Plain string id of the required qualification; empty or omitted for none. */
+    requiredQualificationId?: string | null;
+}
+/** Existing values passed to `OperationForm` when editing. */
+export interface OperationFormInitial {
+    code: string;
+    name: string;
+    category: string;
+    requiredQualificationId: string | null;
+}
+/**
+ * What `OperationForm` hands to `onsubmit`; values are trimmed. A host maps a
+ * new operation onto `OperationService.define`, and an edit onto `rename` and
+ * `update` for the values that differ (the code never changes).
+ */
+export interface OperationFormValues {
+    code: string;
+    name: string;
+    category: string;
+    requiredQualificationId: string;
+}
+/** A field `validateOperationForm` can reject. */
+export type OperationFormField = 'code' | 'name';
+/** Result of {@link validateOperationForm}. */
+export type OperationFormValidation = {
+    ok: true;
+    values: OperationFormValues;
+} | {
+    ok: false;
+    invalid: OperationFormField[];
+};
+/** The raw text `OperationForm` collects, before trimming and checks. */
+export interface OperationFormDraft {
+    code: string;
+    name: string;
+    category: string;
+    requiredQualificationId: string;
+}
+/** Map an operation's state onto `StatusBadge` default color-scheme keys. */
+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;
+export type { ComponentKind };
+/** One row of {@link AssemblyList}. */
+export interface AssemblyView {
+    /** The assembly id. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** The organization's drawing or part number; empty when none. */
+    partReference: string;
+    /** Codes of the assembly's SKUs, in the host's order. */
+    skuCodes: string[];
+    /** Catalog price in integer minor units (cents). */
+    price: number;
+    /** Labour to build one unit, in minutes; `0` when not estimated. */
+    estimatedLabourMinutes: number;
+    /** Version of the active bill, or `null` when the assembly has none. */
+    activeBomVersion: number | null;
+}
+/**
+ * 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.
+ */
+export declare function toAssemblyView(assembly: Pick<Assembly, 'id' | 'name' | 'partReference' | 'price' | 'estimatedLabourMinutes'>, related?: {
+    skuCodes?: readonly string[];
+    activeBomVersion?: number | null;
+}): AssemblyView;
+/** One line of {@link BomEditor}. */
+export interface BomEditorLine {
+    /** The bill line id. */
+    id: string;
+    /** The component SKU the line consumes. */
+    componentSkuId: string;
+    /** The component's product name, or its SKU code when that is unknown. */
+    componentName: string;
+    /** The component's SKU code; empty when the SKU is missing. */
+    skuCode: string;
+    /** What the component is. */
+    kind: ComponentKind;
+    /** Quantity per produced unit, before waste. */
+    qtyPerUnit: number;
+    /** Unit of measure. */
+    uom: string;
+    /** Expected waste, in percent. */
+    wastePercent: number;
+    /** Free-form notes. */
+    notes: string;
+    /**
+     * For a sub-assembly, the id of its own active bill; `null` when it has
+     * none, and for every other kind.
+     */
+    subBomId: string | null;
+}
+/** Adapt one resolved bill line for {@link BomEditor}. */
+export declare function toBomEditorLine(entry: BillStructureLine): BomEditorLine;
+/**
+ * Adapt a whole bill from `AssemblyService.getBillStructure` for
+ * {@link BomEditor}, keeping its line order.
+ */
+export declare function toBomEditorLines(structure: BillStructure): BomEditorLine[];
+/** A component the editor offers when adding a line. */
+export interface BomComponentOption {
+    /** The component SKU id. */
+    skuId: string;
+    /** Text shown in the chooser, e.g. `Side panel (SP-100)`. */
+    label: string;
+}
+/** A bill line as the editor submits it, checked and trimmed. */
+export interface BomLineDraft {
+    /** The component SKU id. */
+    componentSkuId: string;
+    /** Quantity per produced unit, greater than zero. */
+    qtyPerUnit: number;
+    /** Unit of measure, never empty. */
+    uom: string;
+    /** Expected waste in percent, zero or more. */
+    wastePercent: number;
+}
+/** A field of {@link BomLineDraft} that can fail validation. */
+export type BomLineDraftField = keyof BomLineDraft;
+/** The editor's raw input for one line, before validation. */
+export interface BomLineInput {
+    /** Chosen component SKU id; empty when none is chosen. */
+    componentSkuId: string;
+    /** Quantity as typed. */
+    qtyPerUnit: string | number;
+    /** Unit as typed. */
+    uom: string;
+    /** Waste percent as typed; empty means zero. */
+    wastePercent: string | number;
+}
+/** The outcome of {@link validateBomLineInput}. */
+export type BomLineValidation = {
+    ok: true;
+    value: BomLineDraft;
+} | {
+    ok: false;
+    invalid: BomLineDraftField[];
+};
+/**
+ * Check one line's input: a component must be chosen, the quantity must be a
+ * number greater than zero, the unit must not be empty, and the waste percent
+ * must be a number of zero or more (empty counts as zero).
+ */
+export declare function validateBomLineInput(input: BomLineInput): BomLineValidation;
+/** The message key naming a {@link ComponentKind} in words. */
+export declare function componentKindLabelKey(kind: ComponentKind): "manufacturing.kind.assembly" | "manufacturing.kind.material" | "manufacturing.kind.bought" | "manufacturing.kind.missing";
+/** Split a labour estimate into whole hours and the remaining minutes. */
+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

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