@boxa-devops/depo-shared 1.0.1

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@boxa-devops/depo-shared",
+  "version": "1.0.1",
+  "description": "Wire contract between depo-api, depo-terminal and depo-admin: generated API types, design tokens, shared guards.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "repository": "github:boxa-devops/depo-contract",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "tokens.css",
+    "permissions.json",
+    "error_codes.json",
+    "openapi.json"
+  ],
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./tokens.css": "./tokens.css",
+    "./permissions.json": "./permissions.json",
+    "./error_codes.json": "./error_codes.json",
+    "./openapi.json": "./openapi.json"
+  },
+  "peerDependencies": {
+    "i18next": "^24.2.2",
+    "react": "^18.3.1",
+    "react-i18next": "^15.4.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.18.0",
+    "@types/react": "^18.3.18",
+    "eslint": "^9.18.0",
+    "openapi-typescript": "^7.5.2",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.20.0",
+    "vitest": "^3.2.7"
+  },
+  "scripts": {
+    "generate": "openapi-typescript openapi.json -o src/api.ts",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}

package/permissions.json

@@ -0,0 +1,70 @@
+{
+  "ADMIN": [
+    "count_inventory",
+    "edit_dictionaries",
+    "edit_passport",
+    "import_items",
+    "start_inventory",
+    "storno_event",
+    "view_dashboard",
+    "view_defects",
+    "view_dictionaries",
+    "view_inventory",
+    "view_items",
+    "view_orders",
+    "view_reports"
+  ],
+  "CHIEF": [
+    "approve_discrepancies",
+    "approve_disposition",
+    "approve_scrap",
+    "count_inventory",
+    "edit_passport",
+    "import_items",
+    "propose_disposition",
+    "start_inventory",
+    "storno_event",
+    "view_dashboard",
+    "view_defects",
+    "view_inventory",
+    "view_items",
+    "view_orders",
+    "view_reports"
+  ],
+  "FITTER": [
+    "view_dashboard",
+    "view_defects",
+    "view_inventory",
+    "view_items",
+    "view_orders",
+    "view_reports"
+  ],
+  "MASTER": [
+    "count_inventory",
+    "propose_disposition",
+    "view_dashboard",
+    "view_defects",
+    "view_inventory",
+    "view_items",
+    "view_orders",
+    "view_reports"
+  ],
+  "QC": [
+    "propose_disposition",
+    "view_dashboard",
+    "view_defects",
+    "view_inventory",
+    "view_items",
+    "view_orders",
+    "view_reports"
+  ],
+  "STOREKEEPER": [
+    "count_inventory",
+    "view_dashboard",
+    "view_defects",
+    "view_inventory",
+    "view_items",
+    "view_orders",
+    "view_reports"
+  ]
+}

package/src/LangSwitch.tsx

@@ -0,0 +1,44 @@
+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" as const,
+    cls: (on: boolean) =>
+      `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" as const,
+    cls: (on: boolean) => `chip font-semibold uppercase ${on ? "chip-active" : ""}`,
+  },
+};
+
+export function LangSwitch({ size = "desk" }: { size?: keyof typeof PRESET }) {
+  const { i18n, t } = useTranslation();
+  const p = PRESET[size];
+  return (
+    <div className={`flex items-center ${p.wrap}`} role="group" aria-label={t("lang.switch")}>
+      {LANGS.map((l) => (
+        <button
+          key={l}
+          type={p.type}
+          onClick={() => setLanguage(l)}
+          aria-pressed={i18n.language === l}
+          className={p.cls(i18n.language === l)}
+        >
+          {l}
+        </button>
+      ))}
+    </div>
+  );
+}

package/src/PartPhoto.tsx

@@ -0,0 +1,48 @@
+/** 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: string): number {
+  let h = 0;
+  for (const ch of code) h = (h * 31 + ch.codePointAt(0)!) % 360;
+  return h;
+}
+
+export 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;
+}) {
+  if (photoKey) {
+    return (
+      <img
+        src={`/api/v1/attachments/${photoKey}`}
+        alt={name ?? code}
+        loading="lazy"
+        className={`object-cover ${className}`}
+      />
+    );
+  }
+  const hue = hueOf(code);
+  return (
+    <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%)` }}
+    >
+      {code}
+    </div>
+  );
+}