@wix/web5-core 1.56.0

package/dist/esm/utils/diagnosticsCollector.js

@@ -0,0 +1,52 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/**
+ * Diagnostics collector — pure data class for buffering parser/render-time
+ * diagnostic entries with dedup. Lifted from `web50-server-ui` per DL #088 B9.4.
+ *
+ * The BI-firing + app-store-aware singleton wrapping (`fireDiagnosticEvent`,
+ * `setLastDiagnosticsCollector`, `flushDiagnostics`) stays in
+ * `web50-server-ui/src/utils/diagnosticsCollector.ts` because it depends on
+ * the BI logger + app store. After B9.5, the lifted `parseMarkdownToComponents`
+ * accepts a `DiagnosticsCollector` instance via options and never touches the
+ * singleton, so the placement bundle can construct its own collector and read
+ * the entries directly without involving BI.
+ */
+
+export class DiagnosticsCollector {
+  constructor() {
+    _defineProperty(this, "entries", []);
+    _defineProperty(this, "seen", new Set());
+  }
+  static entryKey(entry) {
+    return `${entry.sectionType}:${entry.sectionIndex}:${entry.diagnosticType}:${entry.details}`;
+  }
+  report(entry) {
+    const key = DiagnosticsCollector.entryKey(entry);
+    if (this.seen.has(key)) {
+      return;
+    }
+    this.seen.add(key);
+    this.entries.push(entry);
+  }
+
+  /**
+   * Add to dedup set and return true if this is a new entry. Does NOT buffer —
+   * use for render-time diagnostics that fire immediately.
+   */
+  reportIfNew(entry) {
+    const key = DiagnosticsCollector.entryKey(entry);
+    if (this.seen.has(key)) {
+      return false;
+    }
+    this.seen.add(key);
+    return true;
+  }
+  getEntries() {
+    return [...this.entries];
+  }
+  clear() {
+    this.entries = [];
+    this.seen.clear();
+  }
+}
+//# sourceMappingURL=diagnosticsCollector.js.map

package/dist/esm/utils/diagnosticsCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DiagnosticsCollector","constructor","_defineProperty","Set","entryKey","entry","sectionType","sectionIndex","diagnosticType","details","report","key","seen","has","add","entries","push","reportIfNew","getEntries","clear"],"sources":["../../../src/utils/diagnosticsCollector.ts"],"sourcesContent":["/**\n * Diagnostics collector — pure data class for buffering parser/render-time\n * diagnostic entries with dedup. Lifted from `web50-server-ui` per DL #088 B9.4.\n *\n * The BI-firing + app-store-aware singleton wrapping (`fireDiagnosticEvent`,\n * `setLastDiagnosticsCollector`, `flushDiagnostics`) stays in\n * `web50-server-ui/src/utils/diagnosticsCollector.ts` because it depends on\n * the BI logger + app store. After B9.5, the lifted `parseMarkdownToComponents`\n * accepts a `DiagnosticsCollector` instance via options and never touches the\n * singleton, so the placement bundle can construct its own collector and read\n * the entries directly without involving BI.\n */\nimport type { DiagnosticType } from '../component/diagnosticTypes';\n\nexport interface DiagnosticEntry {\n  diagnosticType: DiagnosticType;\n  sectionType: string;\n  sectionIndex: number;\n  details: string;\n}\n\nexport class DiagnosticsCollector {\n  private entries: DiagnosticEntry[] = [];\n  private seen = new Set<string>();\n\n  private static entryKey(entry: DiagnosticEntry): string {\n    return `${entry.sectionType}:${entry.sectionIndex}:${entry.diagnosticType}:${entry.details}`;\n  }\n\n  report(entry: DiagnosticEntry): void {\n    const key = DiagnosticsCollector.entryKey(entry);\n    if (this.seen.has(key)) {\n      return;\n    }\n    this.seen.add(key);\n    this.entries.push(entry);\n  }\n\n  /**\n   * Add to dedup set and return true if this is a new entry. Does NOT buffer —\n   * use for render-time diagnostics that fire immediately.\n   */\n  reportIfNew(entry: DiagnosticEntry): boolean {\n    const key = DiagnosticsCollector.entryKey(entry);\n    if (this.seen.has(key)) {\n      return false;\n    }\n    this.seen.add(key);\n    return true;\n  }\n\n  getEntries(): DiagnosticEntry[] {\n    return [...this.entries];\n  }\n\n  clear(): void {\n    this.entries = [];\n    this.seen.clear();\n  }\n}\n"],"mappings":";AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA,OAAO,MAAMA,oBAAoB,CAAC;EAAAC,YAAA;IAAAC,eAAA,kBACK,EAAE;IAAAA,eAAA,eACxB,IAAIC,GAAG,CAAS,CAAC;EAAA;EAEhC,OAAeC,QAAQA,CAACC,KAAsB,EAAU;IACtD,OAAO,GAAGA,KAAK,CAACC,WAAW,IAAID,KAAK,CAACE,YAAY,IAAIF,KAAK,CAACG,cAAc,IAAIH,KAAK,CAACI,OAAO,EAAE;EAC9F;EAEAC,MAAMA,CAACL,KAAsB,EAAQ;IACnC,MAAMM,GAAG,GAAGX,oBAAoB,CAACI,QAAQ,CAACC,KAAK,CAAC;IAChD,IAAI,IAAI,CAACO,IAAI,CAACC,GAAG,CAACF,GAAG,CAAC,EAAE;MACtB;IACF;IACA,IAAI,CAACC,IAAI,CAACE,GAAG,CAACH,GAAG,CAAC;IAClB,IAAI,CAACI,OAAO,CAACC,IAAI,CAACX,KAAK,CAAC;EAC1B;;EAEA;AACF;AACA;AACA;EACEY,WAAWA,CAACZ,KAAsB,EAAW;IAC3C,MAAMM,GAAG,GAAGX,oBAAoB,CAACI,QAAQ,CAACC,KAAK,CAAC;IAChD,IAAI,IAAI,CAACO,IAAI,CAACC,GAAG,CAACF,GAAG,CAAC,EAAE;MACtB,OAAO,KAAK;IACd;IACA,IAAI,CAACC,IAAI,CAACE,GAAG,CAACH,GAAG,CAAC;IAClB,OAAO,IAAI;EACb;EAEAO,UAAUA,CAAA,EAAsB;IAC9B,OAAO,CAAC,GAAG,IAAI,CAACH,OAAO,CAAC;EAC1B;EAEAI,KAAKA,CAAA,EAAS;IACZ,IAAI,CAACJ,OAAO,GAAG,EAAE;IACjB,IAAI,CAACH,IAAI,CAACO,KAAK,CAAC,CAAC;EACnB;AACF","ignoreList":[]}

