@salesforce/b2c-tooling-sdk 1.16.0 → 1.18.0

package/dist/esm/docs/search.js

@@ -5,124 +5,476 @@
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import Fuse from 'fuse.js';
-import { SCRIPT_API_DATA_DIR } from './types.js';
-// Singleton cache for loaded index and Fuse instance
+import MiniSearch from 'minisearch';
+import { getLogger } from '../logging/logger.js';
+import { GUIDES_DATA_DIR, JOB_STEPS_DATA_DIR, SCRIPT_API_DATA_DIR, TOOLING_DATA_DIR, } from './types.js';
+/**
+ * The bundled corpora, loaded (and combined) in priority order. Earlier corpora
+ * win on id collisions. Each directory holds an `index.json` ({@link SearchIndex})
+ * and, for corpora whose content ships in the package, the referenced files.
+ */
+const CORPUS_DIRS = [SCRIPT_API_DATA_DIR, JOB_STEPS_DATA_DIR, GUIDES_DATA_DIR, TOOLING_DATA_DIR];
+/** Multiplier applied to a detected workspace's relevant categories. */
+const WORKSPACE_BOOST = 1.4;
+/**
+ * Timeout (ms) for fetching an online-only guide's content. Without a bound a
+ * stalled connection hangs the caller indefinitely (observed hanging Windows CI
+ * for 6h); on timeout we fall back to the indexed offline summary instead.
+ */
+const ONLINE_FETCH_TIMEOUT_MS = 10_000;
+/**
+ * Multiplier applied to a COMPETING storefront framework's guides when a
+ * workspace is known — i.e. the storefront-framework guide categories that are
+ * NOT relevant to the detected workspace (e.g. `sfnext`/`sfra` for a PWA Kit
+ * project). These are mutually exclusive storefront implementations, so their
+ * how-to guides are usually the wrong answer for a different storefront. Kept
+ * as a de-boost (not a hard filter) so the docs still surface, just demoted —
+ * a strong exact-title match (e.g. an "SEO and Metadata" sfnext guide) should
+ * not outrank the current storefront's own guide for the same query.
+ */
+const COMPETING_STOREFRONT_PENALTY = 0.3;
+/**
+ * The storefront-FRAMEWORK guide categories: one per mutually-exclusive
+ * storefront implementation. Only these are de-boosted when they belong to a
+ * different storefront than the detected workspace. Reference/platform corpora
+ * (`script-api`, `job-step`, `commerce-api`, `b2c-commerce`, `tooling`) are
+ * never treated as "competing" — they apply across storefronts.
+ */
+const STOREFRONT_FRAMEWORK_CATEGORIES = ['sfra', 'pwa-kit-managed-runtime', 'sfnext'];
+/**
+ * Canonical per-category metadata, keyed by {@link DocCategory}. Insertion order
+ * defines the display order in {@link DOC_CATEGORIES}. `alwaysRelevant` marks the
+ * categories that are boosted whenever ANY workspace is detected, regardless of
+ * which framework it is (general platform docs + this tooling's own docs).
+ *
+ * Typed `Record<DocCategory, …>`, so adding a new `DocCategory` to the union in
+ * `types.ts` is a compile error until it is listed here (keeps the category list
+ * and its metadata from drifting).
+ */
+const CATEGORY_TAXONOMY = {
+    'script-api': {},
+    'job-step': {},
+    'commerce-api': {},
+    'pwa-kit-managed-runtime': {},
+    sfnext: {},
+    sfra: {},
+    'b2c-commerce': { alwaysRelevant: true },
+    tooling: { alwaysRelevant: true },
+};
+/**
+ * The canonical list of documentation categories, in a stable display order.
+ * Exported so the CLI and MCP surfaces validate against a single source of truth
+ * instead of maintaining their own copies. Derived from {@link CATEGORY_TAXONOMY}.
+ */
+export const DOC_CATEGORIES = Object.keys(CATEGORY_TAXONOMY);
+/** Categories relevant to every detected workspace. Derived from {@link CATEGORY_TAXONOMY}. */
+const ALWAYS_RELEVANT = DOC_CATEGORIES.filter((c) => CATEGORY_TAXONOMY[c].alwaysRelevant);
+/**
+ * Maps each workspace marker to the doc categories it makes relevant. The final
+ * relevant set for a workspace is {@link ALWAYS_RELEVANT} plus the union of the
+ * markers' categories (merged, never summed — a category shared by two markers
+ * is still boosted once).
+ *
+ * `sfra` is a refinement of `cartridges`: an SFRA project detects as both, so it
+ * gets the cartridge categories (Script API, job steps) AND the `sfra` guides. A
+ * non-SFRA cartridge project (custom APIs, or a PWA Kit / Storefront Next repo
+ * that also ships cartridges) gets the cartridge categories but NOT `sfra`.
+ *
+ * Typed `Record<ProjectType, …>`, so adding a new workspace marker is a compile
+ * error until its categories are declared here.
+ */
+const WORKSPACE_CATEGORIES = {
+    cartridges: ['script-api', 'job-step'],
+    sfra: ['sfra'],
+    'pwa-kit-v3': ['pwa-kit-managed-runtime', 'commerce-api'],
+    'storefront-next': ['sfnext', 'commerce-api'],
+};
+/**
+ * Parses and validates a user-supplied set of documentation categories into a
+ * "topics" allowlist that bounds the entire available corpus (see
+ * {@link SearchDocsOptions.enabledCategories}). Accepts a comma-separated string
+ * or an array; names are trimmed and lower-cased.
+ *
+ * Unknown names are dropped (and reported via `onInvalid`, if provided). Returns
+ * `undefined` when the input is empty or contains no valid categories, which
+ * means "no restriction" — matching the tolerant behavior of the MCP `--toolsets`
+ * flag, so a typo yields a warning and the full corpus rather than a dead tool.
+ *
+ * @param input - Comma-separated category names, or an array of names
+ * @param onInvalid - Optional callback invoked with any unrecognized names
+ * @returns The validated, de-duplicated categories, or `undefined` for no restriction
+ */
+export function resolveEnabledCategories(input, onInvalid) {
+    if (input == undefined)
+        return undefined;
+    const raw = Array.isArray(input) ? input : String(input).split(',');
+    const names = raw.map((s) => s.trim().toLowerCase()).filter((s) => s.length > 0);
+    if (names.length === 0)
+        return undefined;
+    const known = new Set(DOC_CATEGORIES);
+    const valid = [];
+    const invalid = [];
+    for (const name of names) {
+        if (known.has(name))
+            valid.push(name);
+        else
+            invalid.push(name);
+    }
+    if (invalid.length > 0)
+        onInvalid?.(invalid);
+    return valid.length > 0 ? [...new Set(valid)] : undefined;
+}
+/** Normalizes a workspace option to an array of project-type markers. */
+function toWorkspaceList(workspace) {
+    if (!workspace)
+        return undefined;
+    const list = Array.isArray(workspace) ? workspace : [workspace];
+    return list.length ? list : undefined;
+}
+/**
+ * Computes the set of doc categories relevant to the given workspace marker(s):
+ * the always-relevant categories plus the union of each marker's categories
+ * (merged, not summed).
+ */
+export function categoriesForWorkspace(workspace) {
+    const list = toWorkspaceList(workspace) ?? [];
+    const set = new Set(ALWAYS_RELEVANT);
+    for (const marker of list) {
+        for (const cat of WORKSPACE_CATEGORIES[marker] ?? [])
+            set.add(cat);
+    }
+    return [...set];
+}
+// Singleton caches for the combined index and the MiniSearch instance.
 let cachedIndex = null;
