pi-kiosk-shared 2.2.0 → 2.2.2

package/dist/analyticsEvents.js

@@ -11,7 +11,6 @@
  *   `rpapp-kiosk/.../kioskAnalyticsEvents.ts` per plan §2.1 / §10.2.3.
  */
 import { RETAIL_ORDER_EVENTS } from './analytics/retailOrderEvents.js';
-import { RETAIL_COMMERCE_EVENTS } from './analytics/retailCommerceEvents.js';
 export const ANALYTICS_EVENT_CATALOG_VERSION = 1;
 /** Per-event metadata schema versions accepted on ingest (plan G-S02 / AN-055). */
 export const ANALYTICS_METADATA_SCHEMA_VERSIONS = [1, 2];
@@ -26,16 +25,20 @@ export const ANALYTICS_UNIVERSAL_EVENTS = {
     SESSION_STARTED: 'session_started',
     SESSION_COMPLETED: 'session_completed',
     SESSION_ABANDONED: 'session_abandoned',
+    SESSION_RECOVERED: 'session_recovered',
     SCREEN_VIEWED: 'screen_viewed',
     CTA_CLICKED: 'cta_clicked',
     BACK_CLICKED: 'back_clicked',
     ERROR_SHOWN: 'error_shown',
+    CONSENT_BANNER_DISMISSED: 'consent_banner_dismissed',
     AUTH_FLOW_STARTED: 'auth_flow_started',
-    IDENTITY_COMPLETED: 'identity_completed',
-    LOGIN_SUCCESS: 'login_success',
+    IDENTITY_CREATED: 'identity_created',
+    ACCOUNT_LOGGED_IN: 'account_logged_in',
     ACCOUNT_CREATED: 'account_created',
     PAYMENT_STARTED: 'payment_started',
+    PAYMENT_METHOD_VIEWED: 'payment_method_viewed',
     PAYMENT_QR_GENERATED: 'payment_qr_generated',
+    QR_REGENERATED: 'qr_regenerated',
     PAYMENT_SUBMITTED: 'payment_submitted',
     PAYMENT_CONFIRMED: 'payment_confirmed',
     PAYMENT_FAILED: 'payment_failed',
@@ -46,7 +49,6 @@ export const ANALYTICS_UNIVERSAL_EVENTS = {
  */
 export const ANALYTICS_RETAIL_EVENTS = {
     CATALOG_IMAGE_LOAD_FAILED: 'catalog_image_load_failed',
-    CATALOG_INTERACTION: 'catalog_interaction',
     PRODUCT_ADDED: 'product_added',
     PRODUCT_REMOVED: 'product_removed',
     CART_VIEWED: 'cart_viewed',
@@ -54,7 +56,23 @@ export const ANALYTICS_RETAIL_EVENTS = {
     RETAIL_ORDER_PAID: 'retail_order_paid',
     RETAIL_ORDER_ABANDONED: 'retail_order_abandoned',
     ...RETAIL_ORDER_EVENTS,
-    ...RETAIL_COMMERCE_EVENTS,
+};
+export const ANALYTICS_FUNNEL_EVENTS = {
+    QR_DISPLAYED: 'qr_displayed',
+    MENU_OPENED: 'menu_opened',
+    PRODUCT_SELECTED: 'product_selected',
+};
+export const ANALYTICS_IDENTITY_EVENTS = {
+    IDENTITY_RECOGNIZED: 'identity_recognized',
+    IDENTITY_LINKED: 'identity_linked',
+    IDENTITY_MATCHED: 'identity_matched',
+    IDENTITY_DELETED: 'identity_deleted',
+    CUSTOMER_DELETED: 'customer_deleted',
+};
+export const ANALYTICS_ACCOUNT_EVENTS = {
+    ACCOUNT_LOGGED_OUT: 'account_logged_out',
+    PROFILE_UPDATED: 'profile_updated',
+    RECEIPT_DOWNLOADED: 'receipt_downloaded',
 };
 /**
  * Donation events (9).
@@ -84,6 +102,8 @@ export const ANALYTICS_BARCODE_OPS_EVENTS = {
     PRODUCT_BARCODE_ALT_REMOVED: 'product_barcode_alt_removed',
     PRODUCT_BARCODE_ALT_PROMOTED: 'product_barcode_alt_promoted',
     PRODUCT_BARCODE_ASSIGN_CONFLICT: 'product_barcode_assign_conflict',
+    PRODUCT_BARCODE_LOOKUP_HIT: 'product_barcode_lookup_hit',
+    PRODUCT_BARCODE_LOOKUP_MISS: 'product_barcode_lookup_miss',
     PHYSICAL_CARD_ISSUED: 'physical_card_issued',
     PHYSICAL_CARD_REVOKED: 'physical_card_revoked',
 };
@@ -98,6 +118,9 @@ export const ANALYTICS_SERVER_OPS_EVENTS = {
 export const ANALYTICS_EVENT_NAMES = [
     ...Object.values(ANALYTICS_UNIVERSAL_EVENTS),
     ...Object.values(ANALYTICS_RETAIL_EVENTS),
+    ...Object.values(ANALYTICS_FUNNEL_EVENTS),
+    ...Object.values(ANALYTICS_IDENTITY_EVENTS),
+    ...Object.values(ANALYTICS_ACCOUNT_EVENTS),
     ...Object.values(ANALYTICS_DONATION_EVENTS),
     ...Object.values(ANALYTICS_KIOSK_EVENTS),
     ...Object.values(ANALYTICS_SERVER_OPS_EVENTS),

package/dist/analyticsEvents.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyticsEvents.js","sourceRoot":"","sources":["../src/analyticsEvents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAU,CAAC;AAE1D,mFAAmF;AACnF,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAU,CAAC;AAGlE,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAU,CAAC;AAEpE,MAAM,UAAU,yCAAyC,CACvD,KAAa;IAEb,OAAQ,kCAAwD,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,aAAa,EAAE,eAAe;IAC9B,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,iBAAiB,EAAE,mBAAmB;IACtC,kBAAkB,EAAE,oBAAoB;IACxC,aAAa,EAAE,eAAe;IAC9B,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,oBAAoB,EAAE,sBAAsB;IAC5C,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,yBAAyB,EAAE,2BAA2B;IACtD,mBAAmB,EAAE,qBAAqB;IAC1C,aAAa,EAAE,eAAe;IAC9B,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,sBAAsB,EAAE,wBAAwB;IAChD,GAAG,mBAAmB;IACtB,GAAG,sBAAsB;CACjB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,gBAAgB,EAAE,kBAAkB;IACpC,wBAAwB,EAAE,0BAA0B;IACpD,8BAA8B,EAAE,gCAAgC;IAChE,yBAAyB,EAAE,2BAA2B;IACtD,sBAAsB,EAAE,wBAAwB;IAChD,6BAA6B,EAAE,+BAA+B;IAC9D,2BAA2B,EAAE,6BAA6B;IAC1D,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;CACtB,CAAC;AAEX,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,wBAAwB,EAAE,0BAA0B;IACpD,uBAAuB,EAAE,yBAAyB;IAClD,yBAAyB,EAAE,2BAA2B;IACtD,2BAA2B,EAAE,6BAA6B;IAC1D,4BAA4B,EAAE,8BAA8B;IAC5D,+BAA+B,EAAE,iCAAiC;IAClE,oBAAoB,EAAE,sBAAsB;IAC5C,qBAAqB,EAAE,uBAAuB;CACtC,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,wBAAwB,EAAE,0BAA0B;IACpD,0BAA0B,EAAE,4BAA4B;IACxD,GAAG,4BAA4B;CACvB,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC;IAC5C,GAAG,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC;IACzC,GAAG,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC;IAC3C,GAAG,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC;IACxC,GAAG,MAAM,CAAC,MAAM,CAAC,2BAA2B,CAAC;CACrC,CAAC;AAIX;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAQ,qBAA2C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;CACd,CAAC;AAKX;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACR,CAAC;AAKX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAKX;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;CACd,CAAC;AAKX,MAAM,CAAC,MAAM,kCAAkC,GAAG,SAAkB,CAAC;AAErE;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAKX;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,kBAAkB,EAAE,8BAA8B;CAC1C,CAAC"}
+{"version":3,"file":"analyticsEvents.js","sourceRoot":"","sources":["../src/analyticsEvents.ts"],"names":[],"mappings":"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"}

package/dist/analyticsPiiTags.d.ts

@@ -1,7 +1,6 @@
-/**
- * PII classification tags for analytics metadata fields (plan G-CAT-04 / AN-008).
- */
 export type AnalyticsPiiClass = 'none' | 'pseudonymous' | 'direct' | 'financial';
-export declare const ANALYTICS_PII_FIELD_TAGS: Readonly<Record<string, Readonly<Record<string, AnalyticsPiiClass>>>>;
+type AnalyticsPiiTagsByField = Readonly<Record<string, AnalyticsPiiClass>>;
+export declare const ANALYTICS_PII_FIELD_TAGS: Readonly<Record<string, AnalyticsPiiTagsByField>>;
 export declare function getAnalyticsPiiTagsForEvent(eventName: string): Readonly<Record<string, AnalyticsPiiClass>> | undefined;
+export {};
 //# sourceMappingURL=analyticsPiiTags.d.ts.map

package/dist/analyticsPiiTags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyticsPiiTags.d.ts","sourceRoot":"","sources":["../src/analyticsPiiTags.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEjF,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAC7C,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAqF5D,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,GAChB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,GAAG,SAAS,CAEzD"}
+{"version":3,"file":"analyticsPiiTags.d.ts","sourceRoot":"","sources":["../src/analyticsPiiTags.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEjF,KAAK,uBAAuB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAwF3E,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAC7C,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CACT,CAAC;AAEjC,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,GAChB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,GAAG,SAAS,CAEzD"}

package/dist/analyticsPiiTags.js

@@ -1,88 +1,90 @@
-export const ANALYTICS_PII_FIELD_TAGS = {
+/**
+ * PII classification tags for analytics metadata fields (plan G-CAT-04 / AN-008).
+ */
+import { ANALYTICS_EVENT_NAMES } from './analyticsEvents.js';
+const DEFAULT_CLIENT_SCREEN_TAGS = {
+    screen_name: 'none',
+    previous_screen_name: 'none',
+};
+const EVENT_TAG_OVERRIDES = {
     qr_displayed: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
+        ...DEFAULT_CLIENT_SCREEN_TAGS,
         payment_id: 'pseudonymous',
         surface: 'none',
     },
     menu_opened: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
+        ...DEFAULT_CLIENT_SCREEN_TAGS,
         product_count: 'none',
     },
     product_selected: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
+        ...DEFAULT_CLIENT_SCREEN_TAGS,
         product_id: 'pseudonymous',
         interaction_type: 'none',
     },
-    auth_flow_started: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
-    },
-    login_success: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
-    },
-    account_created: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
-    },
-    identity_completed: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
-    },
     account_logged_out: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