package/dist/esm/utils/entityLinkParser.js

@@ -0,0 +1,246 @@
+import { Web5UrlType, isWeb5EntityUrl } from '../types/link-types.js';
+const WEB5_TYPE_PREFIXES = Object.values(Web5UrlType);
+
+/**
+ * Central parser for unified web5:// URLs.
+ *
+ * Supported formats:
+ * - `web5://ask/msg` → `{ type: Web5UrlType.ASK, path: 'msg' }`
+ * - `web5://entity/solution/123` → `{ type: Web5UrlType.ENTITY, path: 'solution/123', entityType: 'solution', entityId: '123' }`
+ * - `web5://image/kw` → `{ type: Web5UrlType.IMAGE, path: 'kw' }`
+ * - `web5://icon/name` → `{ type: Web5UrlType.ICON, path: 'name' }`
+ * - `web5://action/name?param=val` → `{ type: Web5UrlType.ACTION, path: 'name?param=val', actionName: 'name', actionParams: { param: 'val' } }`
+ * - `web5://search/query` → `{ type: Web5UrlType.SEARCH, path: 'query', searchQuery: 'query' }`
+ */
+export function parseWeb5Url(url) {
+  if (!url || typeof url !== 'string') {
+    return null;
+  }
+  if (!url.startsWith('web5://')) {
+    return null;
+  }
+  const fullPath = url.slice('web5://'.length);
+  if (!fullPath) {
+    return null;
+  }
+  for (const prefix of WEB5_TYPE_PREFIXES) {
+    if (fullPath === prefix || fullPath.startsWith(prefix + '/')) {
+      const path = fullPath.slice(prefix.length + 1);
+      switch (prefix) {
+        case Web5UrlType.ENTITY:
+          {
+            const slashIndex = path.indexOf('/');
+            if (slashIndex === -1) {
+              return {
+                type: Web5UrlType.ENTITY,
+                path,
+                entityType: path,
+                entityId: ''
+              };
+            }
+            return {
+              type: Web5UrlType.ENTITY,
+              path,
+              entityType: path.slice(0, slashIndex),
+              entityId: path.slice(slashIndex + 1)
+            };
+          }
+        case Web5UrlType.ACTION:
+          {
+            const qIndex = path.indexOf('?');
+            if (qIndex === -1) {
+              return {
+                type: Web5UrlType.ACTION,
+                path,
+                actionName: path,
+                actionParams: {}
+              };
+            }
+            const params = {};
+            const searchParams = new URLSearchParams(path.slice(qIndex + 1));
+            searchParams.forEach((value, key) => {
+              params[key] = value;
+            });
+            return {
+              type: Web5UrlType.ACTION,
+              path,
+              actionName: path.slice(0, qIndex),
+              actionParams: params
+            };
+          }
+        case Web5UrlType.SEARCH:
+          return {
+            type: Web5UrlType.SEARCH,
+            path,
+            searchQuery: path ? decodeURIComponent(path.replace(/\+/g, ' ')) : ''
+          };
+        case Web5UrlType.ASK:
+          return {
+            type: Web5UrlType.ASK,
+            path
+          };
+        case Web5UrlType.IMAGE:
+          return {
+            type: Web5UrlType.IMAGE,
+            path
+          };
+        case Web5UrlType.ICON:
+          return {
+            type: Web5UrlType.ICON,
+            path
+          };
+      }
+    }
+  }
+  return null;
+}
+
+/**
+ * Check if a URL is a valid web5:// URL with a recognized type prefix.
+ */
+export function isValidWeb5Url(url) {
+  return parseWeb5Url(url) !== null;
+}
+
+/** Known legacy protocols that are no longer supported */
+const LEGACY_PROTOCOLS = ['entity://', 'image://', 'action://', 'ask://'];
+
+/**
+ * Validate whether a URL is safe to render as a clickable link.
+ *
+ * - Standard protocols (http, https, mailto, relative paths) → allowed
+ * - Valid `web5://` URLs (recognized type prefix) → allowed
+ * - Invalid `web5://` URLs (unrecognized prefix) → rejected
+ * - Legacy protocols (`entity://`, `image://`, `action://`, `ask://`) → rejected
+ * - Other custom protocols → rejected
+ *
+ * @returns the URL as `ValidLinkUrl` if valid, or `undefined` if it should not be rendered.
+ *          When invalid, logs a warning for observability.
+ */
+export function validateLinkUrl(url) {
+  if (!url) {
+    return undefined;
+  }
+  if (url.startsWith('http://') || url.startsWith('https://') || url.startsWith('mailto:') || url.startsWith('/')) {
+    return url;
+  }
+  if (url.startsWith('web5://')) {
+    if (parseWeb5Url(url)) {
+      return url;
+    }
+    console.log(`[web5-link] Invalid web5:// URL rejected: "${url}"`);
+    return undefined;
+  }
+  if (LEGACY_PROTOCOLS.some(p => url.startsWith(p))) {
+    console.log(`[web5-link] Legacy protocol URL rejected: "${url}". Use web5:// format instead.`);
+    return undefined;
+  }
+  return undefined;
+}
+
+/**
+ * Check if a URL is a web5://entity/ link
+ * @param url - The URL to check
+ * @returns true if the URL is an entity link
+ */
+export function isEntityLink(url) {
+  if (!url || typeof url !== 'string') {
+    return false;
+  }
+  return isWeb5EntityUrl(url);
+}
+
+/**
+ * Parse a web5://entity/ URL and extract entityType and entityId
+ * Format: web5://entity/{entityType}/{entityId}
+ *
+ * @param url - The web5://entity/ URL to parse
+ * @returns Object with entityType and entityId, or null if not a valid entity link
+ *
+ * @example
+ * parseEntityLink('web5://entity/blog_post/abc123')
+ * // Returns: { entityType: 'blog_post', entityId: 'abc123' }
+ */
+export function parseEntityLink(url) {
+  if (!isEntityLink(url)) {
+    return null;
+  }
+  const path = url.slice('web5://entity/'.length);
+
+  // Split by '/' to get entityType and entityId
+  const slashIndex = path.indexOf('/');
+  if (slashIndex === -1) {
+    // No slash found - only entityType, no entityId
+    const entityType = path.trim();
+    if (entityType) {
+      return {
+        entityType,
+        entityId: ''
+      };
+    }
+    return null;
+  }
+  const entityType = path.slice(0, slashIndex).trim();
+  const entityId = path.slice(slashIndex + 1).trim();
+  if (!entityType) {
+    return null;
+  }
+  return {
+    entityType,
+    entityId
+  };
+}
+
+/**
+ * Extract protocol from a URL
+ * @param url - The URL to extract protocol from
+ * @returns The protocol (e.g., 'entity', 'http', 'https') or undefined
+ */
+export function extractProtocol(url) {
+  if (!url || typeof url !== 'string') {
+    return undefined;
+  }
+  const match = url.match(/^([a-zA-Z][a-zA-Z0-9+.-]*):\/\//);
+  if (match) {
+    return match[1].toLowerCase();
+  }
+  return undefined;
+}
+
+/**
+ * Extract LinkMetadata from a link AST node
+ * @param node - AST node of type 'link'
+ * @returns LinkMetadata object with url, protocol, and entity fields, or null
+ *   when the URL is missing or whitespace-only (empty-href links are dropped
+ *   by the upstream pipeline; see `markdownBlocks.ts`).
+ */
+export function extractLinkMetadata(node) {
+  if (!node || node.type !== 'link') {
+    return null;
+  }
+  const url = node.url;
+  if (typeof url !== 'string' || url.trim() === '') {
+    return null;
+  }
+  const metadata = {
+    url
+  };
+
+  // Extract protocol
+  const protocol = extractProtocol(url);
+  if (protocol) {
+    metadata.protocol = protocol;
+  }
+  if (protocol === 'web5') {
+    const parsed = parseWeb5Url(url);
+    if (parsed) {
+      metadata.web5Type = parsed.type;
+      if (parsed.type === Web5UrlType.ENTITY) {
+        metadata.entityType = parsed.entityType;
+        metadata.entityId = parsed.entityId;
+      }
+    }
+  }
+  return metadata;
+}
+//# sourceMappingURL=entityLinkParser.js.map

package/dist/esm/utils/entityLinkParser.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Web5UrlType","isWeb5EntityUrl","WEB5_TYPE_PREFIXES","Object","values","parseWeb5Url","url","startsWith","fullPath","slice","length","prefix","path","ENTITY","slashIndex","indexOf","type","entityType","entityId","ACTION","qIndex","actionName","actionParams","params","searchParams","URLSearchParams","forEach","value","key","SEARCH","searchQuery","decodeURIComponent","replace","ASK","IMAGE","ICON","isValidWeb5Url","LEGACY_PROTOCOLS","validateLinkUrl","undefined","console","log","some","p","isEntityLink","parseEntityLink","trim","extractProtocol","match","toLowerCase","extractLinkMetadata","node","metadata","protocol","parsed","web5Type"],"sources":["../../../src/utils/entityLinkParser.ts"],"sourcesContent":["import type { LinkMetadata } from '../patternValidator/types';\nimport {\n  Web5UrlType,\n  isWeb5EntityUrl,\n  type ValidLinkUrl,\n} from '../types/link-types';\n\nexport interface Web5AskParsed {\n  type: Web5UrlType.ASK;\n  path: string;\n}\n\nexport interface Web5EntityParsed {\n  type: Web5UrlType.ENTITY;\n  path: string;\n  entityType: string;\n  entityId: string;\n}\n\nexport interface Web5ImageParsed {\n  type: Web5UrlType.IMAGE;\n  path: string;\n}\n\nexport interface Web5IconParsed {\n  type: Web5UrlType.ICON;\n  path: string;\n}\n\nexport interface Web5ActionParsed {\n  type: Web5UrlType.ACTION;\n  path: string;\n  actionName: string;\n  actionParams: Record<string, string>;\n}\n\nexport interface Web5SearchParsed {\n  type: Web5UrlType.SEARCH;\n  path: string;\n  searchQuery: string;\n}\n\nexport type Web5UrlParsed =\n  | Web5AskParsed\n  | Web5EntityParsed\n  | Web5ImageParsed\n  | Web5IconParsed\n  | Web5ActionParsed\n  | Web5SearchParsed;\n\nconst WEB5_TYPE_PREFIXES = Object.values(Web5UrlType);\n\n/**\n * Central parser for unified web5:// URLs.\n *\n * Supported formats:\n * - `web5://ask/msg` → `{ type: Web5UrlType.ASK, path: 'msg' }`\n * - `web5://entity/solution/123` → `{ type: Web5UrlType.ENTITY, path: 'solution/123', entityType: 'solution', entityId: '123' }`\n * - `web5://image/kw` → `{ type: Web5UrlType.IMAGE, path: 'kw' }`\n * - `web5://icon/name` → `{ type: Web5UrlType.ICON, path: 'name' }`\n * - `web5://action/name?param=val` → `{ type: Web5UrlType.ACTION, path: 'name?param=val', actionName: 'name', actionParams: { param: 'val' } }`\n * - `web5://search/query` → `{ type: Web5UrlType.SEARCH, path: 'query', searchQuery: 'query' }`\n */\nexport function parseWeb5Url(url: string): Web5UrlParsed | null {\n  if (!url || typeof url !== 'string') {\n    return null;\n  }\n\n  if (!url.startsWith('web5://')) {\n    return null;\n  }\n\n  const fullPath = url.slice('web5://'.length);\n  if (!fullPath) {\n    return null;\n  }\n\n  for (const prefix of WEB5_TYPE_PREFIXES) {\n    if (fullPath === prefix || fullPath.startsWith(prefix + '/')) {\n      const path = fullPath.slice(prefix.length + 1);\n\n      switch (prefix) {\n        case Web5UrlType.ENTITY: {\n          const slashIndex = path.indexOf('/');\n          if (slashIndex === -1) {\n            return {\n              type: Web5UrlType.ENTITY,\n              path,\n              entityType: path,\n              entityId: '',\n            };\n          }\n          return {\n            type: Web5UrlType.ENTITY,\n            path,\n            entityType: path.slice(0, slashIndex),\n            entityId: path.slice(slashIndex + 1),\n          };\n        }\n        case Web5UrlType.ACTION: {\n          const qIndex = path.indexOf('?');\n          if (qIndex === -1) {\n            return {\n              type: Web5UrlType.ACTION,\n              path,\n              actionName: path,\n              actionParams: {},\n            };\n          }\n          const params: Record<string, string> = {};\n          const searchParams = new URLSearchParams(path.slice(qIndex + 1));\n          searchParams.forEach((value, key) => {\n            params[key] = value;\n          });\n          return {\n            type: Web5UrlType.ACTION,\n            path,\n            actionName: path.slice(0, qIndex),\n            actionParams: params,\n          };\n        }\n        case Web5UrlType.SEARCH:\n          return {\n            type: Web5UrlType.SEARCH,\n            path,\n            searchQuery: path\n              ? decodeURIComponent(path.replace(/\\+/g, ' '))\n              : '',\n          };\n        case Web5UrlType.ASK:\n          return { type: Web5UrlType.ASK, path };\n        case Web5UrlType.IMAGE:\n          return { type: Web5UrlType.IMAGE, path };\n        case Web5UrlType.ICON:\n          return { type: Web5UrlType.ICON, path };\n      }\n    }\n  }\n\n  return null;\n}\n\n/**\n * Check if a URL is a valid web5:// URL with a recognized type prefix.\n */\nexport function isValidWeb5Url(url: string): boolean {\n  return parseWeb5Url(url) !== null;\n}\n\n/** Known legacy protocols that are no longer supported */\nconst LEGACY_PROTOCOLS = ['entity://', 'image://', 'action://', 'ask://'];\n\n/**\n * Validate whether a URL is safe to render as a clickable link.\n *\n * - Standard protocols (http, https, mailto, relative paths) → allowed\n * - Valid `web5://` URLs (recognized type prefix) → allowed\n * - Invalid `web5://` URLs (unrecognized prefix) → rejected\n * - Legacy protocols (`entity://`, `image://`, `action://`, `ask://`) → rejected\n * - Other custom protocols → rejected\n *\n * @returns the URL as `ValidLinkUrl` if valid, or `undefined` if it should not be rendered.\n *          When invalid, logs a warning for observability.\n */\nexport function validateLinkUrl(\n  url: string | undefined,\n): ValidLinkUrl | undefined {\n  if (!url) {\n    return undefined;\n  }\n\n  if (\n    url.startsWith('http://') ||\n    url.startsWith('https://') ||\n    url.startsWith('mailto:') ||\n    url.startsWith('/')\n  ) {\n    return url as ValidLinkUrl;\n  }\n\n  if (url.startsWith('web5://')) {\n    if (parseWeb5Url(url)) {\n      return url as ValidLinkUrl;\n    }\n    console.log(`[web5-link] Invalid web5:// URL rejected: \"${url}\"`);\n    return undefined;\n  }\n\n  if (LEGACY_PROTOCOLS.some((p) => url.startsWith(p))) {\n    console.log(\n      `[web5-link] Legacy protocol URL rejected: \"${url}\". Use web5:// format instead.`,\n    );\n    return undefined;\n  }\n\n  return undefined;\n}\n\n/**\n * Check if a URL is a web5://entity/ link\n * @param url - The URL to check\n * @returns true if the URL is an entity link\n */\nexport function isEntityLink(url: string): boolean {\n  if (!url || typeof url !== 'string') {\n    return false;\n  }\n  return isWeb5EntityUrl(url);\n}\n\n/**\n * Parse a web5://entity/ URL and extract entityType and entityId\n * Format: web5://entity/{entityType}/{entityId}\n *\n * @param url - The web5://entity/ URL to parse\n * @returns Object with entityType and entityId, or null if not a valid entity link\n *\n * @example\n * parseEntityLink('web5://entity/blog_post/abc123')\n * // Returns: { entityType: 'blog_post', entityId: 'abc123' }\n */\nexport function parseEntityLink(\n  url: string,\n): { entityType: string; entityId: string } | null {\n  if (!isEntityLink(url)) {\n    return null;\n  }\n\n  const path = url.slice('web5://entity/'.length);\n\n  // Split by '/' to get entityType and entityId\n  const slashIndex = path.indexOf('/');\n  if (slashIndex === -1) {\n    // No slash found - only entityType, no entityId\n    const entityType = path.trim();\n    if (entityType) {\n      return { entityType, entityId: '' };\n    }\n    return null;\n  }\n\n  const entityType = path.slice(0, slashIndex).trim();\n  const entityId = path.slice(slashIndex + 1).trim();\n\n  if (!entityType) {\n    return null;\n  }\n\n  return { entityType, entityId };\n}\n\n/**\n * Extract protocol from a URL\n * @param url - The URL to extract protocol from\n * @returns The protocol (e.g., 'entity', 'http', 'https') or undefined\n */\nexport function extractProtocol(url: string): string | undefined {\n  if (!url || typeof url !== 'string') {\n    return undefined;\n  }\n\n  const match = url.match(/^([a-zA-Z][a-zA-Z0-9+.-]*):\\/\\//);\n  if (match) {\n    return match[1].toLowerCase();\n  }\n\n  return undefined;\n}\n\n/**\n * Extract LinkMetadata from a link AST node\n * @param node - AST node of type 'link'\n * @returns LinkMetadata object with url, protocol, and entity fields, or null\n *   when the URL is missing or whitespace-only (empty-href links are dropped\n *   by the upstream pipeline; see `markdownBlocks.ts`).\n */\nexport function extractLinkMetadata(node: any): LinkMetadata | null {\n  if (!node || node.type !== 'link') {\n    return null;\n  }\n\n  const url = node.url;\n  if (typeof url !== 'string' || url.trim() === '') {\n    return null;\n  }\n\n  const metadata: LinkMetadata = {\n    url,\n  };\n\n  // Extract protocol\n  const protocol = extractProtocol(url);\n  if (protocol) {\n    metadata.protocol = protocol;\n  }\n\n  if (protocol === 'web5') {\n    const parsed = parseWeb5Url(url);\n    if (parsed) {\n      metadata.web5Type = parsed.type;\n      if (parsed.type === Web5UrlType.ENTITY) {\n        metadata.entityType = parsed.entityType;\n        metadata.entityId = parsed.entityId;\n      }\n    }\n  }\n\n  return metadata;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/utils/htmlCommentParser.js

@@ -0,0 +1,117 @@
+/**
+ * Parse an HTML comment string into a key-value object
+ * @param comment - The HTML comment string (e.g., "<!-- key: value, key: value -->")
+ * @returns Object with parsed key-value pairs, or empty object if parsing fails
+ */
+export function parseHtmlComment(comment) {
+  if (!comment || typeof comment !== 'string') {
+    return {};
+  }
+
+  // Remove HTML comment markers <!-- and -->
+  let content = comment.trim();
+  if (content.startsWith('<!--')) {
+    content = content.slice(4);
+  }
+  if (content.endsWith('-->')) {
+    content = content.slice(0, -3);
+  }
+  content = content.trim();
+  if (!content) {
+    return {};
+  }
+  const result = {};
+
+  // Split by comma, but handle commas within quoted values
+  const parts = [];
+  let currentPart = '';
+  let inQuotes = false;
+  let quoteChar = '';
+  for (let i = 0; i < content.length; i++) {
+    const char = content[i];
+    if ((char === '"' || char === "'") && (i === 0 || content[i - 1] !== '\\')) {
+      if (!inQuotes) {
+        inQuotes = true;
+        quoteChar = char;
+      } else if (char === quoteChar) {
+        inQuotes = false;
+        quoteChar = '';
+      }
+      currentPart += char;
+    } else if (char === ',' && !inQuotes) {
+      parts.push(currentPart.trim());
+      currentPart = '';
+    } else {
+      currentPart += char;
+    }
+  }
+
+  // Add the last part
+  if (currentPart.trim()) {
+    parts.push(currentPart.trim());
+  }
+
+  // Parse each part as key: value or standalone identifier
+  for (const part of parts) {
+    const colonIndex = part.indexOf(':');
+    const equalsIndex = part.indexOf('=');
+
+    // Check for key=value format
+    if (equalsIndex !== -1 && (colonIndex === -1 || equalsIndex < colonIndex)) {
+      const key = part.slice(0, equalsIndex).trim();
+      let value = part.slice(equalsIndex + 1).trim();
+
+      // Remove quotes if present
+      if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+        value = value.slice(1, -1);
+      }
+      if (key) {
+        result[key] = value;
+      }
+    }
+    // Check for key: value format
+    else if (colonIndex !== -1) {
+      const key = part.slice(0, colonIndex).trim();
+      let value = part.slice(colonIndex + 1).trim();
+
+      // Remove quotes if present
+      if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+        value = value.slice(1, -1);
+      }
+      if (key) {
+        result[key] = value;
+      }
+    }
+    // Standalone identifier (e.g., <!-- Callout -->)
+    else {
+      const identifier = part.trim();
+      if (identifier && /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(identifier)) {
+        // Valid identifier: starts with letter or underscore, contains letters, numbers, underscores, or hyphens
+        result[identifier] = '';
+      }
+    }
+  }
+  return result;
+}
+
+/**
+ * Extract HTML comment value from an AST html node
+ * @param node - AST node of type 'html'
+ * @returns The comment content string, or null if not an HTML comment
+ */
+export function extractHtmlCommentValue(node) {
+  if (!node || node.type !== 'html') {
+    return null;
+  }
+  const value = node.value;
+  if (typeof value !== 'string') {
+    return null;
+  }
+
+  // Check if it's an HTML comment
+  if (value.trim().startsWith('<!--') && value.trim().endsWith('-->')) {
+    return value;
+  }
+  return null;
+}
+//# sourceMappingURL=htmlCommentParser.js.map

