@portnet/ui 5.0.32 → 6.0.1

package/dist/v2/personalization/capabilities/savedFilters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"savedFilters.js","names":["React","_interopRequireWildcard","require","_uuid","_schema","_personalizationContext","_getRequireWildcardCache","nodeInterop","WeakMap","cacheBabelInterop","cacheNodeInterop","obj","__esModule","_typeof","cache","has","get","newObj","hasPropertyDescriptor","Object","defineProperty","getOwnPropertyDescriptor","key","prototype","hasOwnProperty","call","desc","set","_createForOfIteratorHelper","o","allowArrayLike","it","Symbol","iterator","Array","isArray","_unsupportedIterableToArray","length","i","F","s","n","done","value","e","_e","f","TypeError","normalCompletion","didErr","err","step","next","_e2","minLen","_arrayLikeToArray","toString","slice","constructor","name","from","test","arr","len","arr2","ownKeys","object","enumerableOnly","keys","getOwnPropertySymbols","symbols","filter","sym","enumerable","push","apply","_objectSpread","target","arguments","source","forEach","_defineProperty","getOwnPropertyDescriptors","defineProperties","_toPropertyKey","configurable","writable","arg","_toPrimitive","String","input","hint","prim","toPrimitive","undefined","res","Number","SAVED_FILTERS_CAPABILITY_ID","exports","SCHEMA_VERSION","EMPTY_LIST","freeze","EMPTY_MAP","registerCapability","id","schemaVersion","defaultState","migrate","migrateSavedFilters","_fromVersion","payload","listFor","map","resourceKey","list","appendFilter","updatedAt","base","isDefault","demote","concat","patchFilter","patch","some","nextList","applyPatch","merged","demoteOthers","deleteFilter","keep","markDefault","changed","setFlag","shouldBe","unmarkDefault","clearFlag","useSavedFilters","store","usePersonalizationStore","useEffect","ensure","ensureCapability","selectList","useCallback","snapshot","filters","useStoreSelector","defaultFilter","useMemo","findDefault","_iterator","_step","save","now","Date","toISOString","scope","getScope","criteria","ownerId","userId","uuidv4","shared","createdAt","write","prev","update","rename","remove","setDefault","clearDefault","getById","_iterator2","_step2","count"],"sources":["../../../../src/lib/v2/personalization/capabilities/savedFilters.ts"],"sourcesContent":["/**\r\n * savedFilters — Portnet UI v2 · personalization capability\r\n *\r\n * The Saved Filters framework (Odoo-inspired \"saved searches\"). Lets a\r\n * user name and persist the current state of any list's filters, recall\r\n * them later, and optionally mark one as the default applied on open.\r\n *\r\n * Self-registers the \"savedFilters\" capability with the schema registry\r\n * at import time, so the capability-agnostic foundation discovers it\r\n * without hardcoding.\r\n *\r\n * State model (the capability payload):\r\n *   { [resourceKey]: SavedFilter[] }\r\n *   SavedFilter = {\r\n *     id, name, resourceKey,\r\n *     criteria,        // OPAQUE — the host's own filter payload\r\n *     ownerId,\r\n *     isDefault, shared,\r\n *     createdAt, updatedAt,\r\n *   }\r\n *\r\n * `criteria` is never interpreted here — it is stored and re-emitted\r\n * verbatim, which is what keeps the framework reusable across every list\r\n * regardless of its filter schema (the host owns apply()). `shared` is\r\n * modelled but NOT enforced in Phase 1 (local persistence): it round-trips\r\n * for a future backend adapter and lets the UI show a shared indicator.\r\n *\r\n * Performance: the pure helpers rebuild only the touched resourceKey's\r\n * array and shallow-copy the map, so the store's structural sharing keeps\r\n * every OTHER resource's list referentially stable.\r\n */\r\n\r\nimport * as React from \"react\";\r\nimport { v4 as uuidv4 } from \"uuid\";\r\n\r\nimport { registerCapability } from \"../schema\";\r\nimport {\r\n  usePersonalizationStore,\r\n  useStoreSelector,\r\n} from \"../personalizationContext\";\r\nimport type { PersonalizationSnapshot } from \"../createPersonalizationStore\";\r\nimport type { SavedFilter } from \"../types\";\r\n\r\n/** The saved-filters capability payload: SavedFilter arrays keyed by resourceKey. */\r\ntype SavedFiltersState = Record<string, SavedFilter[]>;\r\n\r\nexport const SAVED_FILTERS_CAPABILITY_ID = \"savedFilters\";\r\nconst SCHEMA_VERSION = 1;\r\n\r\nconst EMPTY_LIST: readonly SavedFilter[] = Object.freeze([]);\r\nconst EMPTY_MAP: SavedFiltersState = Object.freeze({});\r\n\r\n/* Register at import time — the foundation reads this at hydration. */\r\nregisterCapability({\r\n  id: SAVED_FILTERS_CAPABILITY_ID,\r\n  schemaVersion: SCHEMA_VERSION,\r\n  defaultState: EMPTY_MAP, // { [resourceKey]: SavedFilter[] }\r\n  migrate: function migrateSavedFilters(\r\n    _fromVersion: number,\r\n    payload: unknown\r\n  ): unknown {\r\n    // v1 is the initial schema. Defensive normalisation only.\r\n    return payload && typeof payload === \"object\" ? payload : {};\r\n  },\r\n});\r\n\r\n/* ── pure, resourceKey-scoped state helpers (structural sharing) ────── */\r\n\r\nfunction listFor(\r\n  map: SavedFiltersState | null | undefined,\r\n  resourceKey: string\r\n): readonly SavedFilter[] {\r\n  const list = map ? map[resourceKey] : undefined;\r\n  return Array.isArray(list) ? list : EMPTY_LIST;\r\n}\r\n\r\n// Append a fully-formed filter. Enforces a single default per resource:\r\n// when the new filter is default, demote any previous default.\r\nfunction appendFilter(\r\n  map: SavedFiltersState | null | undefined,\r\n  resourceKey: string,\r\n  filter: SavedFilter,\r\n  updatedAt: string\r\n): SavedFiltersState {\r\n  const base = map || EMPTY_MAP;\r\n  let list = listFor(base, resourceKey);\r\n  if (filter.isDefault) {\r\n    list = list.map(function demote(f) {\r\n      return f.isDefault ? { ...f, isDefault: false, updatedAt: updatedAt } : f;\r\n    });\r\n  }\r\n  const next: SavedFiltersState = { ...base };\r\n  next[resourceKey] = list.concat([filter]);\r\n  return next;\r\n}\r\n\r\n// Merge a patch into one filter (id/resourceKey are immutable). When the\r\n// patch promotes it to default, demote the others.\r\nfunction patchFilter(\r\n  map: SavedFiltersState | null | undefined,\r\n  resourceKey: string,\r\n  id: string,\r\n  patch: Partial<SavedFilter>,\r\n  updatedAt: string\r\n): SavedFiltersState {\r\n  const base = map || EMPTY_MAP;\r\n  const list = listFor(base, resourceKey);\r\n  if (\r\n    !list.some(function (f) {\r\n      return f.id === id;\r\n    })\r\n  ) {\r\n    return base; // no-op\r\n  }\r\n  let nextList = list.map(function applyPatch(f) {\r\n    if (f.id !== id) return f;\r\n    const merged: SavedFilter = {\r\n      ...f,\r\n      ...patch,\r\n      id: f.id,\r\n      updatedAt: updatedAt,\r\n      ...(f.resourceKey !== undefined ? { resourceKey: f.resourceKey } : {}),\r\n    };\r\n    return merged;\r\n  });\r\n  if (patch && patch.isDefault === true) {\r\n    nextList = nextList.map(function demoteOthers(f) {\r\n      if (f.id === id) return f;\r\n      return f.isDefault ? { ...f, isDefault: false, updatedAt: updatedAt } : f;\r\n    });\r\n  }\r\n  const next: SavedFiltersState = { ...base };\r\n  next[resourceKey] = nextList;\r\n  return next;\r\n}\r\n\r\nfunction deleteFilter(\r\n  map: SavedFiltersState | null | undefined,\r\n  resourceKey: string,\r\n  id: string\r\n): SavedFiltersState {\r\n  const base = map || EMPTY_MAP;\r\n  const list = listFor(base, resourceKey);\r\n  if (\r\n    !list.some(function (f) {\r\n      return f.id === id;\r\n    })\r\n  ) {\r\n    return base; // no-op\r\n  }\r\n  const nextList = list.filter(function keep(f) {\r\n    return f.id !== id;\r\n  });\r\n  const next: SavedFiltersState = { ...base };\r\n  if (nextList.length === 0) delete next[resourceKey]; // keep the map tidy\r\n  else next[resourceKey] = nextList;\r\n  return next;\r\n}\r\n\r\nfunction markDefault(\r\n  map: SavedFiltersState | null | undefined,\r\n  resourceKey: string,\r\n  id: string,\r\n  updatedAt: string\r\n): SavedFiltersState {\r\n  const base = map || EMPTY_MAP;\r\n  const list = listFor(base, resourceKey);\r\n  let changed = false;\r\n  const nextList = list.map(function setFlag(f) {\r\n    const shouldBe = f.id === id;\r\n    if (!!f.isDefault === shouldBe) return f;\r\n    changed = true;\r\n    return { ...f, isDefault: shouldBe, updatedAt: updatedAt };\r\n  });\r\n  if (!changed) return base;\r\n  const next: SavedFiltersState = { ...base };\r\n  next[resourceKey] = nextList;\r\n  return next;\r\n}\r\n\r\nfunction unmarkDefault(\r\n  map: SavedFiltersState | null | undefined,\r\n  resourceKey: string,\r\n  updatedAt: string\r\n): SavedFiltersState {\r\n  const base = map || EMPTY_MAP;\r\n  const list = listFor(base, resourceKey);\r\n  let changed = false;\r\n  const nextList = list.map(function clearFlag(f) {\r\n    if (!f.isDefault) return f;\r\n    changed = true;\r\n    return { ...f, isDefault: false, updatedAt: updatedAt };\r\n  });\r\n  if (!changed) return base;\r\n  const next: SavedFiltersState = { ...base };\r\n  next[resourceKey] = nextList;\r\n  return next;\r\n}\r\n\r\n/* ── hook ───────────────────────────────────────────────────────────── */\r\n\r\nexport interface SaveFilterInput {\r\n  name: string;\r\n  /** Opaque host filter payload — stored and re-emitted verbatim. */\r\n  criteria?: Record<string, unknown> | undefined;\r\n  isDefault?: boolean | undefined;\r\n  shared?: boolean | undefined;\r\n}\r\n\r\nexport interface UseSavedFiltersResult {\r\n  filters: readonly SavedFilter[];\r\n  defaultFilter: SavedFilter | null;\r\n  count: number;\r\n  save: (input: SaveFilterInput) => SavedFilter;\r\n  update: (id: string, patch: Partial<SavedFilter>) => void;\r\n  rename: (id: string, name: string) => void;\r\n  remove: (id: string) => void;\r\n  setDefault: (id: string) => void;\r\n  clearDefault: () => void;\r\n  getById: (id: string) => SavedFilter | null;\r\n}\r\n\r\n/**\r\n * useSavedFilters(resourceKey) — list, default, and CRUD for one resource.\r\n *\r\n * Applying a filter is the host's concern (it owns the criteria\r\n * semantics): read `getById(id).criteria` / a filter's `criteria` and set\r\n * your own filter state. SavedFiltersMenu wires this for you.\r\n */\r\nexport function useSavedFilters(resourceKey: string): UseSavedFiltersResult {\r\n  const store = usePersonalizationStore();\r\n\r\n  React.useEffect(\r\n    function ensure() {\r\n      store.ensureCapability(SAVED_FILTERS_CAPABILITY_ID);\r\n    },\r\n    [store]\r\n  );\r\n\r\n  const selectList = React.useCallback(\r\n    function selectList(snapshot: PersonalizationSnapshot): readonly SavedFilter[] {\r\n      const slice = snapshot[SAVED_FILTERS_CAPABILITY_ID] as\r\n        | SavedFiltersState\r\n        | undefined;\r\n      return slice ? listFor(slice, resourceKey) : EMPTY_LIST;\r\n    },\r\n    [resourceKey]\r\n  );\r\n  const filters = useStoreSelector(selectList);\r\n\r\n  const defaultFilter = React.useMemo(\r\n    function findDefault(): SavedFilter | null {\r\n      for (const f of filters) {\r\n        if (f.isDefault) return f;\r\n      }\r\n      return null;\r\n    },\r\n    [filters]\r\n  );\r\n\r\n  const save = React.useCallback(\r\n    function save(input: SaveFilterInput): SavedFilter {\r\n      const now = new Date().toISOString();\r\n      const scope = store.getScope ? store.getScope() : null;\r\n      const criteria = input ? input.criteria : undefined;\r\n      const ownerId = scope ? scope.userId : undefined;\r\n      const filter: SavedFilter = {\r\n        id: uuidv4(),\r\n        name: input && input.name ? input.name : \"\",\r\n        resourceKey: resourceKey,\r\n        isDefault: !!(input && input.isDefault),\r\n        shared: !!(input && input.shared),\r\n        createdAt: now,\r\n        updatedAt: now,\r\n        ...(criteria !== undefined ? { criteria } : {}),\r\n        ...(ownerId !== undefined ? { ownerId } : {}),\r\n      };\r\n      store.write<SavedFiltersState>(\r\n        SAVED_FILTERS_CAPABILITY_ID,\r\n        function (prev) {\r\n          return appendFilter(prev, resourceKey, filter, now);\r\n        }\r\n      );\r\n      return filter;\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n\r\n  const update = React.useCallback(\r\n    function update(id: string, patch: Partial<SavedFilter>): void {\r\n      const now = new Date().toISOString();\r\n      store.write<SavedFiltersState>(\r\n        SAVED_FILTERS_CAPABILITY_ID,\r\n        function (prev) {\r\n          return patchFilter(prev, resourceKey, id, patch || {}, now);\r\n        }\r\n      );\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n\r\n  const rename = React.useCallback(\r\n    function rename(id: string, name: string): void {\r\n      update(id, { name: name });\r\n    },\r\n    [update]\r\n  );\r\n\r\n  const remove = React.useCallback(\r\n    function remove(id: string): void {\r\n      store.write<SavedFiltersState>(\r\n        SAVED_FILTERS_CAPABILITY_ID,\r\n        function (prev) {\r\n          return deleteFilter(prev, resourceKey, id);\r\n        }\r\n      );\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n\r\n  const setDefault = React.useCallback(\r\n    function setDefault(id: string): void {\r\n      const now = new Date().toISOString();\r\n      store.write<SavedFiltersState>(\r\n        SAVED_FILTERS_CAPABILITY_ID,\r\n        function (prev) {\r\n          return markDefault(prev, resourceKey, id, now);\r\n        }\r\n      );\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n\r\n  const clearDefault = React.useCallback(\r\n    function clearDefault(): void {\r\n      const now = new Date().toISOString();\r\n      store.write<SavedFiltersState>(\r\n        SAVED_FILTERS_CAPABILITY_ID,\r\n        function (prev) {\r\n          return unmarkDefault(prev, resourceKey, now);\r\n        }\r\n      );\r\n    },\r\n    [store, resourceKey]\r\n  );\r\n\r\n  const getById = React.useCallback(\r\n    function getById(id: string): SavedFilter | null {\r\n      for (const f of filters) {\r\n        if (f.id === id) return f;\r\n      }\r\n      return null;\r\n    },\r\n    [filters]\r\n  );\r\n\r\n  return React.useMemo(\r\n    function value(): UseSavedFiltersResult {\r\n      return {\r\n        filters: filters,\r\n        defaultFilter: defaultFilter,\r\n        count: filters.length,\r\n        save: save,\r\n        update: update,\r\n        rename: rename,\r\n        remove: remove,\r\n        setDefault: setDefault,\r\n        clearDefault: clearDefault,\r\n        getById: getById,\r\n      };\r\n    },\r\n    [\r\n      filters,\r\n      defaultFilter,\r\n      save,\r\n      update,\r\n      rename,\r\n      remove,\r\n      setDefault,\r\n      clearDefault,\r\n      getById,\r\n    ]\r\n  );\r\n}\r\n"],"mappings":"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","ignoreList":[]}