+        ...DEFAULT_CLIENT_SCREEN_TAGS,
         logout_scope: 'none',
     },
     profile_updated: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
+        ...DEFAULT_CLIENT_SCREEN_TAGS,
         fields_changed: 'none',
     },
     receipt_opened: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
+        ...DEFAULT_CLIENT_SCREEN_TAGS,
         receipt_format: 'none',
     },
     receipt_downloaded: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
+        ...DEFAULT_CLIENT_SCREEN_TAGS,
         receipt_format: 'none',
     },
     payment_started: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
+        ...DEFAULT_CLIENT_SCREEN_TAGS,
         paymentMethod: 'none',
         amountMinor: 'financial',
         itemCount: 'none',
         amount_cents: 'financial',
     },
+    payment_method_viewed: {
+        ...DEFAULT_CLIENT_SCREEN_TAGS,
+        available_methods: 'none',
+        available_method_count: 'none',
+        has_qr: 'none',
+        has_card: 'none',
+    },
     payment_confirmed: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
+        ...DEFAULT_CLIENT_SCREEN_TAGS,
         amount_cents: 'financial',
         journey_code: 'none',
     },
-    identity_recognized: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
-    },
-    identity_linked: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
-    },
-    identity_deleted: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
-    },
-    customer_deleted: {
-        screen_name: 'none',
-        previous_screen_name: 'none',
-    },
 };
