@boxa-devops/depo-shared 1.0.1

package/README.md

@@ -0,0 +1,72 @@
+# depo-contract
+
+Контракт между сервисами электронной инвентаризации локомотивного депо:
+сгенерированные типы API, design-токены, общие guard-функции и документация,
+которую читают все репозитории.
+
+Публикует npm-пакет **`@boxa-devops/depo-shared`** в GitHub Packages.
+
+## Репозитории
+
+| репозиторий | что |
+|---|---|
+| `depo-api` | FastAPI-ядро: БД, журнал событий, API-поверхность |
+| `depo-terminal` | киоск цеха: React + Dexie, офлайн-очередь |
+| `depo-admin` | платформа начальника/админа: аналитика, справочники |
+| `depo-contract` | этот репозиторий |
+
+Клонировать все четыре рядом, одним уровнем: `depo-api/make contract`
+пишет сюда по относительному пути, а CLAUDE.md сервисов ссылаются на
+`../depo-contract/docs/TZ.md`.
+
+## Документация
+
+| файл | что |
+|---|---|
+| `docs/TZ.md` | ТЗ и модель данных — источник истины |
+| `docs/DEBT.md` | техдолг, реестр «на бэке готово, фронт ждёт» |
+| `docs/DEPLOY.md` | Railway, переменные, релиз пакета |
+| `docs/CHANGELOG-mono.md` | история до разреза (заморожена) |
+| `docs/archive/` | GATES B20, REFACTOR_PLAN, README монорепо |
+
+## Команды
+
+```sh
+pnpm install
+pnpm generate    # openapi.json -> src/api.ts (после ../depo-api: make contract)
+pnpm lint
+pnpm typecheck   # единственный гейт, видящий ошибку типов внутри пакета
+pnpm test
+pnpm build       # dist/: ESM + .d.ts + sourcemaps
+```
+
+## Релиз
+
+1. `cd ../depo-api && make contract` — перегенерировать контракт сюда.
+2. `pnpm generate && pnpm lint && pnpm typecheck && pnpm test && pnpm build`.
+3. **Прогнать `pnpm test` в `depo-terminal` и `depo-admin`** — одной
+   командой на оба это больше не сделать (было `pnpm -r test`).
+4. Посмотреть `git diff openapi.json` глазами, поднять версию, записать
+   в `CHANGELOG.md`.
+5. Человек: `git commit`, `git tag vX.Y.Z`, `git push --follow-tags` →
+   workflow публикует пакет.
+
+Правила версионирования и остальные детали — `CLAUDE.md`.
+
+## Аутентификация к GitHub Packages
+
+Локально нужен classic PAT со **только** `read:packages`:
+
+```sh
+setx NODE_AUTH_TOKEN <pat>     # один раз, затем новая консоль
+```
+
+`.npmrc` в каждом JS-репозитории подставляет его из окружения — сам токен
+в файлы не попадает. Публикацию делает CI под `secrets.GITHUB_TOKEN`,
+отдельный PAT для неё не нужен.
+
+## Происхождение
+
+Выделен из монорепозитория `depo_mono` (коммит `c142574`, тег `pre-split`);
+там это был `packages/shared` плюс `docs/`. Монорепозиторий сохранён как
+архив и только для чтения.

package/dist/LangSwitch.d.ts