package/dist/esm/utils/htmlCommentParser.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["parseHtmlComment","comment","content","trim","startsWith","slice","endsWith","result","parts","currentPart","inQuotes","quoteChar","i","length","char","push","part","colonIndex","indexOf","equalsIndex","key","value","identifier","test","extractHtmlCommentValue","node","type"],"sources":["../../../src/utils/htmlCommentParser.ts"],"sourcesContent":["/**\n * Parse an HTML comment string into a key-value object\n * @param comment - The HTML comment string (e.g., \"<!-- key: value, key: value -->\")\n * @returns Object with parsed key-value pairs, or empty object if parsing fails\n */\nexport function parseHtmlComment(comment: string): Record<string, string> {\n  if (!comment || typeof comment !== 'string') {\n    return {};\n  }\n\n  // Remove HTML comment markers <!-- and -->\n  let content = comment.trim();\n  if (content.startsWith('<!--')) {\n    content = content.slice(4);\n  }\n  if (content.endsWith('-->')) {\n    content = content.slice(0, -3);\n  }\n  content = content.trim();\n\n  if (!content) {\n    return {};\n  }\n\n  const result: Record<string, string> = {};\n\n  // Split by comma, but handle commas within quoted values\n  const parts: string[] = [];\n  let currentPart = '';\n  let inQuotes = false;\n  let quoteChar = '';\n\n  for (let i = 0; i < content.length; i++) {\n    const char = content[i];\n\n    if (\n      (char === '\"' || char === \"'\") &&\n      (i === 0 || content[i - 1] !== '\\\\')\n    ) {\n      if (!inQuotes) {\n        inQuotes = true;\n        quoteChar = char;\n      } else if (char === quoteChar) {\n        inQuotes = false;\n        quoteChar = '';\n      }\n      currentPart += char;\n    } else if (char === ',' && !inQuotes) {\n      parts.push(currentPart.trim());\n      currentPart = '';\n    } else {\n      currentPart += char;\n    }\n  }\n\n  // Add the last part\n  if (currentPart.trim()) {\n    parts.push(currentPart.trim());\n  }\n\n  // Parse each part as key: value or standalone identifier\n  for (const part of parts) {\n    const colonIndex = part.indexOf(':');\n    const equalsIndex = part.indexOf('=');\n\n    // Check for key=value format\n    if (equalsIndex !== -1 && (colonIndex === -1 || equalsIndex < colonIndex)) {\n      const key = part.slice(0, equalsIndex).trim();\n      let value = part.slice(equalsIndex + 1).trim();\n\n      // Remove quotes if present\n      if (\n        (value.startsWith('\"') && value.endsWith('\"')) ||\n        (value.startsWith(\"'\") && value.endsWith(\"'\"))\n      ) {\n        value = value.slice(1, -1);\n      }\n\n      if (key) {\n        result[key] = value;\n      }\n    }\n    // Check for key: value format\n    else if (colonIndex !== -1) {\n      const key = part.slice(0, colonIndex).trim();\n      let value = part.slice(colonIndex + 1).trim();\n\n      // Remove quotes if present\n      if (\n        (value.startsWith('\"') && value.endsWith('\"')) ||\n        (value.startsWith(\"'\") && value.endsWith(\"'\"))\n      ) {\n        value = value.slice(1, -1);\n      }\n\n      if (key) {\n        result[key] = value;\n      }\n    }\n    // Standalone identifier (e.g., <!-- Callout -->)\n    else {\n      const identifier = part.trim();\n      if (identifier && /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(identifier)) {\n        // Valid identifier: starts with letter or underscore, contains letters, numbers, underscores, or hyphens\n        result[identifier] = '';\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Extract HTML comment value from an AST html node\n * @param node - AST node of type 'html'\n * @returns The comment content string, or null if not an HTML comment\n */\nexport function extractHtmlCommentValue(node: any): string | null {\n  if (!node || node.type !== 'html') {\n    return null;\n  }\n\n  const value = node.value;\n  if (typeof value !== 'string') {\n    return null;\n  }\n\n  // Check if it's an HTML comment\n  if (value.trim().startsWith('<!--') && value.trim().endsWith('-->')) {\n    return value;\n  }\n\n  return null;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/utils/image-utils.js

@@ -0,0 +1,45 @@
+const WIX_MEDIA_STATIC = 'https://static.wixstatic.com/media/';
+export function normalizeImageUrl(imageUrl) {
+  if (!imageUrl) {
+    return imageUrl;
+  }
+  if (imageUrl.startsWith('http://') || imageUrl.startsWith('https://') || imageUrl.startsWith('data:') || imageUrl.startsWith('blob:')) {
+    return imageUrl;
+  }
+  if (imageUrl.startsWith(WIX_MEDIA_STATIC)) {
+    return imageUrl;
+  }
+  const cleanUrl = imageUrl.startsWith('/') ? imageUrl.slice(1) : imageUrl;
+  return `${WIX_MEDIA_STATIC}${cleanUrl}`;
+}
+export function getResizedImageUrl(imageURI, width, height, params) {
+  return getResizedImagePartialUrl(WIX_MEDIA_STATIC, imageURI, width, height, params);
+}
+function getResizedImagePartialUrl(baseUrl, imageURI, width, height, _temp) {
+  let {
+    usm_r = 0.66,
+    usm_a = 1.0,
+    usm_t = 0.01,
+    quality,
+    imageMode = 'fit'
+  } = _temp === void 0 ? {} : _temp;
+  if (imageURI.includes('/')) {
+    return imageURI;
+  }
+  width = Math.round(width);
+  height = Math.round(height);
+  if (!quality) {
+    const HIGH_QUALITY_RESOLUTION = 1400 * 1400;
+    const MEDIUM_QUALITY_RESOLUTION = 600 * 600;
+    const dimension = width * height;
+    if (dimension > HIGH_QUALITY_RESOLUTION) {
+      quality = 90;
+    } else if (dimension > MEDIUM_QUALITY_RESOLUTION) {
+      quality = 85;
+    } else {
+      quality = 80;
+    }
+  }
+  return `${baseUrl}${imageURI}/v1/${imageMode}/w_${width},h_${height},al_c,q_${quality},usm_${usm_r.toFixed(2)}_${usm_a.toFixed(2)}_${usm_t.toFixed(2)}/${imageURI}`;
+}
+//# sourceMappingURL=image-utils.js.map

package/dist/esm/utils/image-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["WIX_MEDIA_STATIC","normalizeImageUrl","imageUrl","startsWith","cleanUrl","slice","getResizedImageUrl","imageURI","width","height","params","getResizedImagePartialUrl","baseUrl","_temp","usm_r","usm_a","usm_t","quality","imageMode","includes","Math","round","HIGH_QUALITY_RESOLUTION","MEDIUM_QUALITY_RESOLUTION","dimension","toFixed"],"sources":["../../../src/utils/image-utils.ts"],"sourcesContent":["export type TParams = {\n  quality?: number;\n  usm_r?: number;\n  usm_a?: number;\n  usm_t?: number;\n  imageMode?: 'fit' | 'fill';\n};\n\nconst WIX_MEDIA_STATIC = 'https://static.wixstatic.com/media/';\n\nexport function normalizeImageUrl(imageUrl: string): string {\n  if (!imageUrl) {\n    return imageUrl;\n  }\n\n  if (\n    imageUrl.startsWith('http://') ||\n    imageUrl.startsWith('https://') ||\n    imageUrl.startsWith('data:') ||\n    imageUrl.startsWith('blob:')\n  ) {\n    return imageUrl;\n  }\n\n  if (imageUrl.startsWith(WIX_MEDIA_STATIC)) {\n    return imageUrl;\n  }\n\n  const cleanUrl = imageUrl.startsWith('/') ? imageUrl.slice(1) : imageUrl;\n  return `${WIX_MEDIA_STATIC}${cleanUrl}`;\n}\n\nexport function getResizedImageUrl(\n  imageURI: string,\n  width: number,\n  height: number,\n  params?: TParams,\n) {\n  return getResizedImagePartialUrl(\n    WIX_MEDIA_STATIC,\n    imageURI,\n    width,\n    height,\n    params,\n  );\n}\n\nfunction getResizedImagePartialUrl(\n  baseUrl: string,\n  imageURI: string,\n  width: number,\n  height: number,\n  {\n    usm_r = 0.66,\n    usm_a = 1.0,\n    usm_t = 0.01,\n    quality,\n    imageMode = 'fit',\n  }: TParams = {},\n) {\n  if (imageURI.includes('/')) {\n    return imageURI;\n  }\n\n  width = Math.round(width);\n  height = Math.round(height);\n\n  if (!quality) {\n    const HIGH_QUALITY_RESOLUTION = 1400 * 1400;\n    const MEDIUM_QUALITY_RESOLUTION = 600 * 600;\n    const dimension = width * height;\n    if (dimension > HIGH_QUALITY_RESOLUTION) {\n      quality = 90;\n    } else if (dimension > MEDIUM_QUALITY_RESOLUTION) {\n      quality = 85;\n    } else {\n      quality = 80;\n    }\n  }\n\n  return `${baseUrl}${imageURI}/v1/${imageMode}/w_${width},h_${height},al_c,q_${quality},usm_${usm_r.toFixed(\n    2,\n  )}_${usm_a.toFixed(2)}_${usm_t.toFixed(2)}/${imageURI}`;\n}\n"],"mappings":"AAQA,MAAMA,gBAAgB,GAAG,qCAAqC;AAE9D,OAAO,SAASC,iBAAiBA,CAACC,QAAgB,EAAU;EAC1D,IAAI,CAACA,QAAQ,EAAE;IACb,OAAOA,QAAQ;EACjB;EAEA,IACEA,QAAQ,CAACC,UAAU,CAAC,SAAS,CAAC,IAC9BD,QAAQ,CAACC,UAAU,CAAC,UAAU,CAAC,IAC/BD,QAAQ,CAACC,UAAU,CAAC,OAAO,CAAC,IAC5BD,QAAQ,CAACC,UAAU,CAAC,OAAO,CAAC,EAC5B;IACA,OAAOD,QAAQ;EACjB;EAEA,IAAIA,QAAQ,CAACC,UAAU,CAACH,gBAAgB,CAAC,EAAE;IACzC,OAAOE,QAAQ;EACjB;EAEA,MAAME,QAAQ,GAAGF,QAAQ,CAACC,UAAU,CAAC,GAAG,CAAC,GAAGD,QAAQ,CAACG,KAAK,CAAC,CAAC,CAAC,GAAGH,QAAQ;EACxE,OAAO,GAAGF,gBAAgB,GAAGI,QAAQ,EAAE;AACzC;AAEA,OAAO,SAASE,kBAAkBA,CAChCC,QAAgB,EAChBC,KAAa,EACbC,MAAc,EACdC,MAAgB,EAChB;EACA,OAAOC,yBAAyB,CAC9BX,gBAAgB,EAChBO,QAAQ,EACRC,KAAK,EACLC,MAAM,EACNC,MACF,CAAC;AACH;AAEA,SAASC,yBAAyBA,CAChCC,OAAe,EACfL,QAAgB,EAChBC,KAAa,EACbC,MAAc,EAAAI,KAAA,EAQd;EAAA,IAPA;IACEC,KAAK,GAAG,IAAI;IACZC,KAAK,GAAG,GAAG;IACXC,KAAK,GAAG,IAAI;IACZC,OAAO;IACPC,SAAS,GAAG;EACL,CAAC,GAAAL,KAAA,cAAG,CAAC,CAAC,GAAAA,KAAA;EAEf,IAAIN,QAAQ,CAACY,QAAQ,CAAC,GAAG,CAAC,EAAE;IAC1B,OAAOZ,QAAQ;EACjB;EAEAC,KAAK,GAAGY,IAAI,CAACC,KAAK,CAACb,KAAK,CAAC;EACzBC,MAAM,GAAGW,IAAI,CAACC,KAAK,CAACZ,MAAM,CAAC;EAE3B,IAAI,CAACQ,OAAO,EAAE;IACZ,MAAMK,uBAAuB,GAAG,IAAI,GAAG,IAAI;IAC3C,MAAMC,yBAAyB,GAAG,GAAG,GAAG,GAAG;IAC3C,MAAMC,SAAS,GAAGhB,KAAK,GAAGC,MAAM;IAChC,IAAIe,SAAS,GAAGF,uBAAuB,EAAE;MACvCL,OAAO,GAAG,EAAE;IACd,CAAC,MAAM,IAAIO,SAAS,GAAGD,yBAAyB,EAAE;MAChDN,OAAO,GAAG,EAAE;IACd,CAAC,MAAM;MACLA,OAAO,GAAG,EAAE;IACd;EACF;EAEA,OAAO,GAAGL,OAAO,GAAGL,QAAQ,OAAOW,SAAS,MAAMV,KAAK,MAAMC,MAAM,WAAWQ,OAAO,QAAQH,KAAK,CAACW,OAAO,CACxG,CACF,CAAC,IAAIV,KAAK,CAACU,OAAO,CAAC,CAAC,CAAC,IAAIT,KAAK,CAACS,OAAO,CAAC,CAAC,CAAC,IAAIlB,QAAQ,EAAE;AACzD","ignoreList":[]}

