Initial kitchen scaffold — Phase 1 kitchen port (build-verified 2026-07-11)

FastAPI backend (Python 3.11, MSSQL ODBC for SambaPOS, Azure DI OCR),
kitchen_db on central PG. React/TS/Vite frontend with navy sidebar layout.

Backend: auth.py (APP_SLUG=kitchen, SimpleNamespace — archive routes use
.kitchen_id/.is_admin without modification), main.py (51 migrations, scheduler,
internal router for KDS bookings feed), api/internal.py, full archive API
(31 routers: invoices, recipes, menus, sambapos, resos, newbook, disputes,
purchase_orders, etc.), models, migrations, OCR pipeline.
kitchen_id pinned to 1 (B1 — single hotel).

Frontend: AuthGate (app=kitchen, token shim for archive compat — B5b pending),
Layout (navy sidebar, 6 sections, Lucide icons, teal --app-primary),
App.tsx (Outlet pattern, UploadApp outside Layout), index.css (full :root block).
strict: false — archive components have type issues; build clean.

Note: 45 archive components call fetch('/api/...') without /kitchen/ prefix
(B5b). Runtime 404s; deferred until after initial testing.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

frontend/node_modules/pdf-lib/src/utils/png.ts

@@ -0,0 +1,70 @@
+import UPNG from '@pdf-lib/upng';
+
+const getImageType = (ctype: number) => {
+  if (ctype === 0) return PngType.Greyscale;
+  if (ctype === 2) return PngType.Truecolour;
+  if (ctype === 3) return PngType.IndexedColour;
+  if (ctype === 4) return PngType.GreyscaleWithAlpha;
+  if (ctype === 6) return PngType.TruecolourWithAlpha;
+  throw new Error(`Unknown color type: ${ctype}`);
+};
+
+const splitAlphaChannel = (rgbaChannel: Uint8Array) => {
+  const pixelCount = Math.floor(rgbaChannel.length / 4);
+
+  const rgbChannel = new Uint8Array(pixelCount * 3);
+  const alphaChannel = new Uint8Array(pixelCount * 1);
+
+  let rgbaOffset = 0;
+  let rgbOffset = 0;
+  let alphaOffset = 0;
+
+  while (rgbaOffset < rgbaChannel.length) {
+    rgbChannel[rgbOffset++] = rgbaChannel[rgbaOffset++];
+    rgbChannel[rgbOffset++] = rgbaChannel[rgbaOffset++];
+    rgbChannel[rgbOffset++] = rgbaChannel[rgbaOffset++];
+    alphaChannel[alphaOffset++] = rgbaChannel[rgbaOffset++];
+  }
+
+  return { rgbChannel, alphaChannel };
+};
+
+export enum PngType {
+  Greyscale = 'Greyscale',
+  Truecolour = 'Truecolour',
+  IndexedColour = 'IndexedColour',
+  GreyscaleWithAlpha = 'GreyscaleWithAlpha',
+  TruecolourWithAlpha = 'TruecolourWithAlpha',
+}
+
+export class PNG {
+  static load = (pngData: Uint8Array) => new PNG(pngData);
+
+  readonly rgbChannel: Uint8Array;
+  readonly alphaChannel?: Uint8Array;
+  readonly type: PngType;
+  readonly width: number;
+  readonly height: number;
+  readonly bitsPerComponent: number;
+
+  private constructor(pngData: Uint8Array) {
+    const upng = UPNG.decode(pngData);
+    const frames = UPNG.toRGBA8(upng);
+
+    if (frames.length > 1) throw new Error(`Animated PNGs are not supported`);
+
+    const frame = new Uint8Array(frames[0]);
+    const { rgbChannel, alphaChannel } = splitAlphaChannel(frame);
+
+    this.rgbChannel = rgbChannel;
+
+    const hasAlphaValues = alphaChannel.some((a) => a < 255);
+    if (hasAlphaValues) this.alphaChannel = alphaChannel;
+
+    this.type = getImageType(upng.ctype);
+
+    this.width = upng.width;
+    this.height = upng.height;
+    this.bitsPerComponent = 8;
+  }
+}