@boxa-devops/depo-shared 1.0.4 → 1.1.0

package/src/api.ts

@@ -963,6 +963,57 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/admin/refs/loco-series/{code}/positions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Series Positions
+         * @description Every type bound to this series, with the list it carries there.
+         *
+         *     Types with no binding are deliberately absent rather than listed with their
+         *     global list: the visualization has to be able to tell «this series says so»
+         *     from «the type says so», and a merged view cannot.
+         */
+        get: operations["list_series_positions_api_v1_admin_refs_loco_series__code__positions_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/refs/loco-series/{code}/positions/{nomenclature_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Bind Series Positions
+         * @description Create or replace the binding. Idempotent by (series, type).
+         */
+        put: operations["bind_series_positions_api_v1_admin_refs_loco_series__code__positions__nomenclature_id__put"];
+        post?: never;
+        /**
+         * Unbind Series Positions
+         * @description Drop the binding: the type falls back to its global positions list.
+         *
+         *     Absent binding is not an error — the operator's intent («this series has no
+         *     list of its own») already holds.
+         */
+        delete: operations["unbind_series_positions_api_v1_admin_refs_loco_series__code__positions__nomenclature_id__delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/admin/refs/{entity}": {
         parameters: {
             query?: never;
@@ -2876,6 +2927,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/refs/loco-series-positions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Loco Series Positions
+         * @description Per-series mount positions, for the terminal's chips.
+         *
+         *     A small dictionary by design: only the types whose positions differ from
+         *     the global `nomenclature.positions` have a row. The client applies it as an
+         *     override — series row first, global list otherwise.
+         */
+        get: operations["loco_series_positions_api_v1_refs_loco_series_positions_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/refs/nomenclature": {
         parameters: {
             query?: never;
@@ -7478,6 +7553,61 @@ export interface components {
             /** Photo Key */
             photo_key: string | null;
         };
+        /**
+         * LocoSeriesPositionIn
+         * @description Bind a part type to a series with that machine's own position list.
+         *
+         *     Normalised by the same validator as nomenclature.positions, so a list means
+         *     the same thing wherever it was typed. An empty list is rejected: «no
+         *     per-series list» is expressed by DELETEing the binding, which falls the
+         *     type back to its global list, not by saving emptiness that would read as
+         *     «this series has no positions».
+         */
+        LocoSeriesPositionIn: {
+            /** Positions */
+            positions: string[];
+        };
+        /**
+         * LocoSeriesPositionOut
+         * @description One binding as the admin visualization draws it.
+         */
+        LocoSeriesPositionOut: {
+            /** Loco Series */
+            loco_series: string;
+            /**
+             * Nomenclature Id
+             * Format: uuid
+             */
+            nomenclature_id: string;
+            /** Code */
+            code: string;
+            /** Name */
+            name: string;
+            /** Positions */
+            positions: string[];
+        };
+        /**
+         * LocoSeriesPositionRef
+         * @description One binding: what positions a part type has on ONE series.
+         *
+         *     Overrides NomenclatureRef.positions for that series only. A type with no
+         *     row here keeps the global list, so this dictionary is usually short and a
+         *     depot that never needs per-series lists syncs an empty one.
+         */
+        LocoSeriesPositionRef: {
+            /** Loco Series */
+            loco_series: string;
+            /**
+             * Nomenclature Id
+             * Format: uuid
+             */
+            nomenclature_id: string;
+            /**
+             * Positions
+             * @default []
+             */
+            positions: string[];
+        };
         /**
          * LocoUnitCard
          * @description Machine card header = the registry row plus the card-only honesty bits.
@@ -13608,6 +13738,115 @@ export interface operations {
             };
         };
     };
+    list_series_positions_api_v1_admin_refs_loco_series__code__positions_get: {
+        parameters: {
+            query?: never;
+            header?: {
+                "x-debug-person-id"?: string | null;
+            };
+            path: {
+                code: string;
+            };
+            cookie?: {
+                depo_admin_session?: string | null;
+            };
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LocoSeriesPositionOut"][];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    bind_series_positions_api_v1_admin_refs_loco_series__code__positions__nomenclature_id__put: {
+        parameters: {
+            query?: never;
+            header?: {
+                "x-debug-person-id"?: string | null;
+            };
+            path: {
+                code: string;
+                nomenclature_id: string;
+            };
+            cookie?: {
+                depo_admin_session?: string | null;
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["LocoSeriesPositionIn"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LocoSeriesPositionOut"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    unbind_series_positions_api_v1_admin_refs_loco_series__code__positions__nomenclature_id__delete: {
+        parameters: {
+            query?: never;
+            header?: {
+                "x-debug-person-id"?: string | null;
+            };
+            path: {
+                code: string;
+                nomenclature_id: string;
+            };
+            cookie?: {
+                depo_admin_session?: string | null;
+            };
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     list_entity_api_v1_admin_refs__entity__get: {
         parameters: {
             query?: never;
@@ -17419,6 +17658,40 @@ export interface operations {
             };
         };
     };
+    loco_series_positions_api_v1_refs_loco_series_positions_get: {
+        parameters: {
+            query?: never;
+            header?: {
+                authorization?: string | null;
+                "x-debug-person-id"?: string | null;
+            };
+            path?: never;
+            cookie?: {
+                depo_admin_session?: string | null;
+            };
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LocoSeriesPositionRef"][];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     nomenclature_api_v1_refs_nomenclature_get: {
         parameters: {
             query?: {

package/tokens-kiosk.css

@@ -0,0 +1,179 @@
+/* ============================================================================
+   Kiosk theme — «тёмное стекло» for depo-terminal.
+
+   OPT-IN OVERLAY on top of tokens.css. Import order matters:
+
+       @import "@boxa-devops/depo-shared/tokens.css";
+       @import "@boxa-devops/depo-shared/tokens-kiosk.css";
+
+   depo-admin imports only the first file and keeps the light «технический
+   формуляр» look. Everything here re-binds EXISTING token names, so the
+   consumers' bg-paper / text-ink / rounded-md utilities flip theme without
+   touching a single component. Only the handful of tokens at the end are new.
+
+   Semantics are preserved, not reused loosely: a *-ink token is still the
+   readable text color of its tint, it is simply light now instead of dark.
+
+   WCAG AA contrast (computed; normal text needs >= 4.5). Translucent values
+   are composited over the app background #070A0F first, and text on glass is
+   measured against the composited glass surface:
+     ink       #F5F8FF on glass                = 16.24   on app bg  = 18.65
+     ink-2     rgba(255,255,255,.72) on glass  =  9.40
+     ink-3     rgba(255,255,255,.52) on glass  =  5.51   on app bg  =  5.69
+     accent-lt #A8C4FF on glass                =  9.87
+     white on accent    #1D4ED8                =  6.70
+     white on accent-2  #3B6BF5                =  4.56
+     on-light  #0A0E14 on a white control      = 19.34
+     warn-ink  #FEDF89 on warn-tint            = 11.77
+     ok-ink    #BBF7D0 on ok-tint              = 12.62
+     danger-ink #FFC9C9 on danger-tint         = 11.62
+     white on danger    #D92D20                =  4.83
+     on-light on warn   #FDB022                = 10.51
+     on-light on ok     #32D583                = 10.11
+   ========================================================================= */
+
+/* --- Self-hosted fonts (depot may live without internet: no CDN, ever) -----
+   Barlow and Space Grotesk ship latin-only here: Uzbek Latin needs nothing
+   beyond it (oʻ / gʻ use U+02BB, which is inside the latin subset). Russian
+   is served by the Inter Cyrillic faces already declared in tokens.css — the
+   unicode-range split below hands Cyrillic runs to Inter automatically, so RU
+   text stays typographically correct instead of falling back to a system
+   font. Neither family has Cyrillic glyphs at all, so this is not optional. */
+@font-face {
+  font-family: "Barlow";
+  font-style: normal;
+  font-weight: 400;
+  font-display: swap;
+  src: url("/fonts/barlow-latin-400.woff2") format("woff2");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191,
+    U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+@font-face {
+  font-family: "Barlow";
+  font-style: normal;
+  font-weight: 500;
+  font-display: swap;
+  src: url("/fonts/barlow-latin-500.woff2") format("woff2");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191,
+    U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+@font-face {
+  font-family: "Barlow";
+  font-style: normal;
+  font-weight: 600;
+  font-display: swap;
+  src: url("/fonts/barlow-latin-600.woff2") format("woff2");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191,
+    U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+@font-face {
+  font-family: "Barlow";
+  font-style: normal;
+  font-weight: 700;
+  font-display: swap;
+  src: url("/fonts/barlow-latin-700.woff2") format("woff2");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191,
+    U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+@font-face {
+  font-family: "Space Grotesk";
+  font-style: normal;
+  font-weight: 300 700;
+  font-display: swap;
+  src: url("/fonts/space-grotesk-latin-wght.woff2") format("woff2-variations");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191,
+    U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+@theme {
+  /* --- Neutrals: near-black room, translucent glass surfaces ------------- */
+  --color-steel: #070a0f; /* app background — the dark room */
+  --color-paper: rgb(255 255 255 / 0.07); /* glass surface: cards, header */
+  --color-ink: #f5f8ff; /* primary text */
+  --color-ink-2: rgb(255 255 255 / 0.72); /* secondary text */
+  --color-ink-3: rgb(255 255 255 / 0.52); /* muted text, placeholders */
+  --color-line: rgb(255 255 255 / 0.14); /* glass hairline */
+  --color-line-strong: rgb(255 255 255 / 0.3); /* emphasized rule */
+  --color-hover: rgb(255 255 255 / 0.12); /* glass lifted one step */
+
+  /* --- Accent: the design's electric blue -------------------------------- */
+  --color-accent: #1d4ed8;
+  --color-accent-2: #3b6bf5; /* hover of primary, gradient top stop */
+  --color-accent-tint: rgb(41 98 255 / 0.18); /* selected chip fill */
+  --color-accent-lt: #a8c4ff; /* links and accented text on glass */
+
+  /* --- Signals — still reserved for statuses & alarms --------------------- */
+  --color-danger: #d92d20;
+  --color-danger-ink: #ffc9c9;
+  --color-danger-tint: rgb(229 72 77 / 0.18);
+  --color-warn: #fdb022;
+  --color-warn-ink: #fedf89;
+  --color-warn-tint: rgb(247 144 9 / 0.18);
+  --color-ok: #32d583;
+  --color-ok-ink: #bbf7d0;
+  --color-ok-tint: rgb(50 213 131 / 0.16);
+
+  /* --- Status hues: same hue per status as the light theme, lifted so they
+         read as dots on a dark room instead of turning to mud. ------------ */
+  --color-st-blue: #60a5fa; /* IN_STOCK_NEW */
+  --color-st-green: #4ade80; /* IN_STOCK_OK */
+  --color-st-teal: #2dd4bf; /* INSTALLED */
+  --color-st-slate: #94a3b8; /* REMOVED, neutral/unknown */
+  --color-st-sky: #38bdf8; /* IN_TRANSIT, ACCEPTED */
+  --color-st-amber: #fdb022; /* IN_STOCK_DEFECT, IN_REPAIR, IN_PROGRESS */
+  --color-st-purple: #c084fc; /* AWAITING_QC */
+  --color-st-orange: #fb923c; /* AWAITING_DISPOSITION */
+  --color-st-indigo: #818cf8; /* PLANT_REPAIR, OPEN orders */
+  --color-st-violet: #a78bfa; /* ON_HOLD */
+  --color-st-red: #f87171; /* SCRAPPED, RETURNED */
+  --color-st-red-dark: #dc2626; /* LOST */
+  --color-st-stone: #bfa094; /* REPLACED */
+  --color-st-cyan: #22d3ee; /* repair event group on the history ribbon */
+
+  /* --- Type: Barlow for UI, Space Grotesk for identifiers and headings.
+         Inter stays in both stacks as the Cyrillic face. ------------------ */
+  --font-sans: "Barlow", "Inter", system-ui, -apple-system, "Segoe UI",
+    sans-serif;
+  --font-display: "Space Grotesk", "Inter", system-ui, sans-serif;
+  --font-mono: "JetBrains Mono", ui-monospace, "Cascadia Mono", Consolas,
+    monospace;
+
+  /* --- Radius: the formulyar's single 6px does not exist here. Controls are
+         pills (rounded-full), surfaces are soft rectangles. --------------- */
+  --radius-sm: 12px;
+  --radius-md: 18px;
+  --radius-lg: 24px;
+  --radius-xl: 30px;
+
+  /* --- Shadows: glass needs the inset top highlight, or it reads as flat
+         grey rather than lit glass. --------------------------------------- */
+  --shadow-rest: 0 1px 0 rgb(255 255 255 / 0.18) inset,
+    0 8px 24px rgb(0 0 0 / 0.38);
+  --shadow-raise: 0 1px 0 rgb(255 255 255 / 0.28) inset,
+    0 24px 56px rgb(0 0 0 / 0.5);
+
+  /* --- New here: no light-theme counterpart exists ----------------------- */
+
+  /* Text placed ON a light control (the active pill / tab is near-white). */
+  --color-on-light: #0a0e14;
+  /* Glass one step brighter — active pill, hovered card. */
+  --color-glass-2: rgb(255 255 255 / 0.12);
+  /* Near-white control fill: active tab, active series chip. */
+  --color-control: rgb(255 255 255 / 0.95);
+  /* Photo well behind a locomotive image before it loads. */
+  --color-well: #1a2230;
+
+  /* Room glows: three fixed radial washes behind everything. Decor only —
+     never a signal, so they are deliberately not the signal colors. */
+  --color-glow-blue: rgb(41 98 255 / 0.2);
+  --color-glow-teal: rgb(0 190 164 / 0.12);
+  --color-glow-amber: rgb(247 144 9 / 0.1);
+
+  /* Glass blur, one knob so every surface agrees. */
+  --blur-glass: 44px;
+}