package/dist/esm/utils/intentExtractor.js

@@ -0,0 +1,45 @@
+import { Intent } from '../registry/Intent.js';
+import { parseHtmlComment } from './htmlCommentParser.js';
+const INTENT_VALUES = new Set(Object.values(Intent));
+function normalizeIntent(intent) {
+  if (!intent) {
+    return null;
+  }
+  const normalized = intent.trim().toUpperCase();
+  return INTENT_VALUES.has(normalized) ? normalized : null;
+}
+function normalizeState(state) {
+  const normalized = state == null ? void 0 : state.trim().toLowerCase();
+  return normalized === 'partial' ? 'partial' : 'full';
+}
+export function extractIntentFromMarkdown(markdown) {
+  if (!markdown) {
+    return null;
+  }
+  const match = markdown.match(/^\s*<!--[\s\S]*?-->/);
+  if (!match) {
+    return null;
+  }
+  const comment = match[0];
+  const metadata = parseHtmlComment(comment);
+  const intent = normalizeIntent(metadata.intent);
+  if (!intent) {
+    return null;
+  }
+  return {
+    intent,
+    stage: metadata.stage,
+    reason: metadata.reason,
+    state: normalizeState(metadata.state)
+  };
+}
+export function getIntentFromMarkdown(markdown, defaultIntent) {
+  if (defaultIntent === void 0) {
+    defaultIntent = Intent.DISCOVERY;
+  }
+  return extractIntentFromMarkdown(markdown) ?? {
+    intent: defaultIntent,
+    state: 'full'
+  };
+}
+//# sourceMappingURL=intentExtractor.js.map