+const SERVER_SIDE_EVENTS = new Set([
+    'product_barcode_assigned',
+    'product_barcode_cleared',
+    'product_barcode_alt_added',
+    'product_barcode_alt_removed',
+    'product_barcode_alt_promoted',
+    'product_barcode_assign_conflict',
+    'product_barcode_lookup_hit',
+    'product_barcode_lookup_miss',
+    'physical_card_issued',
+    'physical_card_revoked',
+    'recurring_payment_missed',
+    'recurring_payment_received',
+]);
+function buildAnalyticsPiiFieldTags() {
+    const tags = {};
+    for (const eventName of ANALYTICS_EVENT_NAMES) {
+        if (EVENT_TAG_OVERRIDES[eventName] !== undefined) {
+            tags[eventName] = EVENT_TAG_OVERRIDES[eventName];
+            continue;
+        }
+        tags[eventName] = SERVER_SIDE_EVENTS.has(eventName)
+            ? {}
+            : DEFAULT_CLIENT_SCREEN_TAGS;
+    }
+    return tags;
+}
+export const ANALYTICS_PII_FIELD_TAGS = buildAnalyticsPiiFieldTags();
 export function getAnalyticsPiiTagsForEvent(eventName) {
     return ANALYTICS_PII_FIELD_TAGS[eventName];
 }

