@wix/web5-core 1.56.0

package/dist/types/utils/contentKeywordMatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentKeywordMatcher.d.ts","sourceRoot":"","sources":["../../../src/utils/contentKeywordMatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAK7E;;;GAGG;AACH,eAAO,MAAM,qBAAqB,iBAClB,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,mBAC1B,MAAM,EAAE,KACxB,MAAM,EAkBR,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,iBACvB,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,mBAC1B,MAAM,EAAE,gBACX,MAAM,aACT,iBAAiB,KAC3B,qBAkBF,CAAC"}

package/dist/types/utils/conversationApi.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Conversation API selection (debug-only).
+ *
+ * Switches the conversation between the default `Conversation` RPC
+ * (`POST /v1/conversation`) and the parallel-safe `Turn` RPC
+ * (`POST /v1/turn`, DL #110). Persisted in
+ * `localStorage["web5_conversation_api"]`, read at request time. Default
+ * `conversation` (Turn is opt-in via the debug toggle for now).
+ *
+ * `Turn` returns a flat markdown stream (no sectioned page frames), so the
+ * sectioned-stream consumption path only runs on the `Conversation` API. Lives
+ * in web5-core so any surface can honor the same toggle.
+ */
+export type ConversationApiKind = 'turn' | 'conversation';
+export declare const CONVERSATION_API_KEY = "web5_conversation_api";
+export declare const DEFAULT_CONVERSATION_API: ConversationApiKind;
+/**
+ * Read the selected conversation API from localStorage. Falls back to the
+ * default (`conversation`) when unset, invalid, or storage is unavailable.
+ */
+export declare const getConversationApi: () => ConversationApiKind;
+/** Persist the selected conversation API to localStorage. */
+export declare const setConversationApi: (api: ConversationApiKind) => void;
+/** Whether the conversation should use the Turn RPC (opt-in; default is Conversation). */
+export declare const usesTurnApi: () => boolean;
+//# sourceMappingURL=conversationApi.d.ts.map

package/dist/types/utils/conversationApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationApi.d.ts","sourceRoot":"","sources":["../../../src/utils/conversationApi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,cAAc,CAAC;AAE1D,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAE5D,eAAO,MAAM,wBAAwB,EAAE,mBAAoC,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAO,mBAUrC,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,QAAS,mBAAmB,KAAG,IAM7D,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,WAAW,QAAO,OAA0C,CAAC"}

package/dist/types/utils/conversationMode.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Conversation wire mode.
+ *
+ * There is a single conversation engine: the page streams section-by-section
+ * (each markdown frame tagged with a numeric section `id` + `status`). The
+ * `additionalData.mode` sent on every `/conversation` request is fixed.
+ *
+ * A `?mode=` query param, when present, overrides this value and is sent to the
+ * backend verbatim (callers read the param themselves); the frontend always
+ * uses the sectioned-stream consumption path regardless.
+ */
+/** `additionalData.mode` sent on a `/conversation` request. */
+export declare const CONVERSATION_MODE = "markdown_history_v3";
+/** Resolve the `additionalData.mode` to send on a `/conversation` request. */
+export declare const resolveConversationMode: () => string;
+//# sourceMappingURL=conversationMode.d.ts.map

package/dist/types/utils/conversationMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationMode.d.ts","sourceRoot":"","sources":["../../../src/utils/conversationMode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAEvD,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,QAAO,MAA2B,CAAC"}

package/dist/types/utils/diagnosticsCollector.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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.
+ */
+import type { DiagnosticType } from '../component/diagnosticTypes';
+export interface DiagnosticEntry {
+    diagnosticType: DiagnosticType;
+    sectionType: string;
+    sectionIndex: number;
+    details: string;
+}
+export declare class DiagnosticsCollector {
+    private entries;
+    private seen;
+    private static entryKey;
+    report(entry: DiagnosticEntry): void;
+    /**
+     * 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: DiagnosticEntry): boolean;
+    getEntries(): DiagnosticEntry[];
+    clear(): void;
+}
+//# sourceMappingURL=diagnosticsCollector.d.ts.map

package/dist/types/utils/diagnosticsCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticsCollector.d.ts","sourceRoot":"","sources":["../../../src/utils/diagnosticsCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,IAAI,CAAqB;IAEjC,OAAO,CAAC,MAAM,CAAC,QAAQ;IAIvB,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IASpC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO;IAS5C,UAAU,IAAI,eAAe,EAAE;IAI/B,KAAK,IAAI,IAAI;CAId"}

package/dist/types/utils/entityLinkParser.d.ts

@@ -0,0 +1,97 @@
+import type { LinkMetadata } from '../patternValidator/types';
+import { Web5UrlType, type ValidLinkUrl } from '../types/link-types';
+export interface Web5AskParsed {
+    type: Web5UrlType.ASK;
+    path: string;
+}
+export interface Web5EntityParsed {
+    type: Web5UrlType.ENTITY;
+    path: string;
+    entityType: string;
+    entityId: string;
+}
+export interface Web5ImageParsed {
+    type: Web5UrlType.IMAGE;
+    path: string;
+}
+export interface Web5IconParsed {
+    type: Web5UrlType.ICON;
+    path: string;
+}
+export interface Web5ActionParsed {
+    type: Web5UrlType.ACTION;
+    path: string;
+    actionName: string;
+    actionParams: Record<string, string>;
+}
+export interface Web5SearchParsed {
+    type: Web5UrlType.SEARCH;
+    path: string;
+    searchQuery: string;
+}
+export type Web5UrlParsed = Web5AskParsed | Web5EntityParsed | Web5ImageParsed | Web5IconParsed | Web5ActionParsed | Web5SearchParsed;
+/**
+ * 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 declare function parseWeb5Url(url: string): Web5UrlParsed | null;
+/**
+ * Check if a URL is a valid web5:// URL with a recognized type prefix.
+ */
+export declare function isValidWeb5Url(url: string): boolean;
+/**
+ * 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 declare function validateLinkUrl(url: string | undefined): ValidLinkUrl | 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 declare function isEntityLink(url: string): boolean;
+/**
+ * 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 declare function parseEntityLink(url: string): {
+    entityType: string;
+    entityId: string;
+} | null;
+/**
+ * Extract protocol from a URL
+ * @param url - The URL to extract protocol from
+ * @returns The protocol (e.g., 'entity', 'http', 'https') or undefined
+ */
+export declare function extractProtocol(url: string): string | 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 declare function extractLinkMetadata(node: any): LinkMetadata | null;
+//# sourceMappingURL=entityLinkParser.d.ts.map

package/dist/types/utils/entityLinkParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityLinkParser.d.ts","sourceRoot":"","sources":["../../../src/utils/entityLinkParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACL,WAAW,EAEX,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,gBAAgB,CAAC;AAIrB;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA6E9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,YAAY,GAAG,SAAS,CA8B1B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GACV;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0BjD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW/D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,YAAY,GAAG,IAAI,CAgClE"}

package/dist/types/utils/htmlCommentParser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 declare function parseHtmlComment(comment: string): Record<string, string>;
+/**
+ * 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 declare function extractHtmlCommentValue(node: any): string | null;
+//# sourceMappingURL=htmlCommentParser.d.ts.map

package/dist/types/utils/htmlCommentParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlCommentParser.d.ts","sourceRoot":"","sources":["../../../src/utils/htmlCommentParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyGxE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAgBhE"}

package/dist/types/utils/image-utils.d.ts

@@ -0,0 +1,10 @@
+export type TParams = {
+    quality?: number;
+    usm_r?: number;
+    usm_a?: number;
+    usm_t?: number;
+    imageMode?: 'fit' | 'fill';
+};
+export declare function normalizeImageUrl(imageUrl: string): string;
+export declare function getResizedImageUrl(imageURI: string, width: number, height: number, params?: TParams): string;
+//# sourceMappingURL=image-utils.d.ts.map

package/dist/types/utils/image-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/image-utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B,CAAC;AAIF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoB1D;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,UASjB"}

package/dist/types/utils/intentExtractor.d.ts

@@ -0,0 +1,11 @@
+import { Intent } from '../registry/Intent';
+export type ResponseState = 'full' | 'partial';
+export interface IntentInfo {
+    intent: Intent;
+    stage?: string;
+    reason?: string;
+    state?: ResponseState;
+}
+export declare function extractIntentFromMarkdown(markdown: string): IntentInfo | null;
+export declare function getIntentFromMarkdown(markdown: string, defaultIntent?: Intent): IntentInfo;
+//# sourceMappingURL=intentExtractor.d.ts.map

package/dist/types/utils/intentExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intentExtractor.d.ts","sourceRoot":"","sources":["../../../src/utils/intentExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAiBD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAwB7E;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,aAAa,GAAE,MAAyB,GACvC,UAAU,CAOZ"}

package/dist/types/utils/markdownPreprocessor.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Markdown preprocessing utilities
+ *
+ * These functions fix common markdown formatting issues before AST parsing.
+ * They are applied in a specific order to ensure proper processing.
+ */
+export interface PreprocessorDiagnostic {
+    type: string;
+    original: string;
+    normalized: string;
+}
+export interface PreprocessResult {
+    markdown: string;
+    diagnostics: PreprocessorDiagnostic[];
+}
+/**
+ * Escape web5:// links by URL-encoding the URL part
+ * e.g. [text](web5://some text with spaces) → [text](web5://some%20text%20with%20spaces)
+ *
+ * @param markdown - The markdown string to process
+ * @returns The markdown string with web5:// URLs properly encoded
+ */
+export declare function escapeWeb5Links(markdown: string): string;
+/**
+ * Fix malformed markdown links with whitespace (spaces, tabs, newlines) between ] and (
+ * e.g. [text] (url) → [text](url)
+ * e.g. [text]\n(url) → [text](url)
+ *
+ * @param markdown - The markdown string to process
+ * @returns The markdown string with fixed link formatting
+ */
+export declare function fixMalformedLinks(markdown: string): string;
+/**
+ * Recover inline CTA chips where the LLM emitted emphasized text followed by a
+ * dangling markdown link close, e.g. `**label →**](web5://ask/query)`.
+ */
+export declare function recoverOrphanedEmphasisLinks(markdown: string): {
+    result: string;
+    diagnostics: PreprocessorDiagnostic[];
+};
+/**
+ * Trim trailing whitespace from lines that contain text
+ *
+ * @param markdown - The markdown string to process
+ * @returns The markdown string with trailing whitespace trimmed from text lines
+ */
+export declare function trimTrailingWhitespace(markdown: string): string;
+/**
+ * Normalize malformed web5://icon URLs to the canonical web5://icon/{name} format.
+ * Handles variants like web5://icon:arrow, web5://icon-arrow, web5://icon arrow → web5://icon/arrow.
+ * Only alphanumeric characters and dashes are kept in the icon name.
+ */
+export declare function normalizeIconUrls(markdown: string): {
+    result: string;
+    diagnostics: PreprocessorDiagnostic[];
+};
+/**
+ * Repair LLM-emitted pipe tables that omit the GFM delimiter row.
+ * Without this line remark-gfm parses the rows as plain paragraphs, so
+ * registry sections such as comparison never receive a `table` part.
+ */
+export declare function insertMissingTableSeparators(markdown: string): {
+    result: string;
+    diagnostics: PreprocessorDiagnostic[];
+};
+/**
+ * Decode URL-encoded text in markdown link labels.
+ * e.g. [Some%20Text](https://example.com) → [Some Text](https://example.com)
+ * e.g. [Which+solution%3F](web5://...) → [Which solution?](web5://...)
+ *
+ * Only decodes the text portion [text], never the URL portion (url).
+ * Handles both `+` (form-encoded space) and `%XX` escapes; falls back to
+ * the original string on malformed percent sequences.
+ */
+export declare function decodeLinkText(markdown: string): {
+    result: string;
+    diagnostics: PreprocessorDiagnostic[];
+};
+/**
+ * Preprocess markdown to fix common formatting issues before AST parsing.
+ *
+ * The preprocessing steps are applied in the following order:
+ * 1. Recover orphaned emphasized web5 links
+ * 2. Fix malformed links (remove whitespace between ] and () - must happen before web5 links are matched)
+ * 3. Decode URL-encoded link text
+ * 4. Escape web5:// links (URL-encode URLs)
+ * 5. Normalize icon URLs
+ * 6. Insert missing table separators for obvious pipe tables
+ * 7. Trim trailing whitespace from lines
+ *
+ * @param markdown - The raw markdown string to preprocess
+ * @returns The preprocessed markdown string ready for AST parsing
+ */
+export declare function preprocessMarkdown(markdown: string): PreprocessResult;
+//# sourceMappingURL=markdownPreprocessor.d.ts.map

package/dist/types/utils/markdownPreprocessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownPreprocessor.d.ts","sourceRoot":"","sources":["../../../src/utils/markdownPreprocessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,sBAAsB,EAAE,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwBxD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,sBAAsB,EAAE,CAAC;CACvC,CAeA;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiB/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,sBAAsB,EAAE,CAAC;CACvC,CAoBA;AA6BD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,sBAAsB,EAAE,CAAC;CACvC,CA0CA;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,sBAAsB,EAAE,CAAC;CACvC,CAuBA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAqBrE"}

package/dist/types/utils/navigationStack.d.ts

@@ -0,0 +1,6 @@
+export declare function getForwardStack(): string[];
+export declare function setForwardStack(stack: string[]): void;
+export declare function clearForwardStack(): void;
+export declare function pushToForwardStack(triggerId: string): void;
+export declare function popFromForwardStack(): string | undefined;
+//# sourceMappingURL=navigationStack.d.ts.map

package/dist/types/utils/navigationStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationStack.d.ts","sourceRoot":"","sources":["../../../src/utils/navigationStack.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAO1C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAE9C;AAED,wBAAgB,iBAAiB,SAEhC;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,QAInD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAKxD"}

package/dist/types/utils/nodeMatchers.d.ts

@@ -0,0 +1,10 @@
+import type { RootContent } from 'mdast';
+/**
+ * Check if an HTML node is a comment
+ */
+export declare function isHtmlComment(node: any): boolean;
+/**
+ * Check if a node has images nested within it (for paragraphs with images)
+ */
+export declare function hasImage(node: RootContent): boolean;
+//# sourceMappingURL=nodeMatchers.d.ts.map

package/dist/types/utils/nodeMatchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeMatchers.d.ts","sourceRoot":"","sources":["../../../src/utils/nodeMatchers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEzC;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAMhD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAyBnD"}

package/dist/types/utils/propsExtractor.d.ts

@@ -0,0 +1,51 @@
+import type { RootContent } from 'mdast';
+import type { PageSection } from '../types/page-section';
+import { ReactElement } from 'react';
+export interface Product {
+    id: string;
+    imageUrl: string;
+    productName: string;
+    description?: string;
+    price?: string;
+    onClick?: string;
+    linkText?: string;
+    linkUrl?: string;
+    colorSwatches?: string[];
+    badgeText?: string;
+    rating?: number;
+    reviewCount?: number;
+}
+export interface ComparisonProduct {
+    id: string;
+    imageUrl: string;
+    name: string;
+    price: string;
+    onClick?: string;
+    features: Record<string, string>;
+}
+export interface ProductComparisonSectionProps {
+    title: string;
+    subtitle?: string;
+    products: ComparisonProduct[];
+    backgroundColor?: string;
+    highlightDifferences?: boolean;
+    showImages?: boolean;
+    onProductClick?: string;
+    ready: boolean;
+}
+export declare const findImageInNode: (node: RootContent) => string | null;
+export declare const findImageInChildren: (children: RootContent[]) => string;
+export declare function generateSectionId(componentName: string, index: number): string;
+export declare function createPageSection({ component, sectionType, componentName, semantic, componentOptions, index, id, sourceMarkdown, debugProps, }: {
+    component: ReactElement | null;
+    sectionType: string;
+    componentName?: string;
+    semantic?: string;
+    componentOptions?: Record<string, any>;
+    index: number;
+    id?: string;
+    sourceMarkdown?: string;
+    debugProps?: any;
+}): PageSection;
+export declare function generateId(): string;
+//# sourceMappingURL=propsExtractor.d.ts.map

package/dist/types/utils/propsExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propsExtractor.d.ts","sourceRoot":"","sources":["../../../src/utils/propsExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,eAAe,SAAU,WAAW,KAAG,MAAM,GAAG,IAa5D,CAAC;AAEF,eAAO,MAAM,mBAAmB,aAAc,WAAW,EAAE,KAAG,MAa7D,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAED,wBAAgB,iBAAiB,CAAC,EAChC,SAAS,EACT,WAAW,EACX,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,EAAE,EACF,cAAc,EACd,UAAU,GACX,EAAE;IACD,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB,GAAG,WAAW,CAWd;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/types/utils/sessionManager.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Session identity shared across every surface that calls `/conversation`.
+ *
+ * Lives in web5-core (lifted from web50-server-ui, same move as
+ * `conversationBackend.ts`) so the main app and the embed-placement bundle
+ * send the same `sessionId` structure — a GUID persisted in sessionStorage
+ * under one key/codec. Surfaces on the same origin literally share the id;
+ * on different origins they still agree on the wire shape.
+ */
+/**
+ * Gets or creates a session ID from sessionStorage.
+ * If no session ID exists, creates a new one and stores it.
+ * If it exists, returns the existing one without overriding.
+ * Falls back to an ephemeral GUID when sessionStorage is unavailable
+ * (SSR, storage disabled).
+ */
+export declare const getOrCreateSessionId: () => string;
+/**
+ * Gets the current session ID without creating a new one
+ */
+export declare const getSessionId: () => string | null;
+/**
+ * Session-stable chat id (`chat-id-<epoch>-<random>`), persisted in
+ * sessionStorage under the same key/codec convention as the session id.
+ *
+ * Persisted (changed from the original in-memory-only page-visit scope) so
+ * the chat CARRIES OVER across same-origin navigations — main web5 page →
+ * product page and between PDPs. On the markdown-history backend the chat id
+ * is the conversation id, so this threads all of a visit's turns into one
+ * conversation (history/BO grouping) and keeps the BE's history cache
+ * (`msid_chatId`) warm across pages — classify's `<last_turn>` sees the
+ * previous page's turn. Placement prompt isolation is NOT affected: the BE's
+ * running-context key prefers the per-placement `session_id` that
+ * embed-placement sends, falling back to this chat id only for surfaces
+ * that don't send one (the main app).
+ *
+ * In-memory memo remains the fast path and the fallback when storage is
+ * unavailable (SSR, privacy mode) — there the id is page-load-stable, the
+ * previous behavior.
+ */
+export declare const getChatId: () => string;
+/**
+ * Mint a fresh chat id, replacing the memoized AND persisted one. Call when
+ * the user starts a NEW conversation (main app's first send of a fresh
+ * thread) — the previous conversation's id must not leak into the new one,
+ * or into the placement calls of the pages visited next.
+ */
+export declare const startNewChatId: () => string;
+/**
+ * Adopt an externally resolved chat id — e.g. a conversation restored from
+ * history by trigger id — as the session's current chat. Memoized and
+ * persisted so the next pages' placement calls continue that conversation.
+ */
+export declare const setChatId: (id: string) => void;
+/** Test-only: reset the memoized chat id and its persisted copy. */
+export declare const resetChatIdForTests: () => void;
+//# sourceMappingURL=sessionManager.d.ts.map

package/dist/types/utils/sessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionManager.d.ts","sourceRoot":"","sources":["../../../src/utils/sessionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyBH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAAO,MAYvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,QAAO,MAAM,GAAG,IAExC,CAAC;AAkCF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS,QAAO,MAU5B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAO,MAIjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,OAAQ,MAAM,KAAG,IAItC,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,QAAO,IAOtC,CAAC"}

package/dist/types/utils/unifiedMarkdownParser.d.ts

@@ -0,0 +1,9 @@
+import type { Root, Node } from 'mdast';
+export declare class UnifiedMarkdownParser {
+    private processor;
+    constructor();
+    parse(markdown: string): Root;
+}
+export declare function parseMarkdownToAst(markdown: string): Root;
+export declare const parseAstToMarkdown: (nodes: Node[]) => string;
+//# sourceMappingURL=unifiedMarkdownParser.d.ts.map

package/dist/types/utils/unifiedMarkdownParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unifiedMarkdownParser.d.ts","sourceRoot":"","sources":["../../../src/utils/unifiedMarkdownParser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAe,MAAM,OAAO,CAAC;AAKrD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,SAAS,CAAC;;IAMlB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAQ9B;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGzD;AAED,eAAO,MAAM,kBAAkB,UAAW,IAAI,EAAE,KAAG,MAOlD,CAAC"}

package/dist/types/utils/web5LinkValidator.d.ts

@@ -0,0 +1,14 @@
+import type { RootContent } from 'mdast';
+export interface InvalidWeb5Link {
+    url: string;
+    nodeType: string;
+    reason: 'invalid' | 'legacy' | 'empty';
+}
+/**
+ * Walk AST nodes and find link/image URLs that fail validation:
+ *  - `web5://` URLs that don't parse,
+ *  - legacy-protocol URLs (`entity://`, `image://`, etc.),
+ *  - link nodes with a missing or whitespace-only href.
+ */
+export declare function findInvalidWeb5Links(nodes: RootContent[]): InvalidWeb5Link[];
+//# sourceMappingURL=web5LinkValidator.d.ts.map

package/dist/types/utils/web5LinkValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web5LinkValidator.d.ts","sourceRoot":"","sources":["../../../src/utils/web5LinkValidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAKzC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAuC5E"}

package/dist/types/utils/web5LinkValidator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=web5LinkValidator.test.d.ts.map

package/dist/types/utils/web5LinkValidator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web5LinkValidator.test.d.ts","sourceRoot":"","sources":["../../../src/utils/web5LinkValidator.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@wix/web5-core",
+  "license": "MIT",
+  "version": "1.56.0",
+  "author": {
+    "name": "tsachis",
+    "email": "tsachis@wix.com"
+  },
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "sideEffects": false,
+  "types": "dist/types/index.d.ts",
+  "files": [
+    "dist/cjs",
+    "dist/esm",
+    "dist/types",
+    "src/styles"
+  ],
+  "scripts": {
+    "build": "yoshi-library build && node scripts/fix-esm-extensions.js",
+    "start": "yoshi-library start",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "yoshi-library lint",
+    "analyze:patterns": "npx tsx src/patternAnalyzer/run.ts"
+  },
+  "lint-staged": {
+    "*.{js,ts}": "yarn lint"
+  },
+  "dependencies": {
+    "@babel/runtime": "^7.0.0",
+    "@wix/sdk": "^1.15.27",
+    "clsx": "^2.0.0",
+    "mdast-util-gfm": "^3.1.0",
+    "mdast-util-to-markdown": "^2.1.2",
+    "react-dom": "^18.2.0",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.0",
+    "remark-parse": "^11.0.0",
+    "tailwind-merge": "^2.0.0",
+    "unified": "^11.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^14.0.0",
+    "@types/mdast": "^4.0.0",
+    "@types/node": "^16.0.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "@wix/eslint-config-yoshi": "^6.0.0",
+    "@wix/yoshi-flow-library": "^6.0.0",
+    "postcss": "^8.5.0",
+    "typescript": "~5.0.0",
+    "vite": "^6.4.2",
+    "vitest": "^4.0.0"
+  },
+  "yoshiFlowLibrary": {
+    "buildEsmWithBabel": true
+  },
+  "eslintConfig": {
+    "extends": "@wix/eslint-config-yoshi",
+    "overrides": [
+      {
+        "files": [
+          "**/*.spec.ts",
+          "**/*.spec.tsx"
+        ],
+        "rules": {
+          "import/no-extraneous-dependencies": [
+            "error",
+            {
+              "devDependencies": true
+            }
+          ]
+        }
+      }
+    ]
+  },
+  "wix": {
+    "artifact": {
+      "groupId": "com.wixpress",
+      "artifactId": "web5-core"
+    },
+    "validations": {
+      "postDependenciesBuild": [
+        "lint"
+      ]
+    },
+    "framework": {
+      "type": "yoshi-flow-library"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "wallaby": {
+    "autoDetect": true
+  },
+  "falconPackageHash": "85aa415503e1949c89b77d043271b71ca3bd64f50d7027e8d8b1e0c8"
+}