package/dist/v2/personalization/createPersonalizationStore.d.ts

@@ -0,0 +1,76 @@
+/**
+ * createPersonalizationStore — Portnet UI v2 · personalization
+ *
+ * Scoped, multi-capability, adapter-backed store. Generalises the
+ * useSyncExternalStore + cross-tab + SSR-safe pattern proven by
+ * useDensity (architecture doc §2.3 / §2.4).
+ *
+ * Core idea — sync snapshot, async adapter:
+ *   - The store holds a SYNCHRONOUS in-memory snapshot. `read()` is pure
+ *     (no mutation) so it is safe to call inside a useSyncExternalStore
+ *     selector. Components never await to render.
+ *   - Mutations are OPTIMISTIC: the snapshot updates synchronously and
+ *     subscribers are notified; the adapter persists asynchronously; on
+ *     failure the optimistic value is kept for the session and onError
+ *     fires. Swapping a remote adapter changes only *when* bytes hit the
+ *     wire, never how components read.
+ *   - STRUCTURAL SHARING: a write replaces only its capability slice; all
+ *     sibling slices keep their reference. This is what makes selectors
+ *     referentially stable and prevents cross-capability re-renders.
+ *
+ * The store is capability-AGNOSTIC: payloads are `unknown` and it learns
+ * defaults, schema versions and migrations from the schema registry (slices
+ * self-register at import time). Adding a capability requires no change here;
+ * the typed capability slices impose the concrete payload types on top via
+ * the generic read<T>/write<T> facades.
+ */
+import type { Adapter, HydrateStrategy, Scope } from "./types";
+export type PersonalizationStatus = "idle" | "hydrating" | "saving" | "error";
+/** The store's in-memory snapshot: { [capabilityId]: payload }. */
+export type PersonalizationSnapshot = Record<string, unknown>;
+/** A write value, or a functional updater `(previous) => next`. */
+export type PersonalizationUpdater<T = unknown> = T | ((previous: T) => T);
+export interface WriteOptions {
+    /** Set false for an in-memory-only write (no adapter persist). */
+    persist?: boolean | undefined;
+}
+export interface PersonalizationErrorContext {
+    scope: Scope;
+    capabilityId: string;
+}
+export type PersonalizationErrorHandler = (error: Error, context: PersonalizationErrorContext) => void;
+export interface PersonalizationRuntimeOptions {
+    onError?: PersonalizationErrorHandler | undefined;
+    hydrateStrategy?: HydrateStrategy | undefined;
+}
+export interface PersonalizationStoreConfig {
+    /** Identity the store persists against. Defaults to { userId: "anonymous" }. */
+    scope?: Scope | undefined;
+    /** Storage adapter. When null the store is a pure in-memory session. */
+    adapter?: Adapter | null | undefined;
+    /** Per-capability seed overrides, read at creation/hydration. */
+    defaults?: Record<string, unknown> | null | undefined;
+    onError?: PersonalizationErrorHandler | undefined;
+    /** @default "remote-wins" */
+    hydrateStrategy?: HydrateStrategy | undefined;
+}
+/** The store handle returned by createPersonalizationStore. */
+export interface PersonalizationStore {
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => PersonalizationSnapshot;
+    getServerSnapshot: () => PersonalizationSnapshot;
+    read: <T = unknown>(capabilityId: string) => T;
+    write: <T = unknown>(capabilityId: string, updater: PersonalizationUpdater<T>, options?: WriteOptions) => T | undefined;
+    ensureCapability: (capabilityId: string) => void;
+    clearCapability: (capabilityId: string) => void;
+    hydrate: () => Promise<void>;
+    connect: () => () => void;
+    dispose: () => void;
+    setRuntime: (opts?: PersonalizationRuntimeOptions) => void;
+    status: (capabilityId: string) => PersonalizationStatus;
+    error: (capabilityId: string) => Error | null;
+    isHydrated: () => boolean;
+    getScope: () => Scope;
+}
+export default function createPersonalizationStore(config?: PersonalizationStoreConfig): PersonalizationStore;
+//# sourceMappingURL=createPersonalizationStore.d.ts.map