package/dist/analyticsPiiTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyticsPiiTags.js","sourceRoot":"","sources":["../src/analyticsPiiTags.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,wBAAwB,GAEjC;IACF,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;QAC5B,UAAU,EAAE,cAAc;QAC1B,OAAO,EAAE,MAAM;KAChB;IACD,WAAW,EAAE;QACX,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;QAC5B,aAAa,EAAE,MAAM;KACtB;IACD,gBAAgB,EAAE;QAChB,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;QAC5B,UAAU,EAAE,cAAc;QAC1B,gBAAgB,EAAE,MAAM;KACzB;IACD,iBAAiB,EAAE;QACjB,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;KAC7B;IACD,aAAa,EAAE;QACb,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;KAC7B;IACD,eAAe,EAAE;QACf,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;KAC7B;IACD,kBAAkB,EAAE;QAClB,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;KAC7B;IACD,kBAAkB,EAAE;QAClB,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;QAC5B,YAAY,EAAE,MAAM;KACrB;IACD,eAAe,EAAE;QACf,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;QAC5B,cAAc,EAAE,MAAM;KACvB;IACD,cAAc,EAAE;QACd,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;QAC5B,cAAc,EAAE,MAAM;KACvB;IACD,kBAAkB,EAAE;QAClB,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;QAC5B,cAAc,EAAE,MAAM;KACvB;IACD,eAAe,EAAE;QACf,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;QAC5B,aAAa,EAAE,MAAM;QACrB,WAAW,EAAE,WAAW;QACxB,SAAS,EAAE,MAAM;QACjB,YAAY,EAAE,WAAW;KAC1B;IACD,iBAAiB,EAAE;QACjB,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;QAC5B,YAAY,EAAE,WAAW;QACzB,YAAY,EAAE,MAAM;KACrB;IACD,mBAAmB,EAAE;QACnB,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;KAC7B;IACD,eAAe,EAAE;QACf,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;KAC7B;IACD,gBAAgB,EAAE;QAChB,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;KAC7B;IACD,gBAAgB,EAAE;QAChB,WAAW,EAAE,MAAM;QACnB,oBAAoB,EAAE,MAAM;KAC7B;CACF,CAAC;AAEF,MAAM,UAAU,2BAA2B,CACzC,SAAiB;IAEjB,OAAO,wBAAwB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"analyticsPiiTags.js","sourceRoot":"","sources":["../src/analyticsPiiTags.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAA2B,MAAM,sBAAsB,CAAC;AAMtF,MAAM,0BAA0B,GAA4B;IAC1D,WAAW,EAAE,MAAM;IACnB,oBAAoB,EAAE,MAAM;CAC7B,CAAC;AAEF,MAAM,mBAAmB,GAAiE;IACxF,YAAY,EAAE;QACZ,GAAG,0BAA0B;QAC7B,UAAU,EAAE,cAAc;QAC1B,OAAO,EAAE,MAAM;KAChB;IACD,WAAW,EAAE;QACX,GAAG,0BAA0B;QAC7B,aAAa,EAAE,MAAM;KACtB;IACD,gBAAgB,EAAE;QAChB,GAAG,0BAA0B;QAC7B,UAAU,EAAE,cAAc;QAC1B,gBAAgB,EAAE,MAAM;KACzB;IACD,kBAAkB,EAAE;QAClB,GAAG,0BAA0B;QAC7B,YAAY,EAAE,MAAM;KACrB;IACD,eAAe,EAAE;QACf,GAAG,0BAA0B;QAC7B,cAAc,EAAE,MAAM;KACvB;IACD,cAAc,EAAE;QACd,GAAG,0BAA0B;QAC7B,cAAc,EAAE,MAAM;KACvB;IACD,kBAAkB,EAAE;QAClB,GAAG,0BAA0B;QAC7B,cAAc,EAAE,MAAM;KACvB;IACD,eAAe,EAAE;QACf,GAAG,0BAA0B;QAC7B,aAAa,EAAE,MAAM;QACrB,WAAW,EAAE,WAAW;QACxB,SAAS,EAAE,MAAM;QACjB,YAAY,EAAE,WAAW;KAC1B;IACD,qBAAqB,EAAE;QACrB,GAAG,0BAA0B;QAC7B,iBAAiB,EAAE,MAAM;QACzB,sBAAsB,EAAE,MAAM;QAC9B,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,MAAM;KACjB;IACD,iBAAiB,EAAE;QACjB,GAAG,0BAA0B;QAC7B,YAAY,EAAE,WAAW;QACzB,YAAY,EAAE,MAAM;KACrB;CACF,CAAC;AAEF,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAqB;IACrD,0BAA0B;IAC1B,yBAAyB;IACzB,2BAA2B;IAC3B,6BAA6B;IAC7B,8BAA8B;IAC9B,iCAAiC;IACjC,4BAA4B;IAC5B,6BAA6B;IAC7B,sBAAsB;IACtB,uBAAuB;IACvB,0BAA0B;IAC1B,4BAA4B;CAC7B,CAAC,CAAC;AAEH,SAAS,0BAA0B;IACjC,MAAM,IAAI,GAAG,EAAyD,CAAC;IACvE,KAAK,MAAM,SAAS,IAAI,qBAAqB,EAAE,CAAC;QAC9C,IAAI,mBAAmB,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;YACjD,IAAI,CAAC,SAAS,CAAC,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;YACjD,SAAS;QACX,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC;YACjD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,0BAA0B,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAEjC,0BAA0B,EAAE,CAAC;AAEjC,MAAM,UAAU,2BAA2B,CACzC,SAAiB;IAEjB,OAAO,wBAAwB,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC"}

