@openshop/svelte 0.2.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenShop contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+import { Readable, Writable } from 'svelte/store';
+import { ReadableStore, Selector, EqualityFn, Cart, CartStatus, CartStore, OptionSelection, ProductVariant, OptionValueState, Product, PredictiveSearchResult, Locale, I18n } from '@openshop/core';
+export { formatMoney } from '@openshop/core';
+
+/**
+ * Adapt an OpenShop reactive store into a Svelte `Readable` of a selected
+ * slice. The Svelte store contract (subscribe-with-immediate-value) maps
+ * cleanly onto the core's `subscribeRaw` + selector model, and the underlying
+ * subscription is released when the last Svelte subscriber leaves.
+ */
+declare function selectStore<T, R>(store: ReadableStore<T>, selector: Selector<T, R>, equals?: EqualityFn<R>): Readable<R>;
+
+interface CartStores {
+    cart: Readable<Cart | null>;
+    count: Readable<number>;
+    status: Readable<CartStatus>;
+    isUpdating: Readable<boolean>;
+    error: Readable<string | null>;
+    actions: {
+        addLine: CartStore["addLine"];
+        addLines: CartStore["addLines"];
+        updateLine: CartStore["updateLine"];
+        removeLine: CartStore["removeLine"];
+        setDiscountCodes: CartStore["setDiscountCodes"];
+        refresh: CartStore["refresh"];
+    };
+}
+/**
+ * Derive a set of Svelte stores (plus bound actions) from a `CartStore`.
+ * Each store updates only when its slice changes.
+ *
+ * ```svelte
+ * <script>
+ *   import { createCartStores } from "@openshop/svelte";
+ *   const { count, actions } = createCartStores(cart);
+ * </script>
+ * <button on:click={() => actions.addLine({ merchandiseId })}>Cart {$count}</button>
+ * ```
+ */
+declare function createCartStores(cart: CartStore): CartStores;
+
+interface VariantSelectionStores {
+    selection: Writable<OptionSelection>;
+    selectedVariant: Readable<ProductVariant | undefined>;
+    options: Readable<{
+        name: string;
+        values: OptionValueState[];
+    }[]>;
+    setOption: (optionName: string, value: string) => void;
+}
+/** Svelte stores driving variant selection for a product. */
+declare function createVariantSelection(product: Product, initial?: OptionSelection): VariantSelectionStores;
+
+interface PredictiveSearchOptions {
+    debounceMs?: number;
+    minLength?: number;
+}
+interface PredictiveSearchStores {
+    term: Writable<string>;
+    results: Readable<PredictiveSearchResult>;
+    loading: Readable<boolean>;
+    error: Readable<unknown>;
+    clear: () => void;
+    /** Stop watching `term`. Call when the component is destroyed. */
+    destroy: () => void;
+}
+/**
+ * Debounced predictive search as Svelte stores, with stale-response protection.
+ * Bind an input to `term`; read `$results` / `$loading`.
+ */
+declare function createPredictiveSearch(search: (term: string) => Promise<PredictiveSearchResult>, options?: PredictiveSearchOptions): PredictiveSearchStores;
+
+interface I18nHelpers {
+    locale: Locale;
+    locales: Locale[];
+    localizePath: (path: string, locale?: Locale) => string;
+    alternates: (path: string) => {
+        locale: Locale;
+        href: string;
+    }[];
+}
+/**
+ * Build locale helpers bound to the active locale. Framework-neutral (no Svelte
+ * context dependency) so it works in load functions and components alike; stash
+ * the result in Svelte context yourself if you want app-wide access.
+ */
+declare function createI18nHelpers(i18n: I18n, locale: Locale, origin?: string): I18nHelpers;
+
+export { type CartStores, type I18nHelpers, type PredictiveSearchOptions, type PredictiveSearchStores, type VariantSelectionStores, createCartStores, createI18nHelpers, createPredictiveSearch, createVariantSelection, selectStore };

package/dist/index.js

