@elaraai/e3-ui 1.0.103 → 1.0.104

package/dist/src/utils/vocabulary.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * What a builder's `vocabulary` prop is made of (#1516): the app's own words for what the builder draws of its own, each
+ * keeping its default where left out. A noun is its singular, its plural that and `s` unless given; a word is one string.
+ *
+ * @packageDocumentation
+ */
+import { StringType, StructType } from "@elaraai/east";
+/** One noun, resolved: as a heading writes it, and its plural. */
+export declare const VocabularyNounType: StructType<{
+    readonly one: StringType;
+    readonly other: StringType;
+}>;
+/** One noun, as the app gives it: its singular, its plural that and `s` — or both, where it isn't regular. */
+export type VocabularyNoun = string | {
+    one: string;
+    other?: string;
+};
+/**
+ * One noun, resolved.
+ *
+ * @param builder - The builder's name, for what a refusal says
+ * @param name - The entry's name
+ * @param given - The entry
+ * @param one - Its default singular
+ * @param other - Its default plural, where it isn't regular
+ * @returns The noun
+ * @throws {Error} Naming an entry given empty
+ */
+export declare function vocabularyNoun(builder: string, name: string, given: VocabularyNoun | undefined, one: string, other?: string): {
+    one: string;
+    other: string;
+};
+/**
+ * One word, resolved.
+ *
+ * @param builder - The builder's name, for what a refusal says
+ * @param name - The entry's name
+ * @param given - The entry
+ * @param word - Its default
+ * @returns The word
+ * @throws {Error} Naming an entry given empty
+ */
+export declare function vocabularyWord(builder: string, name: string, given: string | undefined, word: string): string;
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/src/utils/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../../src/utils/vocabulary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvD,kEAAkE;AAClE,eAAO,MAAM,kBAAkB;;;EAAqD,CAAC;AAErF,8GAA8G;AAC9G,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAK5J;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7G"}

package/dist/src/utils/vocabulary.js

@@ -0,0 +1,47 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * What a builder's `vocabulary` prop is made of (#1516): the app's own words for what the builder draws of its own, each
+ * keeping its default where left out. A noun is its singular, its plural that and `s` unless given; a word is one string.
+ *
+ * @packageDocumentation
+ */
+import { StringType, StructType } from "@elaraai/east";
+/** One noun, resolved: as a heading writes it, and its plural. */
+export const VocabularyNounType = StructType({ one: StringType, other: StringType });
+/**
+ * One noun, resolved.
+ *
+ * @param builder - The builder's name, for what a refusal says
+ * @param name - The entry's name
+ * @param given - The entry
+ * @param one - Its default singular
+ * @param other - Its default plural, where it isn't regular
+ * @returns The noun
+ * @throws {Error} Naming an entry given empty
+ */
+export function vocabularyNoun(builder, name, given, one, other) {
+    if (given === undefined)
+        return { one, other: other ?? `${one}s` };
+    const noun = typeof given === "string" ? { one: given } : given;
+    vocabularyWord(builder, name, noun.one, one);
+    return { one: noun.one, other: noun.other ?? `${noun.one}s` };
+}
+/**
+ * One word, resolved.
+ *
+ * @param builder - The builder's name, for what a refusal says
+ * @param name - The entry's name
+ * @param given - The entry
+ * @param word - Its default
+ * @returns The word
+ * @throws {Error} Naming an entry given empty
+ */
+export function vocabularyWord(builder, name, given, word) {
+    if (given !== undefined && given.trim() === "")
+        throw new Error(`${builder}: \`vocabulary.${name}\` must not be empty — leave it out to keep "${word}"`);
+    return given ?? word;
+}
+//# sourceMappingURL=vocabulary.js.map

package/dist/src/utils/vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../../../src/utils/vocabulary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvD,kEAAkE;AAClE,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;AAKrF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,IAAY,EAAE,KAAiC,EAAE,GAAW,EAAE,KAAc;IACxH,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;IACnE,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAChE,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7C,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,IAAY,EAAE,KAAyB,EAAE,IAAY;IACjG,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,kBAAkB,IAAI,gDAAgD,IAAI,GAAG,CAAC,CAAC;IACzJ,OAAO,KAAK,IAAI,IAAI,CAAC;AACzB,CAAC"}

package/dist/test/allocation/allocation.examples.d.ts