package/dist/index.d.ts

@@ -22,10 +22,10 @@ export * from './hooks/useDatabaseHealth.js';
 export { useSubmitCooldown, type UseSubmitCooldownResult } from './hooks/useSubmitCooldown.js';
 export * from './analyticsEvents.js';
 export * from './analyticsEmitterManifest.js';
-export * from './analyticsCatalogV2.js';
-export * from './analyticsCatalogVersion.js';
 export * from './analyticsPiiTags.js';
+export * from './analyticsConsentTier2.js';
 export * from './analyticsConsentAllowlist.js';
+export * from './analytics/metadataBuilders.js';
 export * from './analytics/retailOrderEvents.js';
 export * from './analyticsExploreCaps.js';
 export * from './analyticsApiTypes.js';
@@ -66,4 +66,6 @@ export { createCoalescedRefetchScheduler, type CoalescedRefetchScheduler, } from
 export { resolvePickupHandoffModeForCheckout } from './checkout/resolvePickupHandoffModeForCheckout.js';
 export * from './barcode/index.js';
 export * from './tenant-entitlements/index.js';
+export * from './screenState/types.js';
+export { ProviderIcon, PROVIDER_ICON_ASSET_IDS, resolveProviderIconAssetId, type ProviderIconAssetId, type ProviderIconProps, type ProviderIconSize, } from './ui/ProviderIcon/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,OAAO,EACL,wCAAwC,EACxC,yCAAyC,GAC1C,MAAM,yCAAyC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC/F,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gCAAgC,EAChC,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,iCAAiC,EACjC,iCAAiC,EACjC,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,wCAAwC,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,sCAAsC,EACtC,+BAA+B,EAC/B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EACL,+BAA+B,EAC/B,KAAK,yBAAyB,GAC/B,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,mCAAmC,EAAE,MAAM,mDAAmD,CAAC;AACxG,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -22,10 +22,10 @@ export * from './hooks/useDatabaseHealth.js';
 export { useSubmitCooldown } from './hooks/useSubmitCooldown.js';
 export * from './analyticsEvents.js';
 export * from './analyticsEmitterManifest.js';
-export * from './analyticsCatalogV2.js';
-export * from './analyticsCatalogVersion.js';
 export * from './analyticsPiiTags.js';
+export * from './analyticsConsentTier2.js';
 export * from './analyticsConsentAllowlist.js';
+export * from './analytics/metadataBuilders.js';
 export * from './analytics/retailOrderEvents.js';
 export * from './analyticsExploreCaps.js';
 export * from './analyticsApiTypes.js';
@@ -64,4 +64,6 @@ export { createCoalescedRefetchScheduler, } from './catalog/createCoalescedRefet
 export { resolvePickupHandoffModeForCheckout } from './checkout/resolvePickupHandoffModeForCheckout.js';
 export * from './barcode/index.js';
 export * from './tenant-entitlements/index.js';
