@orderlyshop/web-components 0.1.0

package/dist/stores.d.ts

@@ -0,0 +1,46 @@
+import { DraftOrder } from '@orderlyshop/core-client';
+import { C as CheckoutProfile } from './types-CCQDd6Nd.js';
+import './query.js';
+
+interface BasketStore {
+    load(): DraftOrder | undefined | Promise<DraftOrder | undefined>;
+    save(draft: DraftOrder): void | Promise<void>;
+    clear(): void | Promise<void>;
+}
+interface CheckoutProfileStore {
+    load(): CheckoutProfile | undefined | Promise<CheckoutProfile | undefined>;
+    save(profile: CheckoutProfile): void | Promise<void>;
+    clear(): void | Promise<void>;
+}
+declare const defaultBasketStorageKey = "orderly.web-components.basket.v1";
+declare const defaultCheckoutProfileStorageKey = "orderly.web-components.checkout-profile.v1";
+declare class MemoryBasketStore implements BasketStore {
+    private draft?;
+    load(): DraftOrder | undefined;
+    save(draft: DraftOrder): void;
+    clear(): void;
+}
+declare class LocalStorageBasketStore implements BasketStore {
+    private readonly key;
+    constructor(key?: string);
+    load(): DraftOrder | undefined;
+    save(draft: DraftOrder): void;
+    clear(): void;
+}
+declare class MemoryCheckoutProfileStore implements CheckoutProfileStore {
+    private profile?;
+    load(): CheckoutProfile | undefined;
+    save(profile: CheckoutProfile): void;
+    clear(): void;
+}
+declare class LocalStorageCheckoutProfileStore implements CheckoutProfileStore {
+    private readonly key;
+    constructor(key?: string);
+    load(): CheckoutProfile | undefined;
+    save(profile: CheckoutProfile): void;
+    clear(): void;
+}
+declare function createEmptyDraftOrder(): DraftOrder;
+declare function sanitizeCheckoutProfile(profile: Partial<CheckoutProfile> | undefined): CheckoutProfile;
+
+export { type BasketStore, type CheckoutProfileStore, LocalStorageBasketStore, LocalStorageCheckoutProfileStore, MemoryBasketStore, MemoryCheckoutProfileStore, createEmptyDraftOrder, defaultBasketStorageKey, defaultCheckoutProfileStorageKey, sanitizeCheckoutProfile };

package/dist/stores.js