@@ -2912,9 +2912,11 @@ export declare const minimalFit: import("@elaraai/e3").FunctionDef<[import("../.
     readonly basis: StringType;
 }>>;
 export declare const allocationMinimal: import("@elaraai/east").ExampleDef<[], any>;
+export declare const allocationViews: import("@elaraai/east").ExampleDef<[], any>;
 export declare const allocationKilnYard: import("@elaraai/east").ExampleDef<[], any>;
 export declare const allocationTable: import("@elaraai/east").ExampleDef<[], any>;
 export declare const allocationLabels: import("@elaraai/east").ExampleDef<[], any>;
+export declare const allocationWording: import("@elaraai/east").ExampleDef<[], any>;
 export declare const allocationPublished: import("@elaraai/east").ExampleDef<[], any>;
 export declare const allocationNoPublish: import("@elaraai/east").ExampleDef<[], any>;
 export declare const allocationSplit: import("@elaraai/east").ExampleDef<[], any>;

package/dist/test/allocation/allocation.examples.d.ts.map

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

package/dist/test/allocation/allocation.examples.js

@@ -6,7 +6,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "@elaraai/e3-ui/jsx-runtime";
 /** @jsxImportSource @elaraai/e3-ui */
 import { ArrayType, DateTimeType, DictType, East, FunctionType, NullType, PatchType, StringType, example, none, some, variant } from "@elaraai/east";
 import e3 from "@elaraai/e3";
-import { Box, Button, Field, HStack, Reactive, Slice, Text, UIComponentType, VStack } from "@elaraai/east-ui";
+import { Box, Button, Field, HStack, Reactive, Select, Slice, State, Text, UIComponentType, VStack } from "@elaraai/east-ui";
 import { Allocation, Data, Func, Record, Schedule } from "@elaraai/e3-ui";
 import { Bay, Kiln, KilnBin, MinimalBin, TimberLoad, YardDay, yardArrivals, yardBayRows, yardBinHistoryRows, yardBinRows, yardDay, yardDayHistoryRows, yardDayRows, yardKilns, yardMinimalBinRows, yardPublishedDay, yardSplitDay, } from "./kiln-yard.js";
 // The kiln yard's own records (`Builder Interfaces Spec.md` §6.5): its bins and the days of its plan, which the board
@@ -151,6 +151,31 @@ export const allocationMinimal = example({
                     }, arrivals: Allocation.arrivals(loads.read(), { label: l => l.code, quantity: l => l.m3, hold: l => variant("days", l.dryingDays) }) }) });
         } })),
 });
+export const allocationViews = example({
+    description: "Which layouts an instance offers, chosen as the page runs: a multi-select wired into `views`, an expression of an array of Allocation.Types.Layout. Choose Table alone and Timeline is gone, its button and all; with one layout left no switch shows, and with none chosen, both. `views={[\"table\"]}` writes the same choice in the code.",
+    keywords: ["Allocation", "views", "Allocation.Types.Layout", "layout", "hide a view", "Timeline", "Table", "Select", "multiple", "onChangeMultiple", "State", "Reactive"], inputs: [],
+    fn: East.function([], UIComponentType, _$ => _jsx(Reactive, { children: $ => {
+            const bins = $.let(Record.bind(minimalBins));
+            const loads = $.let(Data.bind(arrivals));
+            const yard = $.let(Data.bind(kilns));
+            const bays = $.let(Data.bind(yardBays));
+            const fit = $.let(Func.bind(minimalFit));
+            // The tags the multi-select holds, and the layouts they name.
+            const chosen = $.let(State.bind([ArrayType(StringType)], "ex.allocationViews.views", []));
+            const tags = $.let(chosen.read());
+            const onViews = $.const(East.function([ArrayType(StringType)], NullType, ($, next) => { $(chosen.write(next)); }));
+            const every = $.const([variant("timeline", null), variant("table", null)], ArrayType(Allocation.Types.Layout));
+            const views = $.let(every.filter(($, view) => tags.toSet().has(view.getTag())));
+            return _jsxs(VStack, { gap: "3", align: "stretch", width: "100%", children: [_jsxs(HStack, { gap: "2", align: "center", children: [_jsx(Text, { children: "Views" }), _jsx(Select, { value: "", placeholder: "Every view", multiple: true, onChangeMultiple: onViews, items: [Select.Item("timeline", "Timeline"), Select.Item("table", "Table")] })] }), _jsx(Box, { width: "100%", height: "700px", children: _jsx(Allocation, { id: "allocationViews", views: views, fit: fit, view: { date: yardDay }, events: { bin: Schedule.events(bins, {
+                                    name: "Bin", icon: "box",
+                                    at: "at", resource: { field: "bay", of: "bays" }, arrival: "load",
+                                    quantity: { field: "m3", unit: "m³" }, parts: { field: "kilns", of: "kilns" }, hold: "dryFor",
+                                }) }, resources: {
+                                bays: Schedule.resources(bays.read(), { name: "Bays", icon: "warehouse", label: b => b.name, offset: b => b.offset }),
+                                kilns: Schedule.resources(yard.read(), { name: "Kilns", icon: "fire", label: k => k.name, min: k => k.min, max: k => k.max, jobs: k => k.charges }),
+                            }, arrivals: Allocation.arrivals(loads.read(), { label: l => l.code, quantity: l => l.m3, hold: l => variant("days", l.dryingDays) }) }) })] });
+        } })),
+});
 export const allocationKilnYard = example({
     description: "The kiln yard's board over its own records: its bins, each with the yard's spec and grade beside the board's roles, read a day at a time through the slice; the days it publishes; a check over the bins' own fields; the rail over the bays, the kilns and the loads — each source with its icon, and each narrowing every place its rows appear, the Library's tabs included; the yard's fields as columns; the Arrivals and Resources library; the inspector; and the yard's greedy fit on e3.",
     keywords: ["Allocation", "Schedule.events", "Schedule.resources", "Schedule.periods", "Allocation.arrivals", "Slice.bindRecords", "Data.bindPaged", "Func.bind", "fit", "check", "columns", "links", "Publish", "Library", "narrowing"], inputs: [],
@@ -329,6 +354,60 @@ export const allocationLabels = example({
                     ] }) });
         } })),
 });