+export * from './screenState/types.js';
+export { ProviderIcon, PROVIDER_ICON_ASSET_IDS, resolveProviderIconAssetId, } from './ui/ProviderIcon/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,OAAO,EACL,wCAAwC,EACxC,yCAAyC,GAC1C,MAAM,yCAAyC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAgC,MAAM,8BAA8B,CAAC;AAC/F,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gCAAgC,EAChC,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,iCAAiC,EACjC,iCAAiC,EACjC,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAUlC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EACL,+BAA+B,GAEhC,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,mCAAmC,EAAE,MAAM,mDAAmD,CAAC;AACxG,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,OAAO,EACL,wCAAwC,EACxC,yCAAyC,GAC1C,MAAM,yCAAyC,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAgC,MAAM,8BAA8B,CAAC;AAC/F,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,gCAAgC,EAChC,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,iCAAiC,EACjC,iCAAiC,EACjC,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAUlC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EACL,+BAA+B,GAEhC,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,mCAAmC,EAAE,MAAM,mDAAmD,CAAC;AACxG,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,0BAA0B,GAI3B,MAAM,4BAA4B,CAAC"}

package/dist/screenState/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Canonical screen-state types (ADR-FE-SCREENSTATE-001, MFE-v3-S-06).
+ * Types only — pi-kiosk-shared MUST NOT export React ScreenState.
+ *
+ * Gold reference: rpapp-admin/src/shared/ui/types/screenState.types.ts
+ */
+/** Frozen variant literals — PR-4E async-state-compliance regexes must match these only. */
+export type ScreenStateVariant = 'loading' | 'error' | 'empty';
+export interface EmptyStateProps {
+    icon: string;
+    title: string;
+    message: string;
+    hint?: string;
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+export interface ErrorStateProps {
+    error: Error;
+    onRetry?: () => void;
+    context?: string;
+}
+export interface SkeletonLoaderProps {
+    type: 'kpi' | 'chart' | 'table' | 'list';
+    count?: number;
+}
+export interface ScreenStateAction {
+    readonly label: string;
+    readonly onClick: () => void;
+}
+export interface ScreenStateProps {
+    readonly variant: ScreenStateVariant;
+    readonly title?: string;
+    readonly message?: string;
+    readonly hint?: string;
+    readonly icon?: string;
+    readonly error?: Error;
+    readonly onRetry?: () => void;
+    readonly action?: ScreenStateAction;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/screenState/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/screenState/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4FAA4F;AAC5F,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC"}

package/dist/screenState/types.js

@@ -0,0 +1,8 @@
+/**
+ * Canonical screen-state types (ADR-FE-SCREENSTATE-001, MFE-v3-S-06).
+ * Types only — pi-kiosk-shared MUST NOT export React ScreenState.
+ *
+ * Gold reference: rpapp-admin/src/shared/ui/types/screenState.types.ts
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/screenState/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/screenState/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/theme/ThemeProvider.d.ts

@@ -0,0 +1,21 @@
+import { type ReactNode } from 'react';
+import { type EffectiveTheme, type ThemeApi, type ThemePreference } from './themeContract.js';
+export type { EffectiveTheme, ThemeApi, ThemePreference };
+export { THEME_STORAGE_KEYS, applyInitialTheme, createThemeApi, setTheme, type ThemeAppId, } from './themeContract.js';
+export interface ThemeContextValue {
+    preference: ThemePreference;
+    effectiveTheme: EffectiveTheme;
+    setTheme: (pref: ThemePreference) => void;
+}
+export interface ThemeProviderProps {
+    /** Per-app key from `THEME_STORAGE_KEYS` (e.g. `rpapp-customer-theme`). */
+    storageKey: string;
+    children: ReactNode;
+}
+/**
+ * React bridge for DECISION-2 C-Hybrid dark mode.
+ * Wrap the app (or subtree) and read/update theme via `useTheme()`.
+ */
+export declare function ThemeProvider({ storageKey, children }: ThemeProviderProps): JSX.Element;
+export declare function useTheme(): ThemeContextValue;
+//# sourceMappingURL=ThemeProvider.d.ts.map

package/dist/theme/ThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,eAAe,CAAC;IAC5B,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;CAC3C;AAID,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAAG,GAAG,CAAC,OAAO,CAkCvF;AAED,wBAAgB,QAAQ,IAAI,iBAAiB,CAM5C"}

package/dist/theme/ThemeProvider.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState, } from 'react';
+import { createThemeApi, } from './themeContract.js';
+export { THEME_STORAGE_KEYS, applyInitialTheme, createThemeApi, setTheme, } from './themeContract.js';
+const ThemeContext = createContext(null);
+/**
+ * React bridge for DECISION-2 C-Hybrid dark mode.
+ * Wrap the app (or subtree) and read/update theme via `useTheme()`.
+ */
+export function ThemeProvider({ storageKey, children }) {
+    const api = useMemo(() => createThemeApi(storageKey), [storageKey]);
+    const [preference, setPreference] = useState(() => api.getThemePreference());
+    const [effectiveTheme, setEffectiveTheme] = useState(() => api.getEffectiveTheme());
+    const syncFromApi = useCallback(() => {
+        setPreference(api.getThemePreference());
+        setEffectiveTheme(api.getEffectiveTheme());
+    }, [api]);
+    useEffect(() => {
+        api.applyInitialTheme();
+        syncFromApi();
+        return api.subscribeToSystemTheme(syncFromApi);
+    }, [api, syncFromApi]);
+    const setThemePreference = useCallback((pref) => {
+        api.setTheme(pref);
+        syncFromApi();
+    }, [api, syncFromApi]);
+    const value = useMemo(() => ({
+        preference,
+        effectiveTheme,
+        setTheme: setThemePreference,
+    }), [preference, effectiveTheme, setThemePreference]);
+    return _jsx(ThemeContext.Provider, { value: value, children: children });
+}
+export function useTheme() {
+    const ctx = useContext(ThemeContext);
+    if (ctx === null) {
+        throw new Error('useTheme must be used within ThemeProvider');
+    }
+    return ctx;
+}
+//# sourceMappingURL=ThemeProvider.js.map