@@ -0,0 +1,145 @@
+// src/stores.ts
+import { create, fromJsonString, toJsonString } from "@bufbuild/protobuf";
+import {
+  AddressSchema,
+  DraftOrderSchema,
+  PhoneNumberSchema
+} from "@orderlyshop/core-client";
+var defaultBasketStorageKey = "orderly.web-components.basket.v1";
+var defaultCheckoutProfileStorageKey = "orderly.web-components.checkout-profile.v1";
+var MemoryBasketStore = class {
+  draft;
+  load() {
+    return this.draft;
+  }
+  save(draft) {
+    this.draft = draft;
+  }
+  clear() {
+    this.draft = void 0;
+  }
+};
+var LocalStorageBasketStore = class {
+  constructor(key = defaultBasketStorageKey) {
+    this.key = key;
+  }
+  key;
+  load() {
+    const storage = getStorage();
+    if (!storage) {
+      return void 0;
+    }
+    const raw = storage.getItem(this.key);
+    if (!raw) {
+      return void 0;
+    }
+    try {
+      return fromJsonString(DraftOrderSchema, raw);
+    } catch {
+      return void 0;
+    }
+  }
+  save(draft) {
+    const storage = getStorage();
+    if (!storage) {
+      return;
+    }
+    storage.setItem(this.key, toJsonString(DraftOrderSchema, draft));
+  }
+  clear() {
+    getStorage()?.removeItem(this.key);
+  }
+};
+var MemoryCheckoutProfileStore = class {
+  profile;
+  load() {
+    return this.profile;
+  }
+  save(profile) {
+    this.profile = sanitizeCheckoutProfile(profile);
+  }
+  clear() {
+    this.profile = void 0;
+  }
+};
+var LocalStorageCheckoutProfileStore = class {
+  constructor(key = defaultCheckoutProfileStorageKey) {
+    this.key = key;
+  }
+  key;
+  load() {
+    const storage = getStorage();
+    if (!storage) {
+      return void 0;
+    }
+    const raw = storage.getItem(this.key);
+    if (!raw) {
+      return void 0;
+    }
+    try {
+      const parsed = JSON.parse(raw);
+      return sanitizeCheckoutProfile({
+        address: parsed.address ? fromJsonString(AddressSchema, parsed.address) : void 0,
+        email: parsed.email,
+        phoneNumber: parsed.phoneNumber ? fromJsonString(PhoneNumberSchema, parsed.phoneNumber) : void 0,
+        updatedAt: parsed.updatedAt
+      });
+    } catch {
+      return void 0;
+    }
+  }
+  save(profile) {
+    const storage = getStorage();
+    if (!storage) {
+      return;
+    }
+    const sanitized = sanitizeCheckoutProfile(profile);
+    storage.setItem(this.key, JSON.stringify({
+      address: sanitized.address ? toJsonString(AddressSchema, sanitized.address) : void 0,
+      email: sanitized.email,
+      phoneNumber: sanitized.phoneNumber ? toJsonString(PhoneNumberSchema, sanitized.phoneNumber) : void 0,
+      updatedAt: sanitized.updatedAt
+    }));
+  }
+  clear() {
+    getStorage()?.removeItem(this.key);
+  }
+};
+function createEmptyDraftOrder() {
+  return create(DraftOrderSchema, {
+    OrderLines: [],
+    ExtraLines: [],
+    Errors: [],
+    PaymentOptions: [],
+    Discounts: [],
+    Vouchers: [],
+    Messages: [],
+    Related: []
+  });
+}
+function sanitizeCheckoutProfile(profile) {
+  return {
+    address: profile?.address ? create(AddressSchema, profile.address) : void 0,
+    email: typeof profile?.email === "string" && profile.email.length > 0 ? profile.email : void 0,
+    phoneNumber: profile?.phoneNumber ? create(PhoneNumberSchema, profile.phoneNumber) : void 0,
+    updatedAt: typeof profile?.updatedAt === "string" && profile.updatedAt.length > 0 ? profile.updatedAt : (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function getStorage() {
+  try {
+    return globalThis.localStorage;
+  } catch {
+    return void 0;
+  }
+}
+export {
+  LocalStorageBasketStore,
+  LocalStorageCheckoutProfileStore,
+  MemoryBasketStore,
+  MemoryCheckoutProfileStore,
+  createEmptyDraftOrder,
+  defaultBasketStorageKey,
+  defaultCheckoutProfileStorageKey,
+  sanitizeCheckoutProfile
+};
+//# sourceMappingURL=stores.js.map

package/dist/stores.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stores.ts"],"sourcesContent":["import { create, fromJsonString, toJsonString } from \"@bufbuild/protobuf\";\nimport {\n  AddressSchema,\n  DraftOrderSchema,\n  PhoneNumberSchema,\n  type Address,\n  type DraftOrder,\n  type PhoneNumber\n} from \"@orderlyshop/core-client\";\nimport type { CheckoutProfile } from \"./types.js\";\n\nexport interface BasketStore {\n  load(): DraftOrder | undefined | Promise<DraftOrder | undefined>;\n  save(draft: DraftOrder): void | Promise<void>;\n  clear(): void | Promise<void>;\n}\n\nexport interface CheckoutProfileStore {\n  load(): CheckoutProfile | undefined | Promise<CheckoutProfile | undefined>;\n  save(profile: CheckoutProfile): void | Promise<void>;\n  clear(): void | Promise<void>;\n}\n\nexport const defaultBasketStorageKey = \"orderly.web-components.basket.v1\";\nexport const defaultCheckoutProfileStorageKey = \"orderly.web-components.checkout-profile.v1\";\n\nexport class MemoryBasketStore implements BasketStore {\n  private draft?: DraftOrder;\n\n  load(): DraftOrder | undefined {\n    return this.draft;\n  }\n\n  save(draft: DraftOrder): void {\n    this.draft = draft;\n  }\n\n  clear(): void {\n    this.draft = undefined;\n  }\n}\n\nexport class LocalStorageBasketStore implements BasketStore {\n  constructor(private readonly key = defaultBasketStorageKey) {}\n\n  load(): DraftOrder | undefined {\n    const storage = getStorage();\n    if (!storage) {\n      return undefined;\n    }\n    const raw = storage.getItem(this.key);\n    if (!raw) {\n      return undefined;\n    }\n    try {\n      return fromJsonString(DraftOrderSchema, raw);\n    } catch {\n      return undefined;\n    }\n  }\n\n  save(draft: DraftOrder): void {\n    const storage = getStorage();\n    if (!storage) {\n      return;\n    }\n    storage.setItem(this.key, toJsonString(DraftOrderSchema, draft));\n  }\n\n  clear(): void {\n    getStorage()?.removeItem(this.key);\n  }\n}\n\nexport class MemoryCheckoutProfileStore implements CheckoutProfileStore {\n  private profile?: CheckoutProfile;\n\n  load(): CheckoutProfile | undefined {\n    return this.profile;\n  }\n\n  save(profile: CheckoutProfile): void {\n    this.profile = sanitizeCheckoutProfile(profile);\n  }\n\n  clear(): void {\n    this.profile = undefined;\n  }\n}\n\nexport class LocalStorageCheckoutProfileStore implements CheckoutProfileStore {\n  constructor(private readonly key = defaultCheckoutProfileStorageKey) {}\n\n  load(): CheckoutProfile | undefined {\n    const storage = getStorage();\n    if (!storage) {\n      return undefined;\n    }\n    const raw = storage.getItem(this.key);\n    if (!raw) {\n      return undefined;\n    }\n    try {\n      const parsed = JSON.parse(raw) as StoredCheckoutProfile;\n      return sanitizeCheckoutProfile({\n        address: parsed.address ? fromJsonString(AddressSchema, parsed.address) : undefined,\n        email: parsed.email,\n        phoneNumber: parsed.phoneNumber ? fromJsonString(PhoneNumberSchema, parsed.phoneNumber) : undefined,\n        updatedAt: parsed.updatedAt\n      });\n    } catch {\n      return undefined;\n    }\n  }\n\n  save(profile: CheckoutProfile): void {\n    const storage = getStorage();\n    if (!storage) {\n      return;\n    }\n    const sanitized = sanitizeCheckoutProfile(profile);\n    storage.setItem(this.key, JSON.stringify({\n      address: sanitized.address ? toJsonString(AddressSchema, sanitized.address) : undefined,\n      email: sanitized.email,\n      phoneNumber: sanitized.phoneNumber ? toJsonString(PhoneNumberSchema, sanitized.phoneNumber) : undefined,\n      updatedAt: sanitized.updatedAt\n    } satisfies StoredCheckoutProfile));\n  }\n\n  clear(): void {\n    getStorage()?.removeItem(this.key);\n  }\n}\n\nexport function createEmptyDraftOrder(): DraftOrder {\n  return create(DraftOrderSchema, {\n    OrderLines: [],\n    ExtraLines: [],\n    Errors: [],\n    PaymentOptions: [],\n    Discounts: [],\n    Vouchers: [],\n    Messages: [],\n    Related: []\n  });\n}\n\nexport function sanitizeCheckoutProfile(profile: Partial<CheckoutProfile> | undefined): CheckoutProfile {\n  return {\n    address: profile?.address ? create(AddressSchema, profile.address as Address) : undefined,\n    email: typeof profile?.email === \"string\" && profile.email.length > 0 ? profile.email : undefined,\n    phoneNumber: profile?.phoneNumber ? create(PhoneNumberSchema, profile.phoneNumber as PhoneNumber) : undefined,\n    updatedAt: typeof profile?.updatedAt === \"string\" && profile.updatedAt.length > 0\n      ? profile.updatedAt\n      : new Date().toISOString()\n  };\n}\n\ninterface StoredCheckoutProfile {\n  address?: string;\n  email?: string;\n  phoneNumber?: string;\n  updatedAt: string;\n}\n\nfunction getStorage(): Storage | undefined {\n  try {\n    return globalThis.localStorage;\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/taxonomy.d.ts

@@ -0,0 +1,35 @@
+import { a as NavigationDefinition, b as CategoryUrlMode, R as ResolvedNavigationItem } from './types-CCQDd6Nd.js';
+export { c as CategoryDefinition, d as CategoryNavigationItem, e as NavigationMetadata } from './types-CCQDd6Nd.js';
+import '@orderlyshop/core-client';
+import './query.js';
+
+declare const defaultCategoryPageRoot = "/categories/";
+interface NavigationBuildOptions {
+    pageRoot?: string;
+    urlMode?: CategoryUrlMode;
+    description?: (input: NavigationDescriptionInput) => string;
+}
+type CategoryNavigationOptions = NavigationBuildOptions;
+interface NavigationDescriptionInput {
+    definition: NavigationDefinition;
+    parent?: NavigationDefinition;
+    pathLabels: string[];
+}
+type CategoryDescriptionInput = NavigationDescriptionInput;
+declare function createCategoryNavigation(definitions: NavigationDefinition[], options?: NavigationBuildOptions): ResolvedNavigationItem[];
+interface NavigationValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+declare function validateNavigationDefinitions(definitions: NavigationDefinition[]): NavigationValidationResult;
+declare function navigationConfigurationError(definitions: NavigationDefinition[]): string | undefined;
+declare function assertValidNavigationDefinitions(definitions: NavigationDefinition[]): void;
+declare function flattenCategoryNavigation(items: ResolvedNavigationItem[]): ResolvedNavigationItem[];
+declare function findCategoryById(id: string, items: ResolvedNavigationItem[]): ResolvedNavigationItem | undefined;
+declare function findCategoryBySlug(slug: string, items: ResolvedNavigationItem[]): ResolvedNavigationItem | undefined;
+declare function findCategoryByIdOrSlug(value: string, items: ResolvedNavigationItem[]): ResolvedNavigationItem | undefined;
+declare function categoryPagePath(id: string, options?: NavigationBuildOptions): string;
+declare function resolveCategoryUrlMode(url?: string | URL | Location, options?: Pick<NavigationBuildOptions, "pageRoot">): CategoryUrlMode;
+declare function categoryFromUrl(url: string | URL | Location, items: ResolvedNavigationItem[], options?: NavigationBuildOptions): ResolvedNavigationItem;
+
+export { type CategoryDescriptionInput, type CategoryNavigationOptions, CategoryUrlMode, type NavigationBuildOptions, NavigationDefinition, type NavigationDescriptionInput, type NavigationValidationResult, ResolvedNavigationItem, assertValidNavigationDefinitions, categoryFromUrl, categoryPagePath, createCategoryNavigation, defaultCategoryPageRoot, findCategoryById, findCategoryByIdOrSlug, findCategoryBySlug, flattenCategoryNavigation, navigationConfigurationError, resolveCategoryUrlMode, validateNavigationDefinitions };

package/dist/taxonomy.js

@@ -0,0 +1,247 @@
+// src/taxonomy.ts
+import { clone, create as create2 } from "@bufbuild/protobuf";
+import { SearchQuerySchema as SearchQuerySchema2 } from "@orderlyshop/core-client";
+
+// src/query.ts
+import { create } from "@bufbuild/protobuf";
+import {
+  SearchQuerySchema,
+  TagSchema
+} from "@orderlyshop/core-client";
+function createSearchQuery(input = {}) {
+  return create(SearchQuerySchema, {
+    Query: input.query ?? input.keywords,
+    HiddenQuery: input.hiddenQuery,
+    Tags: (input.tags ?? []).map((tag) => create(TagSchema, { Value: tag })),
+    OrderBy: input.orderBy ?? [],
+    StoreId: input.storeId,
+    Featured: input.featured ?? false
+  });
+}
+function normalizeSearchQuery(input = {}) {
+  if (isCoreSearchQuery(input)) {
+    return create(SearchQuerySchema, input);
+  }
+  return createSearchQuery(input);
+}
+function isCoreSearchQuery(input) {
+  return "Query" in input || "HiddenQuery" in input || "Tags" in input || "OrderBy" in input || "StoreId" in input || "Featured" in input;
+}
+
+// src/taxonomy.ts
+var defaultCategoryPageRoot = "/categories/";
+function createCategoryNavigation(definitions, options = {}) {
+  assertValidNavigationDefinitions(definitions);
+  const pageRoot = options.pageRoot ?? defaultCategoryPageRoot;
+  const urlMode = options.urlMode ?? "path";
+  return definitions.map((definition) => {
+    return createCategoryItem({
+      definition,
+      pageRoot,
+      urlMode,
+      description: options.description,
+      pathLabels: [definition.label],
+      pathSlugs: [definition.slug]
+    });
+  });
+}
+function validateNavigationDefinitions(definitions) {
+  const errors = [];
+  const seenIds = /* @__PURE__ */ new Map();
+  const seenSlugs = /* @__PURE__ */ new Map();
+  if (!Array.isArray(definitions) || definitions.length === 0) {
+    errors.push("navigationDefinitions must contain at least one category.");
+    return { valid: false, errors };
+  }
+  validateNavigationLevel(definitions, {
+    errors,
+    seenIds,
+    seenSlugs,
+    pathLabels: [],
+    pathSlugs: []
+  });
+  return { valid: errors.length === 0, errors };
+}
+function navigationConfigurationError(definitions) {
+  const result = validateNavigationDefinitions(definitions);
+  return result.valid ? void 0 : `Navigation configuration error: ${result.errors.join(" ")}`;
+}
+function assertValidNavigationDefinitions(definitions) {
+  const error = navigationConfigurationError(definitions);
+  if (error) {
+    throw new Error(error);
+  }
+}
+function flattenCategoryNavigation(items) {
+  return items.flatMap((item) => [item, ...flattenCategoryNavigation(item.children ?? [])]);
+}
+function findCategoryById(id, items) {
+  return flattenCategoryNavigation(items).find((item) => item.id === id);
+}
+function findCategoryBySlug(slug, items) {
+  return flattenCategoryNavigation(items).find((item) => item.metadata.slug === slug || item.id === slug);
+}
+function findCategoryByIdOrSlug(value, items) {
+  return findCategoryById(value, items) ?? findCategoryBySlug(value, items);
+}
+function categoryPagePath(id, options = {}) {
+  const pageRoot = options.pageRoot ?? defaultCategoryPageRoot;
+  if (options.urlMode === "hash") {
+    return `${pageRoot}#id=${encodeURIComponent(id)}`;
+  }
+  return `${pageRoot}${id}/`;
+}
+function resolveCategoryUrlMode(url = currentLocationUrl(), options = {}) {
+  const target = urlFromInput(url);
+  const pageRoot = options.pageRoot ?? defaultCategoryPageRoot;
+  if (categoryIdFromHash(target.hash)) {
+    return "hash";
+  }
+  return categoryIdFromPath(target.pathname, pageRoot) ? "path" : "hash";
+}
+function categoryFromUrl(url, items, options = {}) {
+  const target = urlFromInput(url);
+  const pageRoot = options.pageRoot ?? defaultCategoryPageRoot;
+  const requestedId = categoryIdFromHash(target.hash) ?? categoryIdFromPath(target.pathname, pageRoot);
+  return requestedId ? findCategoryByIdOrSlug(requestedId, items) ?? items[0] : items[0];
+}
+function createCategoryItem(input) {
+  const id = input.pathSlugs.join("/");
+  const query = categorySearchQuery(input.definition, input.parent, input.pathLabels);
+  const searchText = categorySearchText(query, input.pathLabels);
+  const metadata = {
+    slug: input.pathSlugs[input.pathSlugs.length - 1],
+    parentId: input.parentId,
+    pathSegments: input.pathSlugs,
+    query: clone(SearchQuerySchema2, query),
+    searchText,
+    description: input.definition.description ?? input.description?.({
+      definition: input.definition,
+      parent: input.parent,
+      pathLabels: input.pathLabels
+    }) ?? `Selected products in ${input.pathLabels.join(" ").toLowerCase()}.`,
+    heroImage: input.definition.heroImage ?? input.parent?.heroImage ?? "",
+    pagePath: input.pageRoot
+  };
+  return {
+    id,
+    label: input.definition.label,
+    href: categoryPagePath(id, { pageRoot: input.pageRoot, urlMode: input.urlMode }),
+    query: clone(SearchQuerySchema2, query),
+    metadata,
+    children: (input.definition.children ?? []).map((child) => createCategoryItem({
+      definition: child,
+      parent: input.definition,
+      pageRoot: input.pageRoot,
+      urlMode: input.urlMode,
+      description: input.description,
+      parentId: id,
+      pathLabels: [...input.pathLabels, child.label],
+      pathSlugs: [...input.pathSlugs, child.slug]
+    }))
+  };
+}
+function validateNavigationLevel(definitions, context) {
+  definitions.forEach((definition, index) => {
+    const label = definition?.label?.trim();
+    const location2 = [...context.pathLabels, label || `item ${index + 1}`].join(" > ");
+    const slug = definition?.slug?.trim();
+    if (!label) {
+      context.errors.push(`Category ${location2} is missing label.`);
+    }
+    if (!slug) {
+      context.errors.push(`Category ${location2} is missing slug.`);
+    } else if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug)) {
+      context.errors.push(`Category ${location2} has invalid slug "${slug}". Use lowercase letters, numbers, and hyphens only.`);
+    }
+    const nextPathSlugs = slug ? [...context.pathSlugs, slug] : context.pathSlugs;
+    const id = nextPathSlugs.join("/");
+    if (id) {
+      const existing = context.seenIds.get(id);
+      if (existing) {
+        context.errors.push(`Category ${location2} duplicates category id "${id}" already used by ${existing}.`);
+      } else {
+        context.seenIds.set(id, location2);
+      }
+    }
+    if (slug) {
+      const existing = context.seenSlugs.get(slug);
+      if (existing) {
+        context.errors.push(`Category ${location2} duplicates slug "${slug}" already used by ${existing}. Slugs must be globally unique.`);
+      } else {
+        context.seenSlugs.set(slug, location2);
+      }
+    }
+    if (definition.children?.length) {
+      validateNavigationLevel(definition.children, {
+        ...context,
+        pathLabels: [...context.pathLabels, label || `item ${index + 1}`],
+        pathSlugs: nextPathSlugs
+      });
+    }
+  });
+}
+function categorySearchQuery(definition, parent, pathLabels) {
+  if (definition.query) {
+    return normalizeSearchQuery(definition.query);
+  }
+  const parentQuery = parent?.query ? normalizeSearchQuery(parent.query) : void 0;
+  const inherited = parentQuery ? clone(SearchQuerySchema2, parentQuery) : create2(SearchQuerySchema2);
+  const parentText = parentQuery ? categorySearchText(parentQuery, pathLabels.slice(0, -1)) : parent?.label;
+  inherited.Query = [definition.label, parentText].filter(Boolean).join(" ");
+  return inherited;
+}
+function categorySearchText(query, pathLabels) {
+  return query.Query || query.HiddenQuery || query.Tags.map((tag) => tag.Value).filter(Boolean).join(" ") || pathLabels.join(" ");
+}
+function categoryIdFromPath(pathname, pageRoot) {
+  const path = pathname.replace(/\/index\.html$/, "/");
+  if (!path.startsWith(pageRoot) || path === pageRoot) {
+    return void 0;
+  }
+  const normalized = path.slice(pageRoot.length).replace(/^\/+|\/+$/g, "");
+  return normalized ? normalized.split("/").map(decodeURIComponent).join("/") : void 0;
+}
+function categoryIdFromHash(hash) {
+  const value = hash.startsWith("#") ? hash.slice(1) : hash;
+  if (!value) {
+    return void 0;
+  }
+  const params = new URLSearchParams(value.startsWith("?") ? value.slice(1) : value);
+  const id = params.get("id");
+  if (id) {
+    return id.trim() || void 0;
+  }
+  if (value.includes("=")) {
+    return void 0;
+  }
+  try {
+    return decodeURIComponent(value).trim() || void 0;
+  } catch {
+    return value.trim() || void 0;
+  }
+}
+function urlFromInput(url) {
+  if (typeof url === "string") {
+    return new URL(url, currentLocationUrl());
+  }
+  return new URL(url.href);
+}
+function currentLocationUrl() {
+  return typeof location === "undefined" ? new URL(defaultCategoryPageRoot, "https://example.test") : new URL(location.href);
+}
+export {
+  assertValidNavigationDefinitions,
+  categoryFromUrl,
+  categoryPagePath,
+  createCategoryNavigation,
+  defaultCategoryPageRoot,
+  findCategoryById,
+  findCategoryByIdOrSlug,
+  findCategoryBySlug,
+  flattenCategoryNavigation,
+  navigationConfigurationError,
+  resolveCategoryUrlMode,
+  validateNavigationDefinitions
+};
+//# sourceMappingURL=taxonomy.js.map

package/dist/taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/taxonomy.ts","../src/query.ts"],"sourcesContent":["import { clone, create } from \"@bufbuild/protobuf\";\nimport { SearchQuerySchema, type SearchQuery } from \"@orderlyshop/core-client\";\nimport { normalizeSearchQuery } from \"./query.js\";\nimport type {\n  CategoryUrlMode,\n  NavigationDefinition,\n  NavigationMetadata,\n  ResolvedNavigationItem\n} from \"./types.js\";\nexport type {\n  CategoryDefinition,\n  CategoryNavigationItem,\n  CategoryUrlMode,\n  NavigationDefinition,\n  NavigationMetadata,\n  ResolvedNavigationItem\n} from \"./types.js\";\n\nexport const defaultCategoryPageRoot = \"/categories/\";\n\nexport interface NavigationBuildOptions {\n  pageRoot?: string;\n  urlMode?: CategoryUrlMode;\n  description?: (input: NavigationDescriptionInput) => string;\n}\n\nexport type CategoryNavigationOptions = NavigationBuildOptions;\n\nexport interface NavigationDescriptionInput {\n  definition: NavigationDefinition;\n  parent?: NavigationDefinition;\n  pathLabels: string[];\n}\n\nexport type CategoryDescriptionInput = NavigationDescriptionInput;\n\nexport function createCategoryNavigation(\n  definitions: NavigationDefinition[],\n  options: NavigationBuildOptions = {}\n): ResolvedNavigationItem[] {\n  assertValidNavigationDefinitions(definitions);\n  const pageRoot = options.pageRoot ?? defaultCategoryPageRoot;\n  const urlMode = options.urlMode ?? \"path\";\n  return definitions.map((definition) => {\n    return createCategoryItem({\n      definition,\n      pageRoot,\n      urlMode,\n      description: options.description,\n      pathLabels: [definition.label],\n      pathSlugs: [definition.slug]\n    });\n  });\n}\n\nexport interface NavigationValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\nexport function validateNavigationDefinitions(definitions: NavigationDefinition[]): NavigationValidationResult {\n  const errors: string[] = [];\n  const seenIds = new Map<string, string>();\n  const seenSlugs = new Map<string, string>();\n  if (!Array.isArray(definitions) || definitions.length === 0) {\n    errors.push(\"navigationDefinitions must contain at least one category.\");\n    return { valid: false, errors };\n  }\n  validateNavigationLevel(definitions, {\n    errors,\n    seenIds,\n    seenSlugs,\n    pathLabels: [],\n    pathSlugs: []\n  });\n  return { valid: errors.length === 0, errors };\n}\n\nexport function navigationConfigurationError(definitions: NavigationDefinition[]): string | undefined {\n  const result = validateNavigationDefinitions(definitions);\n  return result.valid ? undefined : `Navigation configuration error: ${result.errors.join(\" \")}`;\n}\n\nexport function assertValidNavigationDefinitions(definitions: NavigationDefinition[]): void {\n  const error = navigationConfigurationError(definitions);\n  if (error) {\n    throw new Error(error);\n  }\n}\n\nexport function flattenCategoryNavigation(items: ResolvedNavigationItem[]): ResolvedNavigationItem[] {\n  return items.flatMap((item) => [item, ...flattenCategoryNavigation(item.children ?? [])]);\n}\n\nexport function findCategoryById(\n  id: string,\n  items: ResolvedNavigationItem[]\n): ResolvedNavigationItem | undefined {\n  return flattenCategoryNavigation(items).find((item) => item.id === id);\n}\n\nexport function findCategoryBySlug(\n  slug: string,\n  items: ResolvedNavigationItem[]\n): ResolvedNavigationItem | undefined {\n  return flattenCategoryNavigation(items).find((item) => item.metadata.slug === slug || item.id === slug);\n}\n\nexport function findCategoryByIdOrSlug(\n  value: string,\n  items: ResolvedNavigationItem[]\n): ResolvedNavigationItem | undefined {\n  return findCategoryById(value, items) ?? findCategoryBySlug(value, items);\n}\n\nexport function categoryPagePath(\n  id: string,\n  options: NavigationBuildOptions = {}\n): string {\n  const pageRoot = options.pageRoot ?? defaultCategoryPageRoot;\n  if (options.urlMode === \"hash\") {\n    return `${pageRoot}#id=${encodeURIComponent(id)}`;\n  }\n  return `${pageRoot}${id}/`;\n}\n\nexport function resolveCategoryUrlMode(\n  url: string | URL | Location = currentLocationUrl(),\n  options: Pick<NavigationBuildOptions, \"pageRoot\"> = {}\n): CategoryUrlMode {\n  const target = urlFromInput(url);\n  const pageRoot = options.pageRoot ?? defaultCategoryPageRoot;\n  if (categoryIdFromHash(target.hash)) {\n    return \"hash\";\n  }\n  return categoryIdFromPath(target.pathname, pageRoot) ? \"path\" : \"hash\";\n}\n\nexport function categoryFromUrl(\n  url: string | URL | Location,\n  items: ResolvedNavigationItem[],\n  options: NavigationBuildOptions = {}\n): ResolvedNavigationItem {\n  const target = urlFromInput(url);\n  const pageRoot = options.pageRoot ?? defaultCategoryPageRoot;\n  const requestedId = categoryIdFromHash(target.hash) ?? categoryIdFromPath(target.pathname, pageRoot);\n  return requestedId ? findCategoryByIdOrSlug(requestedId, items) ?? items[0] : items[0];\n}\n\nfunction createCategoryItem(input: {\n  definition: NavigationDefinition;\n  parent?: NavigationDefinition;\n  pageRoot: string;\n  urlMode: CategoryUrlMode;\n  description?: NavigationBuildOptions[\"description\"];\n  pathLabels: string[];\n  pathSlugs: string[];\n  parentId?: string;\n}): ResolvedNavigationItem {\n  const id = input.pathSlugs.join(\"/\");\n  const query = categorySearchQuery(input.definition, input.parent, input.pathLabels);\n  const searchText = categorySearchText(query, input.pathLabels);\n  const metadata: NavigationMetadata = {\n    slug: input.pathSlugs[input.pathSlugs.length - 1],\n    parentId: input.parentId,\n    pathSegments: input.pathSlugs,\n    query: clone(SearchQuerySchema, query),\n    searchText,\n    description: input.definition.description\n      ?? input.description?.({\n        definition: input.definition,\n        parent: input.parent,\n        pathLabels: input.pathLabels\n      })\n      ?? `Selected products in ${input.pathLabels.join(\" \").toLowerCase()}.`,\n    heroImage: input.definition.heroImage ?? input.parent?.heroImage ?? \"\",\n    pagePath: input.pageRoot\n  };\n  return {\n    id,\n    label: input.definition.label,\n    href: categoryPagePath(id, { pageRoot: input.pageRoot, urlMode: input.urlMode }),\n    query: clone(SearchQuerySchema, query),\n    metadata,\n    children: (input.definition.children ?? []).map((child) => createCategoryItem({\n      definition: child,\n      parent: input.definition,\n      pageRoot: input.pageRoot,\n      urlMode: input.urlMode,\n      description: input.description,\n      parentId: id,\n      pathLabels: [...input.pathLabels, child.label],\n      pathSlugs: [...input.pathSlugs, child.slug]\n    }))\n  };\n}\n\nfunction validateNavigationLevel(\n  definitions: NavigationDefinition[],\n  context: {\n    errors: string[];\n    seenIds: Map<string, string>;\n    seenSlugs: Map<string, string>;\n    pathLabels: string[];\n    pathSlugs: string[];\n  }\n): void {\n  definitions.forEach((definition, index) => {\n    const label = definition?.label?.trim();\n    const location = [...context.pathLabels, label || `item ${index + 1}`].join(\" > \");\n    const slug = definition?.slug?.trim();\n    if (!label) {\n      context.errors.push(`Category ${location} is missing label.`);\n    }\n    if (!slug) {\n      context.errors.push(`Category ${location} is missing slug.`);\n    } else if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug)) {\n      context.errors.push(`Category ${location} has invalid slug \"${slug}\". Use lowercase letters, numbers, and hyphens only.`);\n    }\n    const nextPathSlugs = slug ? [...context.pathSlugs, slug] : context.pathSlugs;\n    const id = nextPathSlugs.join(\"/\");\n    if (id) {\n      const existing = context.seenIds.get(id);\n      if (existing) {\n        context.errors.push(`Category ${location} duplicates category id \"${id}\" already used by ${existing}.`);\n      } else {\n        context.seenIds.set(id, location);\n      }\n    }\n    if (slug) {\n      const existing = context.seenSlugs.get(slug);\n      if (existing) {\n        context.errors.push(`Category ${location} duplicates slug \"${slug}\" already used by ${existing}. Slugs must be globally unique.`);\n      } else {\n        context.seenSlugs.set(slug, location);\n      }\n    }\n    if (definition.children?.length) {\n      validateNavigationLevel(definition.children, {\n        ...context,\n        pathLabels: [...context.pathLabels, label || `item ${index + 1}`],\n        pathSlugs: nextPathSlugs\n      });\n    }\n  });\n}\n\nfunction categorySearchQuery(\n  definition: NavigationDefinition,\n  parent: NavigationDefinition | undefined,\n  pathLabels: string[]\n): SearchQuery {\n  if (definition.query) {\n    return normalizeSearchQuery(definition.query);\n  }\n  const parentQuery = parent?.query ? normalizeSearchQuery(parent.query) : undefined;\n  const inherited = parentQuery ? clone(SearchQuerySchema, parentQuery) : create(SearchQuerySchema);\n  const parentText = parentQuery ? categorySearchText(parentQuery, pathLabels.slice(0, -1)) : parent?.label;\n  inherited.Query = [definition.label, parentText].filter(Boolean).join(\" \");\n  return inherited;\n}\n\nfunction categorySearchText(query: SearchQuery, pathLabels: string[]): string {\n  return query.Query\n    || query.HiddenQuery\n    || query.Tags.map((tag) => tag.Value).filter(Boolean).join(\" \")\n    || pathLabels.join(\" \");\n}\n\nfunction categoryIdFromPath(pathname: string, pageRoot: string): string | undefined {\n  const path = pathname.replace(/\\/index\\.html$/, \"/\");\n  if (!path.startsWith(pageRoot) || path === pageRoot) {\n    return undefined;\n  }\n  const normalized = path.slice(pageRoot.length).replace(/^\\/+|\\/+$/g, \"\");\n  return normalized ? normalized.split(\"/\").map(decodeURIComponent).join(\"/\") : undefined;\n}\n\nfunction categoryIdFromHash(hash: string): string | undefined {\n  const value = hash.startsWith(\"#\") ? hash.slice(1) : hash;\n  if (!value) {\n    return undefined;\n  }\n  const params = new URLSearchParams(value.startsWith(\"?\") ? value.slice(1) : value);\n  const id = params.get(\"id\");\n  if (id) {\n    return id.trim() || undefined;\n  }\n  if (value.includes(\"=\")) {\n    return undefined;\n  }\n  try {\n    return decodeURIComponent(value).trim() || undefined;\n  } catch {\n    return value.trim() || undefined;\n  }\n}\n\nfunction urlFromInput(url: string | URL | Location): URL {\n  if (typeof url === \"string\") {\n    return new URL(url, currentLocationUrl());\n  }\n  return new URL(url.href);\n}\n\nfunction currentLocationUrl(): URL {\n  return typeof location === \"undefined\"\n    ? new URL(defaultCategoryPageRoot, \"https://example.test\")\n    : new URL(location.href);\n}\n","import { create } from \"@bufbuild/protobuf\";\nimport {\n  SearchQuerySchema,\n  TagSchema,\n  type SearchQuery\n} from \"@orderlyshop/core-client\";\n\nexport const declarativeQueryAttributes = [\n  \"keywords\",\n  \"tags\",\n  \"hidden-query\",\n  \"order-by\",\n  \"store-id\",\n  \"featured\"\n];\n\nexport interface SearchQueryInput {\n  query?: string;\n  keywords?: string;\n  hiddenQuery?: string;\n  tags?: string[];\n  orderBy?: string[];\n  storeId?: string;\n  featured?: boolean;\n}\n\nexport type SearchQueryConfig = SearchQuery | SearchQueryInput;\n\n/**\n * Creates a Core SearchQuery from plain JavaScript values.\n *\n * This is mainly useful for vanilla browser setups that load the standalone\n * bundle and do not want to import protobuf helpers directly.\n */\nexport function createSearchQuery(input: SearchQueryInput = {}): SearchQuery {\n  return create(SearchQuerySchema, {\n    Query: input.query ?? input.keywords,\n    HiddenQuery: input.hiddenQuery,\n    Tags: (input.tags ?? []).map((tag) => create(TagSchema, { Value: tag })),\n    OrderBy: input.orderBy ?? [],\n    StoreId: input.storeId,\n    Featured: input.featured ?? false\n  });\n}\n\nexport function normalizeSearchQuery(input: SearchQueryConfig = {}): SearchQuery {\n  if (isCoreSearchQuery(input)) {\n    return create(SearchQuerySchema, input);\n  }\n  return createSearchQuery(input);\n}\n\n/**\n * Builds a SearchQuery from simple HTML configuration.\n *\n * Supported on product grids, product rails, and collection pages. Typed\n * JavaScript `query` properties take precedence in the components; this helper\n * only covers the common declarative fields that are safe to express as text.\n */\nexport function declarativeSearchQuery(host: Element): SearchQuery | undefined {\n  const queryElement = directQueryElement(host);\n  const keywords = readQueryValue(host, queryElement, \"keywords\");\n  const hiddenQuery = readQueryValue(host, queryElement, \"hidden-query\");\n  const storeId = readQueryValue(host, queryElement, \"store-id\");\n  const featured = readQueryBoolean(host, queryElement, \"featured\");\n  const tags = readQueryList(host, queryElement, \"tags\");\n  const orderBy = readQueryList(host, queryElement, \"order-by\");\n\n  if (!keywords && !hiddenQuery && !storeId && featured === undefined && tags.length === 0 && orderBy.length === 0) {\n    return undefined;\n  }\n\n  return create(SearchQuerySchema, {\n    Query: keywords || undefined,\n    HiddenQuery: hiddenQuery || undefined,\n    Tags: tags.map((tag) => create(TagSchema, { Value: tag })),\n    OrderBy: orderBy,\n    StoreId: storeId || undefined,\n    Featured: featured ?? false\n  });\n}\n\nfunction directQueryElement(host: Element): Element | undefined {\n  const queryElement = [...host.children].find((child) => child.localName === \"query\");\n  if (queryElement instanceof HTMLElement) {\n    queryElement.hidden = true;\n  }\n  return queryElement;\n}\n\nfunction isCoreSearchQuery(input: SearchQueryConfig): input is SearchQuery {\n  return \"Query\" in input\n    || \"HiddenQuery\" in input\n    || \"Tags\" in input\n    || \"OrderBy\" in input\n    || \"StoreId\" in input\n    || \"Featured\" in input;\n}\n\nfunction readQueryValue(host: Element, queryElement: Element | undefined, name: string): string {\n  return firstValue(\n    host.getAttribute(name),\n    queryElement?.getAttribute(name),\n    childText(queryElement, name)\n  );\n}\n\nfunction readQueryList(host: Element, queryElement: Element | undefined, name: string): string[] {\n  return uniqueValues([\n    ...splitList(host.getAttribute(name)),\n    ...splitList(queryElement?.getAttribute(name)),\n    ...splitList(childText(queryElement, name))\n  ]);\n}\n\nfunction readQueryBoolean(host: Element, queryElement: Element | undefined, name: string): boolean | undefined {\n  if (host.hasAttribute(name) && !host.getAttribute(name)) {\n    return true;\n  }\n  if (queryElement?.hasAttribute(name) && !queryElement.getAttribute(name)) {\n    return true;\n  }\n  return parseBoolean(readQueryValue(host, queryElement, name));\n}\n\nfunction childText(queryElement: Element | undefined, name: string): string | undefined {\n  const child = [...queryElement?.children ?? []].find((element) => element.localName === name);\n  return child?.textContent?.trim();\n}\n\nfunction firstValue(...values: Array<string | null | undefined>): string {\n  return values.map((value) => value?.trim()).find(Boolean) ?? \"\";\n}\n\nfunction splitList(value: string | null | undefined): string[] {\n  return (value ?? \"\")\n    .split(/[\\n,]/g)\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\nfunction uniqueValues(values: string[]): string[] {\n  return [...new Set(values)];\n}\n\nfunction parseBoolean(value: string): boolean | undefined {\n  if (!value) {\n    return undefined;\n  }\n  if ([\"true\", \"1\", \"yes\", \"\"].includes(value.toLowerCase())) {\n    return true;\n  }\n  if ([\"false\", \"0\", \"no\"].includes(value.toLowerCase())) {\n    return false;\n  }\n  return undefined;\n}\n"],"mappings":"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","names":["create","SearchQuerySchema","SearchQuerySchema","location","create"]}