package/dist/esm/utils/intentExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Intent","parseHtmlComment","INTENT_VALUES","Set","Object","values","normalizeIntent","intent","normalized","trim","toUpperCase","has","normalizeState","state","toLowerCase","extractIntentFromMarkdown","markdown","match","comment","metadata","stage","reason","getIntentFromMarkdown","defaultIntent","DISCOVERY"],"sources":["../../../src/utils/intentExtractor.ts"],"sourcesContent":["import { Intent } from '../registry/Intent';\nimport { parseHtmlComment } from './htmlCommentParser';\n\nexport type ResponseState = 'full' | 'partial';\n\nexport interface IntentInfo {\n  intent: Intent;\n  stage?: string;\n  reason?: string;\n  state?: ResponseState;\n}\n\nconst INTENT_VALUES = new Set<Intent>(Object.values(Intent) as Intent[]);\n\nfunction normalizeIntent(intent?: string): Intent | null {\n  if (!intent) {\n    return null;\n  }\n  const normalized = intent.trim().toUpperCase() as Intent;\n  return INTENT_VALUES.has(normalized) ? normalized : null;\n}\n\nfunction normalizeState(state?: string): ResponseState {\n  const normalized = state?.trim().toLowerCase();\n  return normalized === 'partial' ? 'partial' : 'full';\n}\n\nexport function extractIntentFromMarkdown(markdown: string): IntentInfo | null {\n  if (!markdown) {\n    return null;\n  }\n\n  const match = markdown.match(/^\\s*<!--[\\s\\S]*?-->/);\n  if (!match) {\n    return null;\n  }\n\n  const comment = match[0];\n  const metadata = parseHtmlComment(comment);\n  const intent = normalizeIntent(metadata.intent);\n\n  if (!intent) {\n    return null;\n  }\n\n  return {\n    intent,\n    stage: metadata.stage,\n    reason: metadata.reason,\n    state: normalizeState(metadata.state),\n  };\n}\n\nexport function getIntentFromMarkdown(\n  markdown: string,\n  defaultIntent: Intent = Intent.DISCOVERY,\n): IntentInfo {\n  return (\n    extractIntentFromMarkdown(markdown) ?? {\n      intent: defaultIntent,\n      state: 'full',\n    }\n  );\n}\n"],"mappings":"AAAA,SAASA,MAAM,QAAQ,oBAAoB;AAC3C,SAASC,gBAAgB,QAAQ,qBAAqB;AAWtD,MAAMC,aAAa,GAAG,IAAIC,GAAG,CAASC,MAAM,CAACC,MAAM,CAACL,MAAM,CAAa,CAAC;AAExE,SAASM,eAAeA,CAACC,MAAe,EAAiB;EACvD,IAAI,CAACA,MAAM,EAAE;IACX,OAAO,IAAI;EACb;EACA,MAAMC,UAAU,GAAGD,MAAM,CAACE,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC,CAAW;EACxD,OAAOR,aAAa,CAACS,GAAG,CAACH,UAAU,CAAC,GAAGA,UAAU,GAAG,IAAI;AAC1D;AAEA,SAASI,cAAcA,CAACC,KAAc,EAAiB;EACrD,MAAML,UAAU,GAAGK,KAAK,oBAALA,KAAK,CAAEJ,IAAI,CAAC,CAAC,CAACK,WAAW,CAAC,CAAC;EAC9C,OAAON,UAAU,KAAK,SAAS,GAAG,SAAS,GAAG,MAAM;AACtD;AAEA,OAAO,SAASO,yBAAyBA,CAACC,QAAgB,EAAqB;EAC7E,IAAI,CAACA,QAAQ,EAAE;IACb,OAAO,IAAI;EACb;EAEA,MAAMC,KAAK,GAAGD,QAAQ,CAACC,KAAK,CAAC,qBAAqB,CAAC;EACnD,IAAI,CAACA,KAAK,EAAE;IACV,OAAO,IAAI;EACb;EAEA,MAAMC,OAAO,GAAGD,KAAK,CAAC,CAAC,CAAC;EACxB,MAAME,QAAQ,GAAGlB,gBAAgB,CAACiB,OAAO,CAAC;EAC1C,MAAMX,MAAM,GAAGD,eAAe,CAACa,QAAQ,CAACZ,MAAM,CAAC;EAE/C,IAAI,CAACA,MAAM,EAAE;IACX,OAAO,IAAI;EACb;EAEA,OAAO;IACLA,MAAM;IACNa,KAAK,EAAED,QAAQ,CAACC,KAAK;IACrBC,MAAM,EAAEF,QAAQ,CAACE,MAAM;IACvBR,KAAK,EAAED,cAAc,CAACO,QAAQ,CAACN,KAAK;EACtC,CAAC;AACH;AAEA,OAAO,SAASS,qBAAqBA,CACnCN,QAAgB,EAChBO,aAAqB,EACT;EAAA,IADZA,aAAqB;IAArBA,aAAqB,GAAGvB,MAAM,CAACwB,SAAS;EAAA;EAExC,OACET,yBAAyB,CAACC,QAAQ,CAAC,IAAI;IACrCT,MAAM,EAAEgB,aAAa;IACrBV,KAAK,EAAE;EACT,CAAC;AAEL","ignoreList":[]}