feat(frontend): fulfillment split, API-driven topics, hub-and-spoke nav, stock-count modal, FOUND ceiling, semantic colors

- bug1: quote header fulfillment counter («رسید: X از Y قلم» amber / «تکمیل
  شد» green / «در راه»); expanded line items visually split into the
  received part (رسید شده ✓ + date + target warehouse from the receipt
  allocations) and the in-transit remainder — quantities always sum to the
  original line (invariant D holds, display-only split)
- bug2: 8-topic grids (suppliers/wizard/units) now come from
  /material-categories via the store (new lib/topics.ts; fixed the mismatched
  «ابزار و تجهیزات ساخت» label); suppliers topic->category resolution no
  longer falls back to an arbitrary category; duplicate month/status lists
  reuse the shared dictionaries; TopicGrid gained a loading EmptyState
- bug3: hub-and-spoke — the tab strip renders only on the warehouse
  dashboard; sub-views hide it and navigate back via «بازگشت به داشبورد»;
  «افزایش موجود» became the «تغییر موجودی» entry button
- bug4: stock count goes through a confirmation modal (current vs counted
  vs variance with کسری/مازاد badges) before posting STOCK_COUNT; numbers
  parsed defensively
- bug5: found qty is capped client-side (red input + inline warning, submit
  disabled) and backend returns 422 when exceeding the missing balance;
  fully-recovered losses drop off the pending list
- bug6+7: quantities render as absolute values with semantic color coding
  (emerald inflow / rose outflow / blue neutral) across dashboard timeline,
  daily control and the change-inventory form

frontend/src/pages/Suppliers/supplierUtils.tsx

@@ -1,10 +1,8 @@
 import { Link } from "react-router-dom";
 import { MapPin, Phone, User, Plus } from "lucide-react";
-import type { Material, Supplier } from "../../lib/types";
+import type { Material, Supplier, Topic } from "../../lib/types";
 import { normalize } from "../../lib/normalize";
-import { topicByName } from "../../lib/constants";
-
-// دسته‌های یک تاپیک (اتحاد materials + categories تأمین‌کننده‌ها)
+import { topicByName } from "../../lib/topics";
 export function topicCategories(topic: string, materials: Material[], suppliers: Supplier[]): string[] {
   const out = new Set<string>();
   materials
@@ -22,9 +20,9 @@ export function suppliersOfCategory(topic: string, cat: string, suppliers: Suppl
   );
 }
 
-export function topicFromParam(param: string | null): string | null {
+export function topicFromParam(param: string | null, topics: Topic[]): string | null {
   if (!param) return null;
-  const t = topicByName(param);
+  const t = topicByName(param, topics);
   return t ? t.name : null;
 }
 
@@ -85,4 +83,4 @@ export function SupplierCard({
       </div>
     </div>
   );
-}
+}