-let cachedFuse = null;
+let cachedMiniSearch = null;
+// Maps each entry id to the absolute data directory that holds its bundled file.
+// Lets a single combined index span multiple bundled corpora without changing
+// the public DocEntry shape. Online-only entries (guides) are not recorded here.
+const entryDataDir = new Map();
+// Maps each entry id to its full DocEntry, for O(1) lookup on read.
+const entryById = new Map();
+/**
+ * Projects a stored entry to the shape returned to callers. Drops `headings`,
+ * which exists only to feed the search index (a long ` • `-joined string with
+ * no triage value) and would otherwise bloat search/list payloads for agents.
+ */
+function publicEntry(entry) {
+    const { headings: _headings, ...rest } = entry;
+    return rest;
+}
+/**
+ * Loads one bundled index.json from the given directory, returning its entries
+ * and recording the directory for each id that ships its content on disk.
+ * Missing indexes are ignored so a not-yet-generated corpus is simply absent.
+ */
+function loadCorpus(dataDir) {
+    const indexPath = path.join(dataDir, 'index.json');
+    if (!fs.existsSync(indexPath)) {
+        return [];
+    }
+    const parsed = JSON.parse(fs.readFileSync(indexPath, 'utf-8'));
+    for (const entry of parsed.entries) {
+        if (entryById.has(entry.id))
+            continue; // first corpus wins on id collision
+        entryById.set(entry.id, entry);
+        // Only record a data dir for entries whose content is bundled on disk.
+        if (entry.filePath) {
+            entryDataDir.set(entry.id, dataDir);
+        }
+    }
+    return parsed.entries;
+}
 /**
- * Loads the pre-built search index from the bundled data directory.
+ * Loads the combined search index from every bundled corpus directory.
  *
- * @returns The search index with all documentation entries
- * @throws Error if the index file cannot be read
+ * Combines the Script API reference, standard job steps, Developer Center
+ * guides, and this project's own docs so all are searchable through the same
+ * functions. Corpora that have not been generated are skipped.
+ *
+ * @returns The combined search index with all documentation entries
  */
 export function loadSearchIndex() {
     if (cachedIndex)
         return cachedIndex;
-    const indexPath = path.join(SCRIPT_API_DATA_DIR, 'index.json');
-    const indexContent = fs.readFileSync(indexPath, 'utf-8');
-    cachedIndex = JSON.parse(indexContent);
+    entryDataDir.clear();
+    entryById.clear();
+    const entries = [];
+    const perCorpus = {};
+    for (const dir of CORPUS_DIRS) {
+        const loaded = loadCorpus(dir);
+        perCorpus[path.basename(dir)] = loaded.length;
+        entries.push(...loaded);
+    }
+    getLogger().debug({ total: entries.length, perCorpus }, 'Loaded combined documentation search index');
+    cachedIndex = {
+        version: '2.0.0',
+        generatedAt: new Date(0).toISOString(),
+        entries,
+    };
     return cachedIndex;
 }
 /**
- * Gets or creates the Fuse.js search instance.
+ * Gets or creates the MiniSearch instance over the combined index.
+ *
+ * MiniSearch gives tokenized, BM25-style ranking with field boosting — far
+ * better recall on prose (Developer Center guides) than a title-only fuzzy
+ * match, while still returning class-name lookups (e.g. "ProductMgr") first.
  */