package/dist/v2/personalization/createPersonalizationStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPersonalizationStore.d.ts","sourceRoot":"","sources":["../../../src/lib/v2/personalization/createPersonalizationStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAY,eAAe,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEzE,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE9E,mEAAmE;AACnE,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9D,mEAAmE;AACnE,MAAM,MAAM,sBAAsB,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,2BAA2B,GAAG,CACxC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,2BAA2B,KACjC,IAAI,CAAC;AAEV,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;IAClD,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC1B,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,OAAO,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;IAClD,6BAA6B;IAC7B,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CAC/C;AAED,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IAEnC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,WAAW,EAAE,MAAM,uBAAuB,CAAC;IAC3C,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;IAEjD,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,MAAM,KAAK,CAAC,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,GAAG,OAAO,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAClC,OAAO,CAAC,EAAE,YAAY,KACnB,CAAC,GAAG,SAAS,CAAC;IACnB,gBAAgB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,eAAe,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,MAAM,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,6BAA6B,KAAK,IAAI,CAAC;IAE3D,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,qBAAqB,CAAC;IACxD,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,KAAK,GAAG,IAAI,CAAC;IAC9C,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,KAAK,CAAC;CACvB;AAcD,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAChD,MAAM,CAAC,EAAE,0BAA0B,GAClC,oBAAoB,CAyXtB"}