package/dist/types-CCQDd6Nd.d.ts

@@ -0,0 +1,95 @@
+import { DraftOrder, SearchQuery, WebsitePage, UIMenu, Address, PhoneNumber, TransportMethod, SearchObject, Login, OrderlyClient } from '@orderlyshop/core-client';
+import { SearchQueryConfig } from './query.js';
+
+type StorefrontClient = OrderlyClient;
+interface SortOption {
+    label: string;
+    orderBy: string[];
+}
+interface NavigationDefinition {
+    label: string;
+    slug: string;
+    heroImage?: string;
+    query?: SearchQueryConfig;
+    description?: string;
+    children?: NavigationDefinition[];
+}
+/**
+ * Derived values created from NavigationDefinition for rendered storefront pages.
+ */
+interface NavigationMetadata {
+    slug: string;
+    parentId?: string;
+    pathSegments: string[];
+    query: SearchQuery;
+    searchText: string;
+    description: string;
+    heroImage: string;
+    pagePath: string;
+}
+/**
+ * Runtime navigation item consumed by default shop/page components.
+ */
+interface ResolvedNavigationItem extends NavigationItem {
+    metadata: NavigationMetadata;
+    children?: ResolvedNavigationItem[];
+}
+/**
+ * Backward-compatible aliases for the earlier category naming.
+ */
+type CategoryDefinition = NavigationDefinition;
+type CategoryMetadata = NavigationMetadata;
+type CategoryNavigationItem = ResolvedNavigationItem;
+type CategoryUrlMode = "path" | "hash";
+type ProductGridPagingMode = "manual" | "button" | "infinite" | "dynamic";
+interface ProductGridState {
+    loading: boolean;
+    error?: unknown;
+    products: SearchObject[];
+    count: number;
+    estimatedTotalCount?: number;
+    hasMore: boolean;
+}
+type BasketChangeReason = "load" | "set-draft" | "add-product" | "set-quantity" | "remove-line" | "clear" | "verify";
+type BasketChangeEvent = CustomEvent<DraftOrder> & {
+    reason?: BasketChangeReason;
+};
+interface ProductEventDetail {
+    product: SearchObject;
+    controllerUpdated?: boolean;
+}
+interface OrderCreatedDetail {
+    order: unknown;
+    draft: DraftOrder;
+}
+interface CheckoutProfile {
+    address?: Address;
+    email?: string;
+    phoneNumber?: PhoneNumber;
+    updatedAt: string;
+}
+interface NavigationItem {
+    id: string;
+    label: string;
+    href?: string;
+    target?: "_self" | "_blank";
+    query?: SearchQuery;
+    page?: WebsitePage;
+    menu?: UIMenu;
+    children?: NavigationItem[];
+    disabled?: boolean;
+    metadata?: unknown;
+}
+interface NavigationSelectionDetail {
+    item: NavigationItem;
+}
+interface CheckoutReadyDetail {
+    draft: DraftOrder;
+    profile: CheckoutProfile;
+    transportMethod?: TransportMethod;
+}
+interface SessionDetail {
+    login?: Login;
+}
+
+export type { BasketChangeReason as B, CheckoutProfile as C, NavigationItem as N, OrderCreatedDetail as O, ProductGridPagingMode as P, ResolvedNavigationItem as R, SortOption as S, NavigationDefinition as a, CategoryUrlMode as b, CategoryDefinition as c, CategoryNavigationItem as d, NavigationMetadata as e, ProductGridState as f, BasketChangeEvent as g, CategoryMetadata as h, CheckoutReadyDetail as i, NavigationSelectionDetail as j, ProductEventDetail as k, SessionDetail as l, StorefrontClient as m };