@@ -0,0 +1,22 @@
+/** RU/UZ toggle. i18next re-renders every consumer on change, so no reload.
+ *  Two sizes: "desk" for the admin header, "kiosk" for 48px monoblock targets.
+ *  `type` is part of the preset on purpose — the desk switch sits inside the
+ *  login <form> and has always rendered a default (submit) button; changing
+ *  that is a behaviour change, see docs/DEBT.md. */
+declare const PRESET: {
+    desk: {
+        wrap: string;
+        type: "submit";
+        cls: (on: boolean) => string;
+    };
+    kiosk: {
+        wrap: string;
+        type: "button";
+        cls: (on: boolean) => string;
+    };
+};
+export declare function LangSwitch({ size }: {
+    size?: keyof typeof PRESET;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=LangSwitch.d.ts.map

package/dist/LangSwitch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LangSwitch.d.ts","sourceRoot":"","sources":["../src/LangSwitch.tsx"],"names":[],"mappings":"AAIA;;;;oDAIoD;AACpD,QAAA,MAAM,MAAM;;;;kBAIE,OAAO;;;;;kBAQP,OAAO;;CAEpB,CAAC;AAEF,wBAAgB,UAAU,CAAC,EAAE,IAAa,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,OAAO,MAAM,CAAA;CAAE,+BAkB3E"}

package/dist/LangSwitch.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useTranslation } from "react-i18next";
+import { LANGS, setLanguage } from "./lang.js";
+/** RU/UZ toggle. i18next re-renders every consumer on change, so no reload.
+ *  Two sizes: "desk" for the admin header, "kiosk" for 48px monoblock targets.
+ *  `type` is part of the preset on purpose — the desk switch sits inside the
+ *  login <form> and has always rendered a default (submit) button; changing
+ *  that is a behaviour change, see docs/DEBT.md. */
+const PRESET = {
+    desk: {
+        wrap: "gap-0.5",
+        type: "submit",
+        cls: (on) => `rounded-md px-2 py-1 text-xs font-medium uppercase transition ${on ? "bg-accent-tint text-accent" : "text-ink-3 hover:bg-hover hover:text-ink"}`,
+    },
+    kiosk: {
+        wrap: "gap-1",
+        type: "button",
+        cls: (on) => `chip font-semibold uppercase ${on ? "chip-active" : ""}`,
+    },
+};
+export function LangSwitch({ size = "desk" }) {
+    const { i18n, t } = useTranslation();
+    const p = PRESET[size];
+    return (_jsx("div", { className: `flex items-center ${p.wrap}`, role: "group", "aria-label": t("lang.switch"), children: LANGS.map((l) => (_jsx("button", { type: p.type, onClick: () => setLanguage(l), "aria-pressed": i18n.language === l, className: p.cls(i18n.language === l), children: l }, l))) }));
+}
+//# sourceMappingURL=LangSwitch.js.map

package/dist/LangSwitch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LangSwitch.js","sourceRoot":"","sources":["../src/LangSwitch.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;oDAIoD;AACpD,MAAM,MAAM,GAAG;IACb,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,QAAiB;QACvB,GAAG,EAAE,CAAC,EAAW,EAAE,EAAE,CACnB,iEACE,EAAE,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,0CACtC,EAAE;KACL;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,QAAiB;QACvB,GAAG,EAAE,CAAC,EAAW,EAAE,EAAE,CAAC,gCAAgC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE;KAChF;CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,EAAkC;IAC1E,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,CACL,cAAK,SAAS,EAAE,qBAAqB,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAC,OAAO,gBAAa,CAAC,CAAC,aAAa,CAAC,YACrF,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAChB,iBAEE,IAAI,EAAE,CAAC,CAAC,IAAI,EACZ,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,kBACf,IAAI,CAAC,QAAQ,KAAK,CAAC,EACjC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,YAEpC,CAAC,IANG,CAAC,CAOC,CACV,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/PartPhoto.d.ts

@@ -0,0 +1,13 @@
+/** The picture of a part TYPE, with the fallback that matters more than the
+ *  picture: a type with no photo gets its CODE on a coloured plate, not an
+ *  empty frame. The colour is derived from the code, so the same type keeps
+ *  the same plate on every screen and a master recognises it by shape+colour
+ *  long before reading it. */
+export declare function PartPhoto({ photoKey, code, name, className, }: {
+    photoKey: string | null | undefined;
+    code: string;
+    name?: string;
+    /** sizing/rounding of the box — the caller owns the geometry */
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=PartPhoto.d.ts.map

package/dist/PartPhoto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartPhoto.d.ts","sourceRoot":"","sources":["../src/PartPhoto.tsx"],"names":[],"mappings":"AAAA;;;;8BAI8B;AAS9B,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,SAAc,GACf,EAAE;IACD,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAuBA"}

package/dist/PartPhoto.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/** The picture of a part TYPE, with the fallback that matters more than the
+ *  picture: a type with no photo gets its CODE on a coloured plate, not an
+ *  empty frame. The colour is derived from the code, so the same type keeps
+ *  the same plate on every screen and a master recognises it by shape+colour
+ *  long before reading it. */
+/** Stable hue for a code — plain FNV-ish walk, no hashing library. */
+function hueOf(code) {
+    let h = 0;
+    for (const ch of code)
+        h = (h * 31 + ch.codePointAt(0)) % 360;
+    return h;
+}
+export function PartPhoto({ photoKey, code, name, className = "", }) {
+    if (photoKey) {
+        return (_jsx("img", { src: `/api/v1/attachments/${photoKey}`, alt: name ?? code, loading: "lazy", className: `object-cover ${className}` }));
+    }
+    const hue = hueOf(code);
+    return (_jsx("div", { role: "img", "aria-label": name ?? code, "data-placeholder": code, className: `flex items-center justify-center overflow-hidden px-1 text-center font-mono font-bold leading-none tracking-tight ${className}`, style: { background: `hsl(${hue} 55% 88%)`, color: `hsl(${hue} 70% 26%)` }, children: code }));
+}
+//# sourceMappingURL=PartPhoto.js.map

package/dist/PartPhoto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartPhoto.js","sourceRoot":"","sources":["../src/PartPhoto.tsx"],"names":[],"mappings":";AAAA;;;;8BAI8B;AAE9B,sEAAsE;AACtE,SAAS,KAAK,CAAC,IAAY;IACzB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,EAAE,IAAI,IAAI;QAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,GAAG,GAAG,CAAC;IAC/D,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EACxB,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,SAAS,GAAG,EAAE,GAOf;IACC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CACL,cACE,GAAG,EAAE,uBAAuB,QAAQ,EAAE,EACtC,GAAG,EAAE,IAAI,IAAI,IAAI,EACjB,OAAO,EAAC,MAAM,EACd,SAAS,EAAE,gBAAgB,SAAS,EAAE,GACtC,CACH,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,CACL,cACE,IAAI,EAAC,KAAK,gBACE,IAAI,IAAI,IAAI,sBACN,IAAI,EACtB,SAAS,EAAE,qHAAqH,SAAS,EAAE,EAC3I,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,GAAG,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,YAEzE,IAAI,GACD,CACP,CAAC;AACJ,CAAC"}