package/dist/theme/ThemeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.js","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,aAAa,EACb,WAAW,EACX,UAAU,EACV,SAAS,EACT,OAAO,EACP,QAAQ,GAET,MAAM,OAAO,CAAC;AACf,OAAO,EACL,cAAc,GAIf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,QAAQ,GAET,MAAM,oBAAoB,CAAC;AAQ5B,MAAM,YAAY,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAC;AAQnE;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAsB;IACxE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAkB,GAAG,EAAE,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC9F,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAiB,GAAG,EAAE,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEpG,MAAM,WAAW,GAAG,WAAW,CAAC,GAAS,EAAE;QACzC,aAAa,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;QACxC,iBAAiB,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC7C,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEV,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,iBAAiB,EAAE,CAAC;QACxB,WAAW,EAAE,CAAC;QACd,OAAO,GAAG,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;IAEvB,MAAM,kBAAkB,GAAG,WAAW,CACpC,CAAC,IAAqB,EAAQ,EAAE;QAC9B,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnB,WAAW,EAAE,CAAC;IAChB,CAAC,EACD,CAAC,GAAG,EAAE,WAAW,CAAC,CACnB,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,UAAU;QACV,cAAc;QACd,QAAQ,EAAE,kBAAkB;KAC7B,CAAC,EACF,CAAC,UAAU,EAAE,cAAc,EAAE,kBAAkB,CAAC,CACjD,CAAC;IAEF,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAyB,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/theme/themeContract.d.ts

@@ -0,0 +1,34 @@
+/**
+ * DECISION-2 C-Hybrid theme contract — system default + user override.
+ *
+ * Persists `light` | `dark` | `system` in per-app `localStorage` keys.
+ * Effective palette is applied via the `.dark` class on `<html>`.
+ */
+export type ThemePreference = 'light' | 'dark' | 'system';
+export type EffectiveTheme = 'light' | 'dark';
+/** Per-app `localStorage` keys (isolated so toggles do not leak across surfaces). */
+export declare const THEME_STORAGE_KEYS: {
+    readonly admin: "rpapp-admin-theme";
+    readonly customer: "rpapp-customer-theme";
+    readonly kiosk: "rpapp-kiosk-theme";
+    readonly pickup: "rpapp-pickup-theme";
+};
+export type ThemeAppId = keyof typeof THEME_STORAGE_KEYS;
+export interface ThemeApi {
+    applyInitialTheme: () => void;
+    setTheme: (pref: ThemePreference) => void;
+    getThemePreference: () => ThemePreference;
+    getEffectiveTheme: () => EffectiveTheme;
+    /** Re-sync when OS preference changes while preference is `system`. */
+    subscribeToSystemTheme: (onChange?: () => void) => () => void;
+}
+/**
+ * Imperative theme controller for a single app surface.
+ * Call `applyInitialTheme()` before the first React paint to avoid flash.
+ */
+export declare function createThemeApi(storageKey: string): ThemeApi;
+/** Convenience for boot scripts that only need the initial `.dark` sync. */
+export declare function applyInitialTheme(storageKey: string): void;
+/** Convenience for imperative toggles outside React. */
+export declare function setTheme(storageKey: string, pref: ThemePreference): void;
+//# sourceMappingURL=themeContract.d.ts.map