-function getFuseInstance() {
-    if (cachedFuse)
-        return cachedFuse;
+function getMiniSearch() {
+    if (cachedMiniSearch)
+        return cachedMiniSearch;
     const index = loadSearchIndex();
-    cachedFuse = new Fuse(index.entries, {
-        keys: [
-            { name: 'title', weight: 0.5 },
-            { name: 'id', weight: 0.5 },
-        ],
-        threshold: 0.4,
-        includeScore: true,
-        minMatchCharLength: 2,
-        ignoreLocation: true,
+    const ms = new MiniSearch({
+        idField: 'id',
+        fields: ['title', 'id', 'headings', 'keywords', 'summary'],
+        // We look entries up in entryById on read, so nothing extra needs storing.
+        storeFields: ['category'],
+        searchOptions: {
+            boost: { title: 3, id: 2.5, keywords: 2, headings: 2, summary: 1.5 },
+            fuzzy: 0.2,
+            prefix: true,
+            // OR-combine: relevance ranking surfaces the best (near-AND) matches first
+            // while still finding prose docs from natural-language queries whose
+            // stopwords ("how", "the") are not indexed. Verified best recall in eval.
+            // NOTE: the per-document category boost is applied per-search in
+            // searchDocs (it depends on runtime workspace context), not baked here.
+        },
     });
-    return cachedFuse;
+    ms.addAll(index.entries.map((e) => ({
+        id: e.id,
+        title: e.title ?? '',
+        category: e.category ?? '',
+        headings: e.headings ?? '',
+        summary: e.summary ?? '',
+        keywords: Array.isArray(e.keywords) ? e.keywords.join(' ') : '',
+    })));
+    getLogger().debug({ documentCount: index.entries.length }, 'Built MiniSearch index for documentation search');
+    cachedMiniSearch = ms;
+    return ms;
+}
+/** Intersects two category lists; `undefined` on either side means "no constraint on that side". */
+function intersectCategories(a, b) {
+    if (!a)
+        return b ? [...b] : undefined;
+    if (!b)
+        return [...a];
+    const bSet = new Set(b);
+    return a.filter((c) => bSet.has(c));
 }
 /**
- * Searches the documentation index with fuzzy matching.
+ * Searches the combined documentation index.
+ *
+ * Higher scores are better. Results carry the full {@link DocEntry} (including
+ * `category`, `summary`, `keywords`, and `url` when available) so callers can
+ * triage matches without a follow-up read.
+ *
+ * When `workspace` is provided, the categories relevant to those markers (e.g.
+ * `sfra` for an SFRA project, `script-api`/`job-step` for any cartridge project,
+ * `pwa-kit-managed-runtime`/`commerce-api` for PWA Kit, `sfnext`/`commerce-api`
+ * for Storefront Next — plus the always-relevant docs) are boosted. It only ever
+ * reorders results; use `category`/`enabledCategories` to hard-scope.
  *
  * @param query - The search query string
- * @param limit - Maximum number of results to return (default: 20)
- * @returns Array of search results sorted by relevance
+ * @param limitOrOptions - Result limit (number) or {@link SearchDocsOptions}
+ * @returns Array of search results sorted by relevance (best first)
  *
  * @example
  * ```typescript
- * const results = searchDocs('ProductMgr');
- * results.forEach(r => console.log(r.entry.id, r.score));
+ * // Favor the current workspace's docs (nothing hidden)
+ * searchDocs('deploy bundle', {workspace: 'pwa-kit-v3'});
+ * // Hard-scope to one category instead
+ * searchDocs('components', {category: 'sfnext'});
  * ```
  */
-export function searchDocs(query, limit = 20) {
-    const fuse = getFuseInstance();
-    const results = fuse.search(query, { limit });
-    return results.map((r) => ({
-        entry: r.item,
-        score: r.score ?? 0,
-    }));
+export function searchDocs(query, limitOrOptions) {
+    const opts = typeof limitOrOptions === 'number' ? { limit: limitOrOptions } : (limitOrOptions ?? {});
+    const limit = opts.limit ?? 20;
+    const workspaces = toWorkspaceList(opts.workspace);
+    // Only an explicit category is a hard filter now; a workspace never hides docs.
+    const explicit = opts.category ? (Array.isArray(opts.category) ? opts.category : [opts.category]) : undefined;
+    // The launch-time allowlist bounds the whole corpus; the per-query category
+    // narrows within it. Their intersection is the effective hard filter.
+    const filterCategories = intersectCategories(opts.enabledCategories, explicit);
+    // A known workspace boosts its relevant categories, and DE-BOOSTS the guides
+    // of competing storefront frameworks (a different storefront's how-to guides
+    // are usually the wrong answer). Neither hides anything — both only reweight.
+    const boostSet = workspaces ? new Set(categoriesForWorkspace(workspaces)) : undefined;
+    const competingSet = boostSet
+        ? new Set(STOREFRONT_FRAMEWORK_CATEGORIES.filter((c) => !boostSet.has(c)))
+        : undefined;
+    const ms = getMiniSearch();
+    const raw = ms.search(query, {
+        filter: filterCategories ? (r) => filterCategories.includes(r.category) : undefined,
+        boostDocument: (_id, _term, storedFields) => {
+            const category = storedFields?.category;
+            if (!category)
+                return 1;
+            if (boostSet?.has(category))
+                return WORKSPACE_BOOST;
+            if (competingSet?.has(category))
+                return COMPETING_STOREFRONT_PENALTY;
+            return 1;
+        },
+    });
+    const results = [];
+    for (const r of raw) {
+        const entry = entryById.get(r.id);
+        if (!entry)
+            continue;
+        results.push({ entry: publicEntry(entry), score: r.score });
+        if (results.length >= limit)
+            break;
+    }
+    const logger = getLogger();
+    logger.debug({ query, filterCategories, workspaces, limit, matched: raw.length, returned: results.length }, 'docs searchDocs completed');
+    logger.trace({ query, top: results.slice(0, 5).map((r) => ({ id: r.entry.id, score: r.score })) }, 'docs search top hits');
+    return results;
 }
 /**
- * Reads the content of a documentation file by its ID.
- *
- * @param id - The documentation ID (filename without .md extension)
- * @returns The raw markdown content of the document
- * @throws Error if the document is not found
+ * Lists documentation entries, optionally filtered by category.
  *
- * @example
- * ```typescript
- * const content = readDoc('dw.catalog.ProductMgr');
- * console.log(content);
- * ```
+ * @param category - Optional corpus/category (or list) to restrict to
+ * @param enabledCategories - Optional launch-time allowlist that bounds the
+ *   entire corpus (see {@link SearchDocsOptions.enabledCategories}). When set,
+ *   only entries in these categories are eligible; `category` narrows within it.
+ * @returns Array of matching documentation entries
  */
-export function readDoc(id) {
+export function listDocs(category, enabledCategories) {
     const index = loadSearchIndex();
-    const entry = index.entries.find((e) => e.id === id);
+    const explicit = category ? (Array.isArray(category) ? category : [category]) : undefined;
+    const categories = intersectCategories(enabledCategories, explicit);
+    const entries = categories
+        ? index.entries.filter((e) => e.category && categories.includes(e.category))
+        : index.entries;
+    return entries.map(publicEntry);
+}
+/**
+ * Reads the full content of a documentation entry by its exact id.
+ *
+ * Bundled entries are read from disk. Entries whose content is published online
+ * (Developer Center guides) are fetched from their canonical URL; on network
+ * failure a readable fallback assembled from the indexed metadata is returned.
+ *
+ * @param id - The documentation id
+ * @returns The document content (markdown)
+ * @throws Error if the id is unknown
+ */
+export async function readDoc(id) {
+    loadSearchIndex();
+    const entry = entryById.get(id);
     if (!entry) {
         throw new Error(`Documentation not found: ${id}`);
     }
-    const filePath = path.join(SCRIPT_API_DATA_DIR, entry.filePath);
-    return fs.readFileSync(filePath, 'utf-8');
+    return readEntryContent(entry);
+}
+/**
+ * Reads the content of a resolved {@link DocEntry}, choosing bundled-file vs.
+ * online fetch based on whether the entry ships its content on disk.
+ */
+export async function readEntryContent(entry) {
+    const logger = getLogger();
+    const dataDir = entryDataDir.get(entry.id);
+    if (dataDir && entry.filePath) {
+        logger.debug({ id: entry.id, source: 'bundled', filePath: entry.filePath }, 'Reading bundled documentation entry');
+        return fs.readFileSync(path.join(dataDir, entry.filePath), 'utf-8');
+    }
+    // Online-only entries (guides): fetch the raw markdown. Prefer `sourceUrl`
+    // (the `.md`); fall back to `url` for any entry that only carries one.
+    const fetchUrl = entry.sourceUrl ?? entry.url;
+    if (fetchUrl) {
+        logger.debug({ id: entry.id, source: 'online', fetchUrl }, 'Reading online documentation entry');
+        return fetchOnlineContent(entry, fetchUrl);
+    }
+    throw new Error(`No content source for documentation entry: ${entry.id}`);
+}
+/**
+ * Fetches a guide's markdown from `fetchUrl`, falling back to a summary
+ * assembled from indexed metadata if the request fails (offline, 404, etc.).
+ */
+async function fetchOnlineContent(entry, fetchUrl) {
+    const logger = getLogger();
+    try {
+        logger.trace({ fetchUrl }, 'Fetching online documentation content');
+        const res = await fetch(fetchUrl, {
+            headers: { accept: 'text/markdown, text/plain, */*' },
+            signal: AbortSignal.timeout(ONLINE_FETCH_TIMEOUT_MS),
+        });
+        if (!res.ok) {
+            logger.debug({ fetchUrl, status: res.status }, 'Online doc fetch returned non-OK status');
+            return offlineFallback(entry, `HTTP ${res.status}`);
+        }
+        const text = await res.text();
+        logger.trace({ fetchUrl, bytes: text.length }, 'Fetched online documentation content');
+        return text;
+    }
+    catch (err) {
+        logger.debug({ fetchUrl, err }, 'Online doc fetch failed');
+        return offlineFallback(entry, err instanceof Error ? err.message : String(err));
+    }
+}
+/** Assembles a minimal readable document from indexed metadata when fetch fails. */
+function offlineFallback(entry, reason) {
+    const lines = [`# ${entry.title}`, ''];
+    if (entry.summary)
+        lines.push(entry.summary, '');
+    if (entry.headings)
+        lines.push('## Sections', '', entry.headings
+            .split(' • ')
+            .map((h) => `- ${h}`)
+            .join('\n'), '');
+    if (entry.url)
+        lines.push(`Full documentation: ${entry.url}`, '');
+    lines.push(`> Note: live content could not be fetched (${reason}); showing indexed summary only.`);
+    return lines.join('\n');
 }
 /**
  * Reads documentation by fuzzy-matching the query and returning the best match.
  *
  * @param query - The search query string
+ * @param options - Optional search constraints (e.g. category)
  * @returns The best matching entry and its content, or null if no match
  *
  * @example
  * ```typescript
- * const doc = readDocByQuery('ProductMgr');
- * if (doc) {
- *   console.log(`Found: ${doc.entry.title}`);
- *   console.log(doc.content);
- * }
+ * const doc = await readDocByQuery('ProductMgr');
+ * if (doc) console.log(doc.content);
  * ```
  */
-export function readDocByQuery(query) {
-    const results = searchDocs(query, 1);
+export async function readDocByQuery(query, options) {
+    // Prefer an exact id match so precise lookups are deterministic. Honor both
+    // the per-query category constraint and the launch-time allowlist so an exact
+    // id in a non-requested (or disabled) corpus does not win.
+    loadSearchIndex();
+    const exact = entryById.get(query);
+    if (exact) {
+        const perQuery = options?.category
+            ? Array.isArray(options.category)
+                ? options.category
+                : [options.category]
+            : undefined;
+        const categories = intersectCategories(options?.enabledCategories, perQuery);
+        if (!categories || (exact.category && categories.includes(exact.category))) {
+            // Resolve content from the stored entry (keeps headings for offline
+            // fallback), but return the public entry (headings stripped).
+            return { entry: publicEntry(exact), content: await readEntryContent(exact) };
+        }
+    }
+    const results = searchDocs(query, { ...options, limit: 1 });
     if (results.length === 0) {
         return null;
     }
-    const entry = results[0].entry;
-    const content = readDoc(entry.id);
-    return { entry, content };
+    const stored = entryById.get(results[0].entry.id) ?? results[0].entry;
+    return { entry: publicEntry(stored), content: await readEntryContent(stored) };
 }
 /**
- * Lists all available documentation entries.
- *
- * @returns Array of all documentation entries in the index
- *
- * @example
- * ```typescript
- * const docs = listDocs();
- * console.log(`${docs.length} documentation files available`);
- * ```
+ * Resets the in-memory index/search caches. Intended for tests that swap the
+ * bundled data on disk between assertions.
  */
-export function listDocs() {
-    const index = loadSearchIndex();
-    return index.entries;
+export function resetDocsCache() {
+    cachedIndex = null;
+    cachedMiniSearch = null;
+    entryDataDir.clear();
+    entryById.clear();
 }
 //# sourceMappingURL=search.js.map

package/dist/esm/docs/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/docs/search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/docs/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAC,SAAS,EAAC,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GAKjB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,MAAM,WAAW,GAAsB,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;AAEpH,wEAAwE;AACxE,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B;;;;GAIG;AACH,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,+BAA+B,GAA2B,CAAC,MAAM,EAAE,yBAAyB,EAAE,QAAQ,CAAC,CAAC;AAE9G;;;;;;;;;GASG;AACH,MAAM,iBAAiB,GAAoD;IACzE,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,EAAE;IAClB,yBAAyB,EAAE,EAAE;IAC7B,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,EAAE;IACR,cAAc,EAAE,EAAC,cAAc,EAAE,IAAI,EAAC;IACtC,OAAO,EAAE,EAAC,cAAc,EAAE,IAAI,EAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAA2B,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAkB,CAAC;AAEtG,+FAA+F;AAC/F,MAAM,eAAe,GAA2B,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;AAElH;;;;;;;;;;;;;GAaG;AACH,MAAM,oBAAoB,GAAgD;IACxE,UAAU,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC;IACtC,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,YAAY,EAAE,CAAC,yBAAyB,EAAE,cAAc,CAAC;IACzD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAA6C,EAC7C,SAAuC;IAEvC,IAAI,KAAK,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS,cAAc,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,IAAmB,CAAC,CAAC;;YAChD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC;AAED,yEAAyE;AACzE,SAAS,eAAe,CAAC,SAAuC;IAC9D,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAsC;IAC3E,MAAM,IAAI,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAc,eAAe,CAAC,CAAC;IAClD,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;QAC1B,KAAK,MAAM,GAAG,IAAI,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AAClB,CAAC;AAED,uEAAuE;AACvE,IAAI,WAAW,GAAuB,IAAI,CAAC;AAC3C,IAAI,gBAAgB,GAAkC,IAAI,CAAC;AAE3D,iFAAiF;AACjF,8EAA8E;AAC9E,iFAAiF;AACjF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE/C,oEAAoE;AACpE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;AAY9C;;;;GAIG;AACH,SAAS,WAAW,CAAC,KAAe;IAClC,MAAM,EAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAC,GAAG,KAAK,CAAC;IAC7C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAgB,CAAC;IAC9E,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,SAAS,CAAC,oCAAoC;QAC3E,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC/B,uEAAuE;QACvE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,YAAY,CAAC,KAAK,EAAE,CAAC;IACrB,SAAS,CAAC,KAAK,EAAE,CAAC;IAElB,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/B,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,SAAS,EAAE,CAAC,KAAK,CAAC,EAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAC,EAAE,4CAA4C,CAAC,CAAC;IAEpG,WAAW,GAAG;QACZ,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;QACtC,OAAO;KACR,CAAC;IACF,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa;IACpB,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAE9C,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAEhC,MAAM,EAAE,GAAG,IAAI,UAAU,CAAa;QACpC,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC;QAC1D,2EAA2E;QAC3E,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,aAAa,EAAE;YACb,KAAK,EAAE,EAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAC;YAClE,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,IAAI;YACZ,2EAA2E;YAC3E,qEAAqE;YACrE,0EAA0E;YAC1E,iEAAiE;YACjE,wEAAwE;SACzE;KACF,CAAC,CAAC;IAEH,EAAE,CAAC,MAAM,CACP,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;QAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;QAC1B,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;QACxB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;KAChE,CAAC,CAAC,CACJ,CAAC;IAEF,SAAS,EAAE,CAAC,KAAK,CAAC,EAAC,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAC,EAAE,iDAAiD,CAAC,CAAC;IAE5G,gBAAgB,GAAG,EAAE,CAAC;IACtB,OAAO,EAAE,CAAC;AACZ,CAAC;AA+BD,oGAAoG;AACpG,SAAS,mBAAmB,CAC1B,CAAqC,EACrC,CAAqC;IAErC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,cAA2C;IACnF,MAAM,IAAI,GAAsB,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,cAAc,EAAC,CAAC,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;IACtH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAE/B,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEnD,gFAAgF;IAChF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9G,4EAA4E;IAC5E,sEAAsE;IACtE,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAE/E,6EAA6E;IAC7E,6EAA6E;IAC7E,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAc,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnG,MAAM,YAAY,GAAG,QAAQ;QAC3B,CAAC,CAAC,IAAI,GAAG,CAAc,+BAA+B,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAE3B,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QAC3B,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAuB,CAAC,CAAC,CAAC,CAAC,SAAS;QAClG,aAAa,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE;YAC1C,MAAM,QAAQ,GAAG,YAAY,EAAE,QAAmC,CAAC;YACnE,IAAI,CAAC,QAAQ;gBAAE,OAAO,CAAC,CAAC;YACxB,IAAI,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC;gBAAE,OAAO,eAAe,CAAC;YACpD,IAAI,YAAY,EAAE,GAAG,CAAC,QAAQ,CAAC;gBAAE,OAAO,4BAA4B,CAAC;YACrE,OAAO,CAAC,CAAC;QACX,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAY,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,OAAO,CAAC,IAAI,CAAC,EAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAC,CAAC,CAAC;QAC1D,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,KAAK,CACV,EAAC,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAC,EAC3F,2BAA2B,CAC5B,CAAC;IACF,MAAM,CAAC,KAAK,CACV,EAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAC,CAAC,CAAC,EAAC,EAChF,sBAAsB,CACvB,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CACtB,QAAsC,EACtC,iBAA0C;IAE1C,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,MAAM,UAAU,GAAG,mBAAmB,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,UAAU;QACxB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC5E,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IAClB,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAAU;IACtC,eAAe,EAAE,CAAC;IAClB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAe;IACpD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3C,IAAI,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,EAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAC,EAAE,qCAAqC,CAAC,CAAC;QACjH,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IACD,2EAA2E;IAC3E,uEAAuE;IACvE,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,EAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAC,EAAE,oCAAoC,CAAC,CAAC;QAC/F,OAAO,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8CAA8C,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAAC,KAAe,EAAE,QAAgB;IACjE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAC,EAAE,uCAAuC,CAAC,CAAC;QAClE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YAChC,OAAO,EAAE,EAAC,MAAM,EAAE,gCAAgC,EAAC;YACnD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,uBAAuB,CAAC;SACrD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAC,EAAE,yCAAyC,CAAC,CAAC;YACxF,OAAO,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAC,EAAE,sCAAsC,CAAC,CAAC;QACrF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,GAAG,EAAC,EAAE,yBAAyB,CAAC,CAAC;QACzD,OAAO,eAAe,CAAC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,SAAS,eAAe,CAAC,KAAe,EAAE,MAAc;IACtD,MAAM,KAAK,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,QAAQ;QAChB,KAAK,CAAC,IAAI,CACR,aAAa,EACb,EAAE,EACF,KAAK,CAAC,QAAQ;aACX,KAAK,CAAC,KAAK,CAAC;aACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;aACpB,IAAI,CAAC,IAAI,CAAC,EACb,EAAE,CACH,CAAC;IACJ,IAAI,KAAK,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,KAAK,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,8CAA8C,MAAM,kCAAkC,CAAC,CAAC;IACnG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAa,EACb,OAA2B;IAE3B,4EAA4E;IAC5E,8EAA8E;IAC9E,2DAA2D;IAC3D,eAAe,EAAE,CAAC;IAClB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ;YAChC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAC/B,CAAC,CAAC,OAAO,CAAC,QAAQ;gBAClB,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YACtB,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC3E,oEAAoE;YACpE,8DAA8D;YAC9D,OAAO,EAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC,KAAK,CAAC,EAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,EAAC,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAC,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtE,OAAO,EAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC,MAAM,CAAC,EAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,WAAW,GAAG,IAAI,CAAC;IACnB,gBAAgB,GAAG,IAAI,CAAC;IACxB,YAAY,CAAC,KAAK,EAAE,CAAC;IACrB,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC"}

package/dist/esm/docs/types.d.ts

@@ -1,16 +1,67 @@
 export declare const SCRIPT_API_DATA_DIR: string;
 export declare const XSD_DATA_DIR: string;
+export declare const JOB_STEPS_DATA_DIR: string;
+export declare const GUIDES_DATA_DIR: string;
+export declare const TOOLING_DATA_DIR: string;
+/**
+ * The corpus a documentation entry belongs to. Used to tag and filter results
+ * so agents can narrow a search to a documentation set (e.g., only Storefront
+ * Next guides, or only the Script API reference).
+ *
+ * - `script-api` — B2C Commerce Script API class/module reference
+ * - `job-step` — standard (system) job step reference
+ * - `commerce-api` / `pwa-kit-managed-runtime` / `sfnext` / `sfra` / `b2c-commerce`
+ *   — Developer Center prose guides, one category per Developer Center project
+ * - `tooling` — this project's own conceptual guides (CLI/MCP/SDK usage)
+ */
+export type DocCategory = 'script-api' | 'job-step' | 'commerce-api' | 'pwa-kit-managed-runtime' | 'sfnext' | 'sfra' | 'b2c-commerce' | 'tooling';
 /**
  * A documentation entry in the search index.
+ *
+ * Entries span multiple corpora (Script API reference, job steps, Developer
+ * Center guides, and this project's own docs). Reference entries are bundled
+ * on disk and read via {@link DocEntry.filePath}; guide entries are indexed
+ * locally but their full content is fetched on demand from {@link DocEntry.url}.
  */
 export interface DocEntry {
-    /** Unique identifier - the filename without .md extension (e.g., "dw.catalog.ProductMgr") */
+    /**
+     * Unique identifier. For bundled reference this is the filename without its
+     * extension (e.g., "dw.catalog.ProductMgr"); for guides it is namespaced by
+     * category to avoid cross-corpus collisions (e.g., "sfnext/sfnext-get-started").
+     */
     id: string;
-    /** The title from the document heading (e.g., "Class ProductMgr") */
+    /** The title from the document's first heading (e.g., "Class ProductMgr"). */
     title: string;
-    /** The filename (e.g., "dw.catalog.ProductMgr.md") */
-    filePath: string;
-    /** Optional preview/excerpt from the document */
+    /** The corpus/category this entry belongs to. */
+    category?: DocCategory;
+    /**
+     * Path of the bundled markdown file relative to its corpus data directory.
+     * Present for entries whose content ships in the package; absent for entries
+     * whose content is fetched online (see {@link DocEntry.sourceUrl}).
+     */
+    filePath?: string;
+    /**
+     * Canonical human-facing published URL (the rendered `.html` page, e.g. on
+     * developer.salesforce.com). This is the durable link to cite/open in a
+     * browser. Present for every corpus that has a public page (guides, Script
+     * API reference, tooling); absent for corpora with no public page (job steps).
+     */
+    url?: string;
+    /**
+     * The raw-markdown (`.md`) URL for the same document — the machine-readable
+     * source. For online-only entries (guides) this is what {@link readEntryContent}
+     * fetches at read time. Bundled corpora (Script API, tooling) also carry it so
+     * callers can retrieve the raw source on request even though content ships in
+     * the package. Absent for corpora with no public page (job steps).
+     */
+    sourceUrl?: string;
+    /** Section headings joined into a single searchable string (indexed, not for display). */
+    headings?: string;
+    /** One-line summary describing what task/topic the doc helps with (agent triage). */
+    summary?: string;
+    /** Search keywords/synonyms an agent or developer might use to find this doc. */
+    keywords?: string[];
+    /** Optional preview/excerpt from the document. */
     preview?: string;
 }
 /**
@@ -30,7 +81,7 @@ export interface SearchIndex {
 export interface SearchResult {
     /** The matching documentation entry */
     entry: DocEntry;
-    /** Match score (lower is better in Fuse.js, 0 = perfect match) */
+    /** Relevance score (higher is better; scale is engine-relative, not normalized). */
     score: number;
 }
 /**