+export const allocationWording = example({
+    description: "The kiln yard in all its own words (#1516): beside the nouns, `labels` takes what the board books (`bin`), a slot held with nothing booked in it (`reservation`, `reserved`), the legend's jobs, the hold and the Library's groups, each kept in its place and its look whatever it is called.",
+    keywords: ["Allocation", "labels", "vocabulary", "bin", "reservation", "reserved", "hold", "groups", "Library", "Schedule.events", "Allocation.arrivals"], inputs: [],
+    fn: East.function([], UIComponentType, _$ => _jsx(Reactive, { children: $ => {
+            const bins = $.let(Record.bind(kilnBins));
+            const entries = $.let(Data.bindPaged(kilnBins));
+            const byTime = $.let(Data.bindPaged(kilnBins, { indexes: ["kiln_bins_by_time"] }));
+            const days = $.let(Record.bind(yardDays));
+            // Every bay and kiln is the calculation scope; the narrowing only chooses which show.
+            const yard = $.let(Data.bind(kilns));
+            const loads = $.let(Data.bind(arrivals));
+            const bays = $.let(Data.bind(yardBays));
+            const bayIndex = $.let(Data.bindPaged(yardBays, { indexes: ["yard_bays_by_area"] }));
+            const kilnIndex = $.let(Data.bindPaged(kilns, { indexes: ["kilns_by_group"] }));
+            const slice = $.let(Slice.bindRecords("ex.allocationWording", {
+                bin: { source: byTime, range: "at" },
+                bays: { source: bayIndex, fields: { area: { label: "Area", hints: ["North", "South"] } } },
+                kilns: { source: kilnIndex, fields: { group: { label: "Kiln group", hints: ["Hall A", "Hall B", "Compact", "Standard", "Large", "Bulk"] } } },
+            }, {
+                presets: [
+                    { id: "halls", name: "Halls", where: { kilns: { group: ["Hall A", "Hall B"] } } },
+                    { id: "small", name: "Compact and standard", where: { kilns: { group: ["Compact", "Standard"] } } },
+                    { id: "large", name: "Large and bulk", where: { kilns: { group: ["Large", "Bulk"] } } },
+                    { id: "north", name: "North bays, halls", where: { bays: { area: ["North"] }, kilns: { group: ["Hall A", "Hall B"] } } },
+                ],
+            }));
+            const fit = $.let(Func.bind(yardFit));
+            return _jsx(Box, { width: "100%", height: "900px", children: _jsx(Allocation, { id: "allocationWording", title: "Kiln loading", fit: fit, slice: { slice }, inspector: true, library: [Allocation.library.arrivals(), Allocation.library.resources()], view: { layout: "timeline", date: yardDay }, labels: {
+                        lane: "Bay", arrival: { one: "Delivery", other: "Deliveries" }, resource: "Kiln", quantity: "Vol",
+                        bin: { one: "Charge", other: "Charges" }, reservation: "Booking", reserved: "Booked", priorJob: "Last firing", nextJob: "Next firing", hold: "Dwell",
+                        groups: { overdue: "Late", ready: "Due soon", removed: "Taken off", allocated: "Charged", free: "Idle", loading: "Filling", busy: "Firing" },
+                    }, table: { bands: [{ from: 0, label: "Night" }, { from: 6, label: "Day shift" }, { from: 18, label: "Evening" }] }, events: { bin: Schedule.events(bins, {
+                            name: "Charge", icon: "box", entries,
+                            at: "at", resource: { field: "bay", of: "bays" }, arrival: "load",
+                            quantity: { field: "m3", unit: "m³" }, parts: { field: "kilns", of: "kilns" }, hold: "dryFor", kind: "spec",
+                            fields: { specMeasured: Schedule.field.text({ label: "Spec measured" }), instruction: Schedule.field.text({ label: "Loading instruction" }) },
+                        }) }, resources: {
+                        bays: Schedule.resources(bays.read(), { name: "Bays", icon: "warehouse", label: b => b.name, offset: b => b.offset }),
+                        kilns: Schedule.resources(yard.read(), { name: "Kilns", icon: "fire", label: k => k.name, group: k => k.group,
+                            meta: k => some(East.str `${k.group} · ${East.Float.roundHalf(k.max)} m³`), note: k => k.note,
+                            min: k => k.min, max: k => k.max, hold: k => variant("days", k.days), jobs: k => k.charges }),
+                    }, arrivals: Allocation.arrivals(loads.read(), {
+                        label: l => l.code, meta: l => some(East.str `${l.mill} · ${l.grade} · spec ${l.spec}`),
+                        quantity: l => l.m3, hold: l => variant("days", l.dryingDays), kind: l => some(l.spec),
+                        due: l => some(l.due), window: l => some({ from: l.from, to: l.to }),
+                        details: l => [{ label: "Settings", value: l.schedule }],
+                        values: l => ({ specBooked: l.spec, specMeasured: l.spec, gradeBooked: l.grade.substring(0n, 1n), gradeMeasured: l.grade, instruction: l.instruction }),
+                    }), periods: Schedule.periods(days, { every: "day", status: { field: "state", draft: "draft", published: "issued" } }), columns: [
+                        { key: "spec", label: "Spec", text: b => East.equal(b.specBooked, b.specMeasured).ifElse(() => b.specMeasured, () => East.str `booked ${b.specBooked} · measured ${b.specMeasured}`),
+                            tone: b => East.equal(b.specBooked, b.specMeasured).ifElse(() => none, () => some(variant("warning", null))) },
+                        { key: "grade", label: "Grade", text: b => b.gradeMeasured.startsWith(b.gradeBooked).ifElse(() => b.gradeMeasured, () => East.str `booked ${b.gradeBooked} · measured ${b.gradeMeasured}`), table: false },
+                    ] }) });
+        } })),
+});
 export const allocationPublished = example({
     description: "A published day, Tue 4 May, its status the yard's own day issued: read-only under its banner; navigation, the narrowing, the focus, links and the inspector still work.",
     keywords: ["Allocation", "Schedule.periods", "Publish", "published", "readOnly", "Record.bind"], inputs: [],
@@ -532,7 +611,7 @@ export const allocationWindowed = example({
         } })),
 });
 export const allocationMobile = example({
-    description: "The kiln yard in a 390px container: a card per kiln (or per slot in the Table) with Book, Reserve, Allocate, Unlink and Back to Arrivals in anchored popovers; no drag source or target.",
+    description: "The kiln yard in a 390px container: a card per kiln (or per slot in the Table) with Book, Reserve, Allocate, Unlink and Back to Arrivals in the bottom panel over the pane strip; no drag source or target.",
     keywords: ["Allocation", "mobile", "narrow", "cards", "Schedule.events", "Record.bind"], inputs: [],
     fn: East.function([], UIComponentType, _$ => _jsx(Reactive, { children: $ => {
             const bins = $.let(Record.bind(kilnBins));