package/dist/v2/personalization/createPersonalizationStore.js

@@ -0,0 +1,475 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = createPersonalizationStore;
+var _schema = require("./schema");
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return exports; }; var exports = {}, Op = Object.prototype, hasOwn = Op.hasOwnProperty, defineProperty = Object.defineProperty || function (obj, key, desc) { obj[key] = desc.value; }, $Symbol = "function" == typeof Symbol ? Symbol : {}, iteratorSymbol = $Symbol.iterator || "@@iterator", asyncIteratorSymbol = $Symbol.asyncIterator || "@@asyncIterator", toStringTagSymbol = $Symbol.toStringTag || "@@toStringTag"; function define(obj, key, value) { return Object.defineProperty(obj, key, { value: value, enumerable: !0, configurable: !0, writable: !0 }), obj[key]; } try { define({}, ""); } catch (err) { define = function define(obj, key, value) { return obj[key] = value; }; } function wrap(innerFn, outerFn, self, tryLocsList) { var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator, generator = Object.create(protoGenerator.prototype), context = new Context(tryLocsList || []); return defineProperty(generator, "_invoke", { value: makeInvokeMethod(innerFn, self, context) }), generator; } function tryCatch(fn, obj, arg) { try { return { type: "normal", arg: fn.call(obj, arg) }; } catch (err) { return { type: "throw", arg: err }; } } exports.wrap = wrap; var ContinueSentinel = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var IteratorPrototype = {}; define(IteratorPrototype, iteratorSymbol, function () { return this; }); var getProto = Object.getPrototypeOf, NativeIteratorPrototype = getProto && getProto(getProto(values([]))); NativeIteratorPrototype && NativeIteratorPrototype !== Op && hasOwn.call(NativeIteratorPrototype, iteratorSymbol) && (IteratorPrototype = NativeIteratorPrototype); var Gp = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(IteratorPrototype); function defineIteratorMethods(prototype) { ["next", "throw", "return"].forEach(function (method) { define(prototype, method, function (arg) { return this._invoke(method, arg); }); }); } function AsyncIterator(generator, PromiseImpl) { function invoke(method, arg, resolve, reject) { var record = tryCatch(generator[method], generator, arg); if ("throw" !== record.type) { var result = record.arg, value = result.value; return value && "object" == _typeof(value) && hasOwn.call(value, "__await") ? PromiseImpl.resolve(value.__await).then(function (value) { invoke("next", value, resolve, reject); }, function (err) { invoke("throw", err, resolve, reject); }) : PromiseImpl.resolve(value).then(function (unwrapped) { result.value = unwrapped, resolve(result); }, function (error) { return invoke("throw", error, resolve, reject); }); } reject(record.arg); } var previousPromise; defineProperty(this, "_invoke", { value: function value(method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(innerFn, self, context) { var state = "suspendedStart"; return function (method, arg) { if ("executing" === state) throw new Error("Generator is already running"); if ("completed" === state) { if ("throw" === method) throw arg; return doneResult(); } for (context.method = method, context.arg = arg;;) { var delegate = context.delegate; if (delegate) { var delegateResult = maybeInvokeDelegate(delegate, context); if (delegateResult) { if (delegateResult === ContinueSentinel) continue; return delegateResult; } } if ("next" === context.method) context.sent = context._sent = context.arg;else if ("throw" === context.method) { if ("suspendedStart" === state) throw state = "completed", context.arg; context.dispatchException(context.arg); } else "return" === context.method && context.abrupt("return", context.arg); state = "executing"; var record = tryCatch(innerFn, self, context); if ("normal" === record.type) { if (state = context.done ? "completed" : "suspendedYield", record.arg === ContinueSentinel) continue; return { value: record.arg, done: context.done }; } "throw" === record.type && (state = "completed", context.method = "throw", context.arg = record.arg); } }; } function maybeInvokeDelegate(delegate, context) { var methodName = context.method, method = delegate.iterator[methodName]; if (undefined === method) return context.delegate = null, "throw" === methodName && delegate.iterator["return"] && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method) || "return" !== methodName && (context.method = "throw", context.arg = new TypeError("The iterator does not provide a '" + methodName + "' method")), ContinueSentinel; var record = tryCatch(method, delegate.iterator, context.arg); if ("throw" === record.type) return context.method = "throw", context.arg = record.arg, context.delegate = null, ContinueSentinel; var info = record.arg; return info ? info.done ? (context[delegate.resultName] = info.value, context.next = delegate.nextLoc, "return" !== context.method && (context.method = "next", context.arg = undefined), context.delegate = null, ContinueSentinel) : info : (context.method = "throw", context.arg = new TypeError("iterator result is not an object"), context.delegate = null, ContinueSentinel); } function pushTryEntry(locs) { var entry = { tryLoc: locs[0] }; 1 in locs && (entry.catchLoc = locs[1]), 2 in locs && (entry.finallyLoc = locs[2], entry.afterLoc = locs[3]), this.tryEntries.push(entry); } function resetTryEntry(entry) { var record = entry.completion || {}; record.type = "normal", delete record.arg, entry.completion = record; } function Context(tryLocsList) { this.tryEntries = [{ tryLoc: "root" }], tryLocsList.forEach(pushTryEntry, this), this.reset(!0); } function values(iterable) { if (iterable) { var iteratorMethod = iterable[iteratorSymbol]; if (iteratorMethod) return iteratorMethod.call(iterable); if ("function" == typeof iterable.next) return iterable; if (!isNaN(iterable.length)) { var i = -1, next = function next() { for (; ++i < iterable.length;) { if (hasOwn.call(iterable, i)) return next.value = iterable[i], next.done = !1, next; } return next.value = undefined, next.done = !0, next; }; return next.next = next; } } return { next: doneResult }; } function doneResult() { return { value: undefined, done: !0 }; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, defineProperty(Gp, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), defineProperty(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, toStringTagSymbol, "GeneratorFunction"), exports.isGeneratorFunction = function (genFun) { var ctor = "function" == typeof genFun && genFun.constructor; return !!ctor && (ctor === GeneratorFunction || "GeneratorFunction" === (ctor.displayName || ctor.name)); }, exports.mark = function (genFun) { return Object.setPrototypeOf ? Object.setPrototypeOf(genFun, GeneratorFunctionPrototype) : (genFun.__proto__ = GeneratorFunctionPrototype, define(genFun, toStringTagSymbol, "GeneratorFunction")), genFun.prototype = Object.create(Gp), genFun; }, exports.awrap = function (arg) { return { __await: arg }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, asyncIteratorSymbol, function () { return this; }), exports.AsyncIterator = AsyncIterator, exports.async = function (innerFn, outerFn, self, tryLocsList, PromiseImpl) { void 0 === PromiseImpl && (PromiseImpl = Promise); var iter = new AsyncIterator(wrap(innerFn, outerFn, self, tryLocsList), PromiseImpl); return exports.isGeneratorFunction(outerFn) ? iter : iter.next().then(function (result) { return result.done ? result.value : iter.next(); }); }, defineIteratorMethods(Gp), define(Gp, toStringTagSymbol, "Generator"), define(Gp, iteratorSymbol, function () { return this; }), define(Gp, "toString", function () { return "[object Generator]"; }), exports.keys = function (val) { var object = Object(val), keys = []; for (var key in object) { keys.push(key); } return keys.reverse(), function next() { for (; keys.length;) { var key = keys.pop(); if (key in object) return next.value = key, next.done = !1, next; } return next.done = !0, next; }; }, exports.values = values, Context.prototype = { constructor: Context, reset: function reset(skipTempReset) { if (this.prev = 0, this.next = 0, this.sent = this._sent = undefined, this.done = !1, this.delegate = null, this.method = "next", this.arg = undefined, this.tryEntries.forEach(resetTryEntry), !skipTempReset) for (var name in this) { "t" === name.charAt(0) && hasOwn.call(this, name) && !isNaN(+name.slice(1)) && (this[name] = undefined); } }, stop: function stop() { this.done = !0; var rootRecord = this.tryEntries[0].completion; if ("throw" === rootRecord.type) throw rootRecord.arg; return this.rval; }, dispatchException: function dispatchException(exception) { if (this.done) throw exception; var context = this; function handle(loc, caught) { return record.type = "throw", record.arg = exception, context.next = loc, caught && (context.method = "next", context.arg = undefined), !!caught; } for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i], record = entry.completion; if ("root" === entry.tryLoc) return handle("end"); if (entry.tryLoc <= this.prev) { var hasCatch = hasOwn.call(entry, "catchLoc"), hasFinally = hasOwn.call(entry, "finallyLoc"); if (hasCatch && hasFinally) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } else if (hasCatch) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); } else { if (!hasFinally) throw new Error("try statement without catch or finally"); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } } } }, abrupt: function abrupt(type, arg) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc <= this.prev && hasOwn.call(entry, "finallyLoc") && this.prev < entry.finallyLoc) { var finallyEntry = entry; break; } } finallyEntry && ("break" === type || "continue" === type) && finallyEntry.tryLoc <= arg && arg <= finallyEntry.finallyLoc && (finallyEntry = null); var record = finallyEntry ? finallyEntry.completion : {}; return record.type = type, record.arg = arg, finallyEntry ? (this.method = "next", this.next = finallyEntry.finallyLoc, ContinueSentinel) : this.complete(record); }, complete: function complete(record, afterLoc) { if ("throw" === record.type) throw record.arg; return "break" === record.type || "continue" === record.type ? this.next = record.arg : "return" === record.type ? (this.rval = this.arg = record.arg, this.method = "return", this.next = "end") : "normal" === record.type && afterLoc && (this.next = afterLoc), ContinueSentinel; }, finish: function finish(finallyLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.finallyLoc === finallyLoc) return this.complete(entry.completion, entry.afterLoc), resetTryEntry(entry), ContinueSentinel; } }, "catch": function _catch(tryLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc === tryLoc) { var record = entry.completion; if ("throw" === record.type) { var thrown = record.arg; resetTryEntry(entry); } return thrown; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(iterable, resultName, nextLoc) { return this.delegate = { iterator: values(iterable), resultName: resultName, nextLoc: nextLoc }, "next" === this.method && (this.arg = undefined), ContinueSentinel; } }, exports; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); } /**
+ * createPersonalizationStore — Portnet UI v2 · personalization
+ *
+ * Scoped, multi-capability, adapter-backed store. Generalises the
+ * useSyncExternalStore + cross-tab + SSR-safe pattern proven by
+ * useDensity (architecture doc §2.3 / §2.4).
+ *
+ * Core idea — sync snapshot, async adapter:
+ *   - The store holds a SYNCHRONOUS in-memory snapshot. `read()` is pure
+ *     (no mutation) so it is safe to call inside a useSyncExternalStore
+ *     selector. Components never await to render.
+ *   - Mutations are OPTIMISTIC: the snapshot updates synchronously and
+ *     subscribers are notified; the adapter persists asynchronously; on
+ *     failure the optimistic value is kept for the session and onError
+ *     fires. Swapping a remote adapter changes only *when* bytes hit the
+ *     wire, never how components read.
+ *   - STRUCTURAL SHARING: a write replaces only its capability slice; all
+ *     sibling slices keep their reference. This is what makes selectors
+ *     referentially stable and prevents cross-capability re-renders.
+ *
+ * The store is capability-AGNOSTIC: payloads are `unknown` and it learns
+ * defaults, schema versions and migrations from the schema registry (slices
+ * self-register at import time). Adding a capability requires no change here;
+ * the typed capability slices impose the concrete payload types on top via
+ * the generic read<T>/write<T> facades.
+ */
+/** The store's in-memory snapshot: { [capabilityId]: payload }. */
+
+/** A write value, or a functional updater `(previous) => next`. */
+
+/** The store handle returned by createPersonalizationStore. */
+
+var EMPTY_OBJECT = Object.freeze({});
+var isDev = typeof process !== "undefined" && process.env && process.env["NODE_ENV"] !== "production";
+function createPersonalizationStore(config) {
+  var cfg = config || {};
+  var scope = cfg.scope || {
+    userId: "anonymous"
+  };
+  var adapter = cfg.adapter || null;
+  var defaults = cfg.defaults || null;
+
+  /** Live snapshot: { [capabilityId]: payload }. New top-level ref on every change. */
+  var state = {};
+  /** Raw persisted envelopes from the adapter: { [capabilityId]: envelope }. */
+  var rawEnvelopes = {};
+  var hydrated = false;
+  var disposed = false;
+  var disconnect = null;
+  var runtime = {
+    onError: typeof cfg.onError === "function" ? cfg.onError : null,
+    hydrateStrategy: cfg.hydrateStrategy || "remote-wins"
+  };
+  var listeners = new Set();
+  var statuses = {};
+  var errors = {};
+  /** Capabilities written before hydration finished — protected from the initial load. */
+  var preHydrationWrites = new Set();
+
+  /* ── subscription / snapshot (useSyncExternalStore contract) ─────── */
+
+  function notify() {
+    // Iterate a snapshot so a listener unmounting during notify doesn't
+    // mutate the Set under iteration (same guard as useDensity).
+    var current = Array.from(listeners);
+    for (var _i = 0, _current = current; _i < _current.length; _i++) {
+      var listener = _current[_i];
+      listener();
+    }
+  }
+  function subscribe(listener) {
+    listeners.add(listener);
+    return function unsubscribe() {
+      listeners["delete"](listener);
+    };
+  }
+  function getSnapshot() {
+    return state;
+  }
+  function getServerSnapshot() {
+    return EMPTY_OBJECT;
+  }
+
+  /* ── seeds / materialisation ─────────────────────────────────────── */
+
+  function seedFor(capId) {
+    if (defaults && Object.prototype.hasOwnProperty.call(defaults, capId)) {
+      return defaults[capId];
+    }
+    var desc = (0, _schema.getCapability)(capId);
+    if (desc && desc.defaultState !== undefined) return desc.defaultState;
+    return EMPTY_OBJECT;
+  }
+  function reportError(capId, e) {
+    var err = e instanceof Error ? e : new Error(String(e || "personalization error"));
+    errors[capId] = err;
+    statuses[capId] = "error";
+    if (runtime.onError) {
+      try {
+        runtime.onError(err, {
+          scope: scope,
+          capabilityId: capId
+        });
+      } catch (_unused) {
+        /* host onError must not break the store */
+      }
+    }
+    if (isDev && typeof console !== "undefined" && console.error) {
+      // eslint-disable-next-line no-console
+      console.error('[@portnet/ui v2] personalization "' + capId + '":', err);
+    }
+  }
+
+  /** Pure: derive a capability payload from raw envelope (+migrate) or seed. */
+  function computePayload(capId) {
+    var raw = rawEnvelopes[capId];
+    if (raw && _typeof(raw) === "object" && Object.prototype.hasOwnProperty.call(raw, "payload")) {
+      var desc = (0, _schema.getCapability)(capId);
+      if (desc && typeof desc.migrate === "function") {
+        try {
+          return desc.migrate(typeof raw.schemaVersion === "number" ? raw.schemaVersion : 0, raw.payload);
+        } catch (e) {
+          reportError(capId, e);
+          return seedFor(capId);
+        }
+      }
+      return raw.payload;
+    }
+    return seedFor(capId);
+  }
+
+  /** Replace one slice immutably (structural sharing; new top-level ref). */
+  function setSlice(capId, payload) {
+    var next = {};
+    for (var _i2 = 0, _Object$keys = Object.keys(state); _i2 < _Object$keys.length; _i2++) {
+      var key = _Object$keys[_i2];
+      next[key] = state[key];
+    }
+    next[capId] = payload;
+    state = next;
+  }
+  function materialiseIfMissing(capId) {
+    if (state[capId] === undefined) setSlice(capId, computePayload(capId));
+  }
+
+  /* ── public reads ────────────────────────────────────────────────── */
+
+  /**
+   * Pure read for render. Never mutates state, so it is safe inside a
+   * useSyncExternalStore selector. Returns the materialised slice if
+   * present, else the (referentially stable) seed. `T` is caller-asserted.
+   */
+  function read(capId) {
+    return state[capId] !== undefined ? state[capId] : seedFor(capId);
+  }
+
+  /**
+   * Effectful: ensure a capability slice exists in the snapshot. Capability
+   * hooks call this from a useEffect (NEVER during render) so a capability
+   * that registered after the store hydrated still materialises from any
+   * persisted data.
+   */
+  function ensureCapability(capId) {
+    if (disposed) return;
+    if (state[capId] !== undefined) return;
+    setSlice(capId, computePayload(capId));
+    notify();
+  }
+
+  /* ── writes (optimistic + async persist) ─────────────────────────── */
+
+  function write(capId, updater, options) {
+    if (disposed) return undefined;
+    var persist = !options || options.persist !== false;
+    materialiseIfMissing(capId);
+    var prev = state[capId];
+    var next = typeof updater === "function" ? updater(prev) : updater;
+    if (Object.is(next, prev)) return prev; // no-op short-circuit
+
+    setSlice(capId, next);
+    if (!hydrated) preHydrationWrites.add(capId);
+    notify();
+    if (persist && adapter && typeof adapter.save === "function") {
+      // Capture the narrowed adapter: the `if` narrowing does not reach into
+      // the async closures below, and `save` is required on Adapter.
+      var activeAdapter = adapter;
+      var desc = (0, _schema.getCapability)(capId);
+      var envelope = (0, _schema.makeEnvelope)(desc ? desc.schemaVersion : 1, next);
+      statuses[capId] = "saving";
+      Promise.resolve().then(function persistSlice() {
+        return activeAdapter.save(scope, capId, envelope);
+      }).then(function onSaved() {
+        if (disposed) return;
+        statuses[capId] = "idle";
+        errors[capId] = null;
+      })["catch"](function onSaveFailed(e) {
+        if (disposed) return;
+        // Keep the optimistic value for the session; surface the error.
+        reportError(capId, e);
+      });
+    }
+    return next;
+  }
+
+  /** Reset a capability to its seed and drop it from storage. */
+  function clearCapability(capId) {
+    if (disposed) return;
+    setSlice(capId, seedFor(capId));
+    notify();
+    if (adapter && typeof adapter.remove === "function") {
+      var activeAdapter = adapter;
+      Promise.resolve().then(function removeSlice() {
+        return activeAdapter.remove ? activeAdapter.remove(scope, capId) : undefined;
+      })["catch"](function onRemoveFailed(e) {
+        reportError(capId, e);
+      });
+    }
+  }
+
+  /* ── hydration ───────────────────────────────────────────────────── */
+
+  function rematerialiseAfterLoad() {
+    var ids = new Set();
+    Object.keys(rawEnvelopes).forEach(function addRawId(id) {
+      ids.add(id);
+    });
+    (0, _schema.getRegisteredCapabilities)().forEach(function addRegisteredId(d) {
+      ids.add(d.id);
+    });
+    var next = {};
+    for (var _i3 = 0, _Object$keys2 = Object.keys(state); _i3 < _Object$keys2.length; _i3++) {
+      var key = _Object$keys2[_i3];
+      next[key] = state[key];
+    }
+    ids.forEach(function materialise(capId) {
+      // Persisted truth wins over a pre-hydration seed, but never clobbers
+      // an optimistic write the user made during the hydrating window.
+      if (preHydrationWrites.has(capId)) return;
+      next[capId] = computePayload(capId);
+    });
+    state = next;
+  }
+
+  /** Synchronous seed at creation (flash-free for adapters exposing loadSync). */
+  function trySyncSeed() {
+    if (typeof window === "undefined") return;
+    if (!adapter || typeof adapter.loadSync !== "function") return;
+    try {
+      var loaded = adapter.loadSync(scope);
+      if (loaded && _typeof(loaded) === "object") {
+        rawEnvelopes = loaded;
+        rematerialiseAfterLoad();
+        hydrated = true;
+      }
+    } catch (e) {
+      // Fall back to async hydrate().
+      if (isDev && typeof console !== "undefined" && console.warn) {
+        // eslint-disable-next-line no-console
+        console.warn("[@portnet/ui v2] personalization loadSync failed; deferring to async hydrate.", e);
+      }
+    }
+  }
+  function hydrate() {
+    return _hydrate.apply(this, arguments);
+  }
+  function _hydrate() {
+    _hydrate = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+      var loaded;
+      return _regeneratorRuntime().wrap(function _callee$(_context) {
+        while (1) {
+          switch (_context.prev = _context.next) {
+            case 0:
+              if (!disposed) {
+                _context.next = 2;
+                break;
+              }
+              return _context.abrupt("return");
+            case 2:
+              if (!(typeof window === "undefined")) {
+                _context.next = 4;
+                break;
+              }
+              return _context.abrupt("return");
+            case 4:
+              if (!(hydrated && adapter && adapter.capabilities && adapter.capabilities.remote === false)) {
+                _context.next = 6;
+                break;
+              }
+              return _context.abrupt("return");
+            case 6:
+              _context.prev = 6;
+              if (!(adapter && typeof adapter.load === "function")) {
+                _context.next = 13;
+                break;
+              }
+              _context.next = 10;
+              return adapter.load(scope);
+            case 10:
+              _context.t0 = _context.sent;
+              _context.next = 14;
+              break;
+            case 13:
+              _context.t0 = {};
+            case 14:
+              loaded = _context.t0;
+              if (!disposed) {
+                _context.next = 17;
+                break;
+              }
+              return _context.abrupt("return");
+            case 17:
+              rawEnvelopes = loaded && _typeof(loaded) === "object" ? loaded : {};
+              _context.next = 24;
+              break;
+            case 20:
+              _context.prev = 20;
+              _context.t1 = _context["catch"](6);
+              rawEnvelopes = {};
+              reportError("*", _context.t1);
+            case 24:
+              rematerialiseAfterLoad();
+              hydrated = true;
+              preHydrationWrites.clear();
+              notify();
+            case 28:
+            case "end":
+              return _context.stop();
+          }
+        }
+      }, _callee, null, [[6, 20]]);
+    }));
+    return _hydrate.apply(this, arguments);
+  }
+  function reloadCapability(_x) {
+    return _reloadCapability.apply(this, arguments);
+  }
+  /* ── cross-tab / external changes ────────────────────────────────── */
+  function _reloadCapability() {
+    _reloadCapability = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2(capId) {
+      var loaded;
+      return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+        while (1) {
+          switch (_context2.prev = _context2.next) {
+            case 0:
+              if (!disposed) {
+                _context2.next = 2;
+                break;
+              }
+              return _context2.abrupt("return");
+            case 2:
+              _context2.prev = 2;
+              if (!(adapter && typeof adapter.load === "function")) {
+                _context2.next = 9;
+                break;
+              }
+              _context2.next = 6;
+              return adapter.load(scope);
+            case 6:
+              _context2.t0 = _context2.sent;
+              _context2.next = 10;
+              break;
+            case 9:
+              _context2.t0 = {};
+            case 10:
+              loaded = _context2.t0;
+              if (!disposed) {
+                _context2.next = 13;
+                break;
+              }
+              return _context2.abrupt("return");
+            case 13:
+              rawEnvelopes = loaded && _typeof(loaded) === "object" ? loaded : {};
+              _context2.next = 20;
+              break;
+            case 16:
+              _context2.prev = 16;
+              _context2.t1 = _context2["catch"](2);
+              reportError(capId, _context2.t1);
+              return _context2.abrupt("return");
+            case 20:
+              setSlice(capId, computePayload(capId));
+              notify();
+            case 22:
+            case "end":
+              return _context2.stop();
+          }
+        }
+      }, _callee2, null, [[2, 16]]);
+    }));
+    return _reloadCapability.apply(this, arguments);
+  }
+  function connect() {
+    if (disposed) return function noop() {};
+    if (!adapter || typeof adapter.subscribe !== "function") {
+      return function noop() {};
+    }
+    disconnect = adapter.subscribe(scope, function onExternalChange(capId) {
+      if (disposed) return;
+      if (runtime.hydrateStrategy === "local-wins") return; // ignore external changes
+      // remote-wins / merge → adopt the external change.
+      // NOTE: "merge" currently behaves as remote-wins at the store level;
+      // true merge is slice-specific and deferred to a slice opt-in.
+      reloadCapability(capId);
+    });
+    return typeof disconnect === "function" ? disconnect : function noop() {};
+  }
+  function dispose() {
+    disposed = true;
+    if (typeof disconnect === "function") {
+      try {
+        disconnect();
+      } catch (_unused2) {
+        /* ignore */
+      }
+      disconnect = null;
+    }
+    listeners.clear();
+  }
+
+  /* ── runtime options / introspection ─────────────────────────────── */
+
+  function setRuntime(opts) {
+    runtime = {
+      onError: opts && typeof opts.onError === "function" ? opts.onError : null,
+      hydrateStrategy: opts && opts.hydrateStrategy || "remote-wins"
+    };
+  }
+  function status(capId) {
+    return statuses[capId] || (hydrated ? "idle" : "hydrating");
+  }
+  function error(capId) {
+    return errors[capId] || null;
+  }
+  function isHydrated() {
+    return hydrated;
+  }
+  function getScope() {
+    return scope;
+  }
+
+  // Seed synchronously once everything above is initialised.
+  trySyncSeed();
+  return {
+    // useSyncExternalStore contract
+    subscribe: subscribe,
+    getSnapshot: getSnapshot,
+    getServerSnapshot: getServerSnapshot,
+    // reads / writes
+    read: read,
+    write: write,
+    ensureCapability: ensureCapability,
+    clearCapability: clearCapability,
+    // lifecycle
+    hydrate: hydrate,
+    connect: connect,
+    dispose: dispose,
+    setRuntime: setRuntime,
+    // introspection
+    status: status,
+    error: error,
+    isHydrated: isHydrated,
+    getScope: getScope
+  };
+}
+//# sourceMappingURL=createPersonalizationStore.js.map