@@ -0,0 +1,124 @@
+import { readable, writable, derived } from 'svelte/store';
+import { refEquals, getInitialSelection, findVariantBySelection, getOptionValueStates } from '@openshop/core';
+export { formatMoney } from '@openshop/core';
+
+// src/store.ts
+function selectStore(store, selector, equals = refEquals) {
+  return readable(selector(store.get()), (set) => {
+    let current = selector(store.get());
+    set(current);
+    return store.subscribeRaw(() => {
+      const next = selector(store.get());
+      if (!equals(current, next)) {
+        current = next;
+        set(next);
+      }
+    });
+  });
+}
+
+// src/cart.ts
+function createCartStores(cart) {
+  return {
+    cart: selectStore(cart, (s) => s.cart),
+    count: selectStore(cart, (s) => s.cart?.totalQuantity ?? 0),
+    status: selectStore(cart, (s) => s.status),
+    isUpdating: selectStore(cart, (s) => s.status === "updating"),
+    error: selectStore(cart, (s) => s.error),
+    actions: {
+      addLine: cart.addLine.bind(cart),
+      addLines: cart.addLines.bind(cart),
+      updateLine: cart.updateLine.bind(cart),
+      removeLine: cart.removeLine.bind(cart),
+      setDiscountCodes: cart.setDiscountCodes.bind(cart),
+      refresh: cart.refresh.bind(cart)
+    }
+  };
+}
+function createVariantSelection(product, initial) {
+  const selection = writable(
+    initial ?? getInitialSelection(product)
+  );
+  const selectedVariant = derived(
+    selection,
+    ($selection) => findVariantBySelection(product, $selection)
+  );
+  const options = derived(
+    selection,
+    ($selection) => product.options.map((option) => ({
+      name: option.name,
+      values: getOptionValueStates(product, option.name, $selection)
+    }))
+  );
+  function setOption(optionName, value) {
+    selection.update((prev) => ({ ...prev, [optionName]: value }));
+  }
+  return { selection, selectedVariant, options, setOption };
+}
+var EMPTY = {
+  products: [],
+  collections: [],
+  pages: [],
+  articles: [],
+  queries: []
+};
+function createPredictiveSearch(search, options = {}) {
+  const { debounceMs = 200, minLength = 2 } = options;
+  const term = writable("");
+  const results = writable(EMPTY);
+  const loading = writable(false);
+  const error = writable(null);
+  let requestId = 0;
+  let timer;
+  const unsubscribe = term.subscribe((value) => {
+    if (timer) clearTimeout(timer);
+    const trimmed = value.trim();
+    if (trimmed.length < minLength) {
+      results.set(EMPTY);
+      loading.set(false);
+      return;
+    }
+    const id = ++requestId;
+    loading.set(true);
+    timer = setTimeout(async () => {
+      try {
+        const next = await search(trimmed);
+        if (id === requestId) {
+          results.set(next);
+          error.set(null);
+        }
+      } catch (err) {
+        if (id === requestId) error.set(err);
+      } finally {
+        if (id === requestId) loading.set(false);
+      }
+    }, debounceMs);
+  });
+  function clear() {
+    requestId += 1;
+    if (timer) clearTimeout(timer);
+    term.set("");
+    results.set(EMPTY);
+    loading.set(false);
+    error.set(null);
+  }
+  function destroy() {
+    if (timer) clearTimeout(timer);
+    unsubscribe();
+  }
+  return { term, results, loading, error, clear, destroy };
+}
+
+// src/i18n.ts
+function createI18nHelpers(i18n, locale, origin) {
+  return {
+    locale,
+    locales: i18n.locales,
+    localizePath: (path, target = locale) => i18n.localizePath(path, target, origin),
+    alternates: (path) => i18n.alternates(path, origin)
+  };
+}
+
+export { createCartStores, createI18nHelpers, createPredictiveSearch, createVariantSelection, selectStore };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/store.ts","../src/cart.ts","../src/product.ts","../src/search.ts","../src/i18n.ts"],"names":["writable"],"mappings":"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","file":"index.js","sourcesContent":["import { readable, type Readable } from \"svelte/store\";\r\nimport {\r\n  refEquals,\r\n  type EqualityFn,\r\n  type ReadableStore,\r\n  type Selector,\r\n} from \"@openshop/core\";\r\n\r\n/**\r\n * Adapt an OpenShop reactive store into a Svelte `Readable` of a selected\r\n * slice. The Svelte store contract (subscribe-with-immediate-value) maps\r\n * cleanly onto the core's `subscribeRaw` + selector model, and the underlying\r\n * subscription is released when the last Svelte subscriber leaves.\r\n */\r\nexport function selectStore<T, R>(\r\n  store: ReadableStore<T>,\r\n  selector: Selector<T, R>,\r\n  equals: EqualityFn<R> = refEquals,\r\n): Readable<R> {\r\n  return readable(selector(store.get()), (set) => {\r\n    let current = selector(store.get());\r\n    set(current);\r\n    return store.subscribeRaw(() => {\r\n      const next = selector(store.get());\r\n      if (!equals(current, next)) {\r\n        current = next;\r\n        set(next);\r\n      }\r\n    });\r\n  });\r\n}\r\n","import type { Readable } from \"svelte/store\";\r\nimport type { Cart, CartStatus, CartStore } from \"@openshop/core\";\r\nimport { selectStore } from \"./store.js\";\r\n\r\nexport interface CartStores {\r\n  cart: Readable<Cart | null>;\r\n  count: Readable<number>;\r\n  status: Readable<CartStatus>;\r\n  isUpdating: Readable<boolean>;\r\n  error: Readable<string | null>;\r\n  actions: {\r\n    addLine: CartStore[\"addLine\"];\r\n    addLines: CartStore[\"addLines\"];\r\n    updateLine: CartStore[\"updateLine\"];\r\n    removeLine: CartStore[\"removeLine\"];\r\n    setDiscountCodes: CartStore[\"setDiscountCodes\"];\r\n    refresh: CartStore[\"refresh\"];\r\n  };\r\n}\r\n\r\n/**\r\n * Derive a set of Svelte stores (plus bound actions) from a `CartStore`.\r\n * Each store updates only when its slice changes.\r\n *\r\n * ```svelte\r\n * <script>\r\n *   import { createCartStores } from \"@openshop/svelte\";\r\n *   const { count, actions } = createCartStores(cart);\r\n * </script>\r\n * <button on:click={() => actions.addLine({ merchandiseId })}>Cart {$count}</button>\r\n * ```\r\n */\r\nexport function createCartStores(cart: CartStore): CartStores {\r\n  return {\r\n    cart: selectStore(cart, (s) => s.cart),\r\n    count: selectStore(cart, (s) => s.cart?.totalQuantity ?? 0),\r\n    status: selectStore(cart, (s) => s.status),\r\n    isUpdating: selectStore(cart, (s) => s.status === \"updating\"),\r\n    error: selectStore(cart, (s) => s.error),\r\n    actions: {\r\n      addLine: cart.addLine.bind(cart),\r\n      addLines: cart.addLines.bind(cart),\r\n      updateLine: cart.updateLine.bind(cart),\r\n      removeLine: cart.removeLine.bind(cart),\r\n      setDiscountCodes: cart.setDiscountCodes.bind(cart),\r\n      refresh: cart.refresh.bind(cart),\r\n    },\r\n  };\r\n}\r\n","import { derived, writable, type Readable, type Writable } from \"svelte/store\";\r\nimport {\r\n  findVariantBySelection,\r\n  getInitialSelection,\r\n  getOptionValueStates,\r\n  type OptionSelection,\r\n  type OptionValueState,\r\n  type Product,\r\n  type ProductVariant,\r\n} from \"@openshop/core\";\r\n\r\nexport interface VariantSelectionStores {\r\n  selection: Writable<OptionSelection>;\r\n  selectedVariant: Readable<ProductVariant | undefined>;\r\n  options: Readable<{ name: string; values: OptionValueState[] }[]>;\r\n  setOption: (optionName: string, value: string) => void;\r\n}\r\n\r\n/** Svelte stores driving variant selection for a product. */\r\nexport function createVariantSelection(\r\n  product: Product,\r\n  initial?: OptionSelection,\r\n): VariantSelectionStores {\r\n  const selection = writable<OptionSelection>(\r\n    initial ?? getInitialSelection(product),\r\n  );\r\n\r\n  const selectedVariant = derived(selection, ($selection) =>\r\n    findVariantBySelection(product, $selection),\r\n  );\r\n\r\n  const options = derived(selection, ($selection) =>\r\n    product.options.map((option) => ({\r\n      name: option.name,\r\n      values: getOptionValueStates(product, option.name, $selection),\r\n    })),\r\n  );\r\n\r\n  function setOption(optionName: string, value: string): void {\r\n    selection.update((prev) => ({ ...prev, [optionName]: value }));\r\n  }\r\n\r\n  return { selection, selectedVariant, options, setOption };\r\n}\r\n","import { writable, type Readable, type Writable } from \"svelte/store\";\r\nimport type { PredictiveSearchResult } from \"@openshop/core\";\r\n\r\nconst EMPTY: PredictiveSearchResult = {\r\n  products: [],\r\n  collections: [],\r\n  pages: [],\r\n  articles: [],\r\n  queries: [],\r\n};\r\n\r\nexport interface PredictiveSearchOptions {\r\n  debounceMs?: number;\r\n  minLength?: number;\r\n}\r\n\r\nexport interface PredictiveSearchStores {\r\n  term: Writable<string>;\r\n  results: Readable<PredictiveSearchResult>;\r\n  loading: Readable<boolean>;\r\n  error: Readable<unknown>;\r\n  clear: () => void;\r\n  /** Stop watching `term`. Call when the component is destroyed. */\r\n  destroy: () => void;\r\n}\r\n\r\n/**\r\n * Debounced predictive search as Svelte stores, with stale-response protection.\r\n * Bind an input to `term`; read `$results` / `$loading`.\r\n */\r\nexport function createPredictiveSearch(\r\n  search: (term: string) => Promise<PredictiveSearchResult>,\r\n  options: PredictiveSearchOptions = {},\r\n): PredictiveSearchStores {\r\n  const { debounceMs = 200, minLength = 2 } = options;\r\n  const term = writable(\"\");\r\n  const results = writable<PredictiveSearchResult>(EMPTY);\r\n  const loading = writable(false);\r\n  const error = writable<unknown>(null);\r\n\r\n  let requestId = 0;\r\n  let timer: ReturnType<typeof setTimeout> | undefined;\r\n\r\n  const unsubscribe = term.subscribe((value) => {\r\n    if (timer) clearTimeout(timer);\r\n    const trimmed = value.trim();\r\n    if (trimmed.length < minLength) {\r\n      results.set(EMPTY);\r\n      loading.set(false);\r\n      return;\r\n    }\r\n    const id = ++requestId;\r\n    loading.set(true);\r\n    timer = setTimeout(async () => {\r\n      try {\r\n        const next = await search(trimmed);\r\n        if (id === requestId) {\r\n          results.set(next);\r\n          error.set(null);\r\n        }\r\n      } catch (err) {\r\n        if (id === requestId) error.set(err);\r\n      } finally {\r\n        if (id === requestId) loading.set(false);\r\n      }\r\n    }, debounceMs);\r\n  });\r\n\r\n  function clear(): void {\r\n    requestId += 1;\r\n    if (timer) clearTimeout(timer);\r\n    term.set(\"\");\r\n    results.set(EMPTY);\r\n    loading.set(false);\r\n    error.set(null);\r\n  }\r\n\r\n  function destroy(): void {\r\n    if (timer) clearTimeout(timer);\r\n    unsubscribe();\r\n  }\r\n\r\n  return { term, results, loading, error, clear, destroy };\r\n}\r\n","import type { I18n, Locale } from \"@openshop/core\";\r\n\r\nexport interface I18nHelpers {\r\n  locale: Locale;\r\n  locales: Locale[];\r\n  localizePath: (path: string, locale?: Locale) => string;\r\n  alternates: (path: string) => { locale: Locale; href: string }[];\r\n}\r\n\r\n/**\r\n * Build locale helpers bound to the active locale. Framework-neutral (no Svelte\r\n * context dependency) so it works in load functions and components alike; stash\r\n * the result in Svelte context yourself if you want app-wide access.\r\n */\r\nexport function createI18nHelpers(\r\n  i18n: I18n,\r\n  locale: Locale,\r\n  origin?: string,\r\n): I18nHelpers {\r\n  return {\r\n    locale,\r\n    locales: i18n.locales,\r\n    localizePath: (path, target = locale) =>\r\n      i18n.localizePath(path, target, origin),\r\n    alternates: (path) => i18n.alternates(path, origin),\r\n  };\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@openshop/svelte",
+  "version": "0.2.0",
+  "description": "Svelte stores for OpenShop's framework-agnostic commerce core.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "svelte": ">=4.0.0"
+  },
+  "dependencies": {
+    "@openshop/core": "0.2.0"
+  },
+  "devDependencies": {
+    "svelte": "^5.15.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+  }
+}