@wocart/storefront 0.0.0-stage → 1.1.0

package/dist/data/communes.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Algeria's 1,551 communes across all 58 wilayas — the reference dataset the
+ * checkout's locality field resolves against.
+ *
+ * Bundled, not fetched: a shopper picking a wilaya gets its communes in the
+ * same tick, with no round-trip to fail on a bad mobile connection. The
+ * server's rows stay reachable through `geo.communes()`; the two are checked
+ * against each other before every release (count, id, wilaya, name, Arabic
+ * name).
+ *
+ * Compact tuple structure: [id, nameFr, nameAr]. Ids are `c-<wilaya>-<n>`, so
+ * the wilaya is part of the identity the server returns.
+ */
+import type { Commune } from "../types.js";
+export type CommuneTuple = readonly [id: string, name: string, nameAr: string];
+export declare const ALGERIA_COMMUNES: Readonly<Record<number, readonly CommuneTuple[]>>;
+/**
+ * The communes of one wilaya, shaped as the wire model: `Commune[]`.
+ *
+ * Answers `[]` for a wilaya the bundle does not know — the caller then decides
+ * whether that is "no localities to show" or "ask the server" (`geo.communes()`
+ * asks). Accepts the string form an `<input>`/`<select>` hands over, so a
+ * browser caller never has to parse first.
+ */
+export declare function communesForWilaya(wilayaId: number | string): Commune[];