package/dist/theme/themeContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeContract.d.ts","sourceRoot":"","sources":["../../src/theme/themeContract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9C,qFAAqF;AACrF,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAEzD,MAAM,WAAW,QAAQ;IACvB,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1C,kBAAkB,EAAE,MAAM,eAAe,CAAC;IAC1C,iBAAiB,EAAE,MAAM,cAAc,CAAC;IACxC,uEAAuE;IACvE,sBAAsB,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CAC/D;AAsCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAmD3D;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAExE"}

package/dist/theme/themeContract.js

@@ -0,0 +1,109 @@
+/**
+ * DECISION-2 C-Hybrid theme contract — system default + user override.
+ *
+ * Persists `light` | `dark` | `system` in per-app `localStorage` keys.
+ * Effective palette is applied via the `.dark` class on `<html>`.
+ */
+/** Per-app `localStorage` keys (isolated so toggles do not leak across surfaces). */
+export const THEME_STORAGE_KEYS = {
+    admin: 'rpapp-admin-theme',
+    customer: 'rpapp-customer-theme',
+    kiosk: 'rpapp-kiosk-theme',
+    pickup: 'rpapp-pickup-theme',
+};
+function resolveSystemTheme() {
+    if (typeof window === 'undefined') {
+        return 'light';
+    }
+    return window.matchMedia?.('(prefers-color-scheme: dark)').matches
+        ? 'dark'
+        : 'light';
+}
+function readStoredPreference(storageKey) {
+    if (typeof window === 'undefined') {
+        return 'system';
+    }
+    try {
+        const raw = window.localStorage.getItem(storageKey);
+        if (raw === 'light' || raw === 'dark' || raw === 'system') {
+            return raw;
+        }
+    }
+    catch {
+        /* ignore quota / privacy errors */
+    }
+    return 'system';
+}
+function applyClass(theme) {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    const root = document.documentElement;
+    if (theme === 'dark') {
+        root.classList.add('dark');
+    }
+    else {
+        root.classList.remove('dark');
+    }
+}
+/**
+ * Imperative theme controller for a single app surface.
+ * Call `applyInitialTheme()` before the first React paint to avoid flash.
+ */
+export function createThemeApi(storageKey) {
+    const getThemePreference = () => readStoredPreference(storageKey);
+    const getEffectiveTheme = () => {
+        const pref = getThemePreference();
+        if (pref === 'system') {
+            return resolveSystemTheme();
+        }
+        return pref;
+    };
+    const applyInitialTheme = () => {
+        applyClass(getEffectiveTheme());
+    };
+    const setTheme = (pref) => {
+        try {
+            if (typeof window !== 'undefined') {
+                window.localStorage.setItem(storageKey, pref);
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        applyClass(getEffectiveTheme());
+    };
+    const subscribeToSystemTheme = (onChange) => {
+        if (typeof window === 'undefined') {
+            return () => undefined;
+        }
+        const mq = window.matchMedia?.('(prefers-color-scheme: dark)');
+        if (!mq) {
+            return () => undefined;
+        }
+        const listener = () => {
+            if (getThemePreference() === 'system') {
+                applyClass(getEffectiveTheme());
+                onChange?.();
+            }
+        };
+        mq.addEventListener('change', listener);
+        return () => mq.removeEventListener('change', listener);
+    };
+    return {
+        applyInitialTheme,
+        setTheme,
+        getThemePreference,
+        getEffectiveTheme,
+        subscribeToSystemTheme,
+    };
+}
+/** Convenience for boot scripts that only need the initial `.dark` sync. */
+export function applyInitialTheme(storageKey) {
+    createThemeApi(storageKey).applyInitialTheme();
+}
+/** Convenience for imperative toggles outside React. */
+export function setTheme(storageKey, pref) {
+    createThemeApi(storageKey).setTheme(pref);
+}
+//# sourceMappingURL=themeContract.js.map

package/dist/theme/themeContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeContract.js","sourceRoot":"","sources":["../../src/theme/themeContract.ts"],"names":[],"mappings":"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"}

package/dist/ui/Button/Button.d.ts

@@ -1,5 +1,5 @@
 import { type ButtonHTMLAttributes } from 'react';
-type Surface = 'admin' | 'kiosk' | 'customer';
+type Surface = 'admin' | 'kiosk' | 'customer' | 'pickup';
 type SharedIntent = 'primary' | 'secondary' | 'ghost' | 'danger' | 'success';
 type SharedSize = 'sm' | 'md' | 'lg' | 'xl';
 export type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & {