@wix/web5-core 1.56.0

package/README.md

@@ -0,0 +1,8 @@
+# web5-core
+
+Library flow package generated with Yoshi.
+
+## Useful URLs
+
+- [Yoshi Library Flow Docs](https://bo.wix.com/pages/yoshi/docs/library-flow/overview)
+- [Falcon Packages Guide Docs](https://dev.wix.com/docs/rnd-general/devex/falcon/guide/packages)

package/dist/cjs/client/clientBundleOverride.js

@@ -0,0 +1,48 @@
+"use strict";
+
+exports.__esModule = true;
+exports.getClientBundleOverride = getClientBundleOverride;
+exports.isTrustedBundleHost = isTrustedBundleHost;
+/**
+ * `?clientBundleUrl=…` dev override — shared between `web50-server-ui`
+ * (the main app, DL #094) and `embed-placement` (the Shopify-page widget).
+ *
+ * Both load a `w5-client-*` UMD at runtime; both need the same per-tab
+ * escape hatch for local builds. Centralizing the trusted-host gate here
+ * means a new CDN URL is added in one place and can't drift between the
+ * two callers — divergence on a security boundary would be a real bug.
+ */
+
+const TRUSTED_BUNDLE_HOSTS = new Set(['localhost', 'd13cktzsgh0qls.cloudfront.net']);
+
+/**
+ * Returns true when `url`'s host is one we'll execute as JavaScript on the
+ * caller's page. The boundary is on WHERE the bundle is served from, not on
+ * the page origin — `?clientBundleUrl=` works from any storefront.
+ */
+function isTrustedBundleHost(url) {
+  try {
+    const {
+      hostname
+    } = new URL(url);
+    return TRUSTED_BUNDLE_HOSTS.has(hostname);
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Reads `?clientBundleUrl=…` from a query string and returns it when the
+ * URL points at a trusted host, else `null` (caller falls back to its
+ * normal resolver).
+ *
+ * Examples:
+ *   ?clientBundleUrl=http://localhost:5001/w5-client-feature-com.umd.js
+ *   ?clientBundleUrl=https://d13cktzsgh0qls.cloudfront.net/<msid>/latest/w5-components.umd.js
+ */
+function getClientBundleOverride(search) {
+  const value = new URLSearchParams(search).get('clientBundleUrl');
+  if (!value || !isTrustedBundleHost(value)) return null;
+  return value;
+}
+//# sourceMappingURL=clientBundleOverride.js.map

package/dist/cjs/client/clientBundleOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TRUSTED_BUNDLE_HOSTS","Set","isTrustedBundleHost","url","hostname","URL","has","getClientBundleOverride","search","value","URLSearchParams","get"],"sources":["../../../src/client/clientBundleOverride.ts"],"sourcesContent":["/**\n * `?clientBundleUrl=…` dev override — shared between `web50-server-ui`\n * (the main app, DL #094) and `embed-placement` (the Shopify-page widget).\n *\n * Both load a `w5-client-*` UMD at runtime; both need the same per-tab\n * escape hatch for local builds. Centralizing the trusted-host gate here\n * means a new CDN URL is added in one place and can't drift between the\n * two callers — divergence on a security boundary would be a real bug.\n */\n\nconst TRUSTED_BUNDLE_HOSTS: ReadonlySet<string> = new Set([\n  'localhost',\n  'd13cktzsgh0qls.cloudfront.net',\n]);\n\n/**\n * Returns true when `url`'s host is one we'll execute as JavaScript on the\n * caller's page. The boundary is on WHERE the bundle is served from, not on\n * the page origin — `?clientBundleUrl=` works from any storefront.\n */\nexport function isTrustedBundleHost(url: string): boolean {\n  try {\n    const { hostname } = new URL(url);\n    return TRUSTED_BUNDLE_HOSTS.has(hostname);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Reads `?clientBundleUrl=…` from a query string and returns it when the\n * URL points at a trusted host, else `null` (caller falls back to its\n * normal resolver).\n *\n * Examples:\n *   ?clientBundleUrl=http://localhost:5001/w5-client-feature-com.umd.js\n *   ?clientBundleUrl=https://d13cktzsgh0qls.cloudfront.net/<msid>/latest/w5-components.umd.js\n */\nexport function getClientBundleOverride(search: string): string | null {\n  const value = new URLSearchParams(search).get('clientBundleUrl');\n  if (!value || !isTrustedBundleHost(value)) return null;\n  return value;\n}\n"],"mappings":";;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAMA,oBAAyC,GAAG,IAAIC,GAAG,CAAC,CACxD,WAAW,EACX,+BAA+B,CAChC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACO,SAASC,mBAAmBA,CAACC,GAAW,EAAW;EACxD,IAAI;IACF,MAAM;MAAEC;IAAS,CAAC,GAAG,IAAIC,GAAG,CAACF,GAAG,CAAC;IACjC,OAAOH,oBAAoB,CAACM,GAAG,CAACF,QAAQ,CAAC;EAC3C,CAAC,CAAC,MAAM;IACN,OAAO,KAAK;EACd;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,uBAAuBA,CAACC,MAAc,EAAiB;EACrE,MAAMC,KAAK,GAAG,IAAIC,eAAe,CAACF,MAAM,CAAC,CAACG,GAAG,CAAC,iBAAiB,CAAC;EAChE,IAAI,CAACF,KAAK,IAAI,CAACP,mBAAmB,CAACO,KAAK,CAAC,EAAE,OAAO,IAAI;EACtD,OAAOA,KAAK;AACd","ignoreList":[]}

package/dist/cjs/client/devEnvironment.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+//# sourceMappingURL=devEnvironment.js.map

package/dist/cjs/client/devEnvironment.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/client/devEnvironment.ts"],"sourcesContent":["/**\n * Optional dev-only hook each client package can export to wrap the React\n * root in a host-site-like shell (header / footer / sidebars) so local\n * development looks closer to the customer page the bundle is embedded in.\n *\n * Implementations live behind an `import.meta.env.DEV` guard inside the\n * client package so they tree-shake out of the production UMD.\n */\nexport interface DevEnvironment {\n  /**\n   * Called by `client.tsx` after the bundle loads but before `createRoot`,\n   * in dev mode only. Free to mutate the DOM around `rootElement` (move it,\n   * inject siblings, append <style>/<link>, etc.).\n   *\n   * Return `{ mountElement }` to redirect React to a different node;\n   * otherwise React mounts on the original `rootElement`.\n   */\n  setup(args: { rootElement: HTMLElement }): { mountElement: HTMLElement } | void;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/cjs/client/loadClientBundle.js

@@ -0,0 +1,85 @@
+"use strict";
+
+exports.__esModule = true;
+exports.loadClientBundle = loadClientBundle;
+var React = _interopRequireWildcard(require("react"));
+var ReactDOM = _interopRequireWildcard(require("react-dom"));
+var Web5Core = _interopRequireWildcard(require("../index"));
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * Client bundle loader (DL #088 D3.3, lifted from `web50-server-ui`).
+ *
+ * Injects a client UMD `<script>` tag at the given URL, exposes the running
+ * `web5-core` instance as `window.Web5Core` so the bundle shares React-context
+ * instances with the host, and resolves with whatever the bundle attached to
+ * `window.W5ClientPackage`.
+ *
+ * Generic over the module shape — callers know what their specific bundle
+ * exports, and this primitive intentionally doesn't enforce a schema. The
+ * full app extends with rich `ClientPackageModule` / `ClientPackage` types
+ * locally; placement-style consumers only need `createDefaultRegistry` from
+ * the resolved object.
+ */
+
+const W5_CLIENT_PACKAGE_GLOBAL = 'W5ClientPackage';
+const WEB5_CORE_GLOBAL = 'Web5Core';
+const REACT_GLOBAL = 'React';
+const REACT_DOM_GLOBAL = 'ReactDOM';
+
+/**
+ * Subset of an HTMLScriptElement used by this module. Lets tests substitute a
+ * plain object with `onload` / `onerror` setters rather than spinning up a DOM.
+ */
+
+function defaultInject(src) {
+  const script = document.createElement('script');
+  script.src = src;
+  document.head.appendChild(script);
+  return script;
+}
+
+/**
+ * Inject a client UMD bundle's `<script>` tag, expose the running `web5-core`
+ * instance as `globalThis.Web5Core` for shared React contexts, and resolve
+ * with the module the bundle attached to `globalThis.W5ClientPackage`.
+ *
+ * @param bundleUrl - The CDN URL of the client UMD. Typically comes from
+ *   `Configuration.bundleUrl` (DL #075) or a route-specific override.
+ * @param opts - Optional test hooks for DOM-less environments.
+ */
+async function loadClientBundle(bundleUrl, opts = {}) {
+  const global = opts.globalRef ?? globalThis;
+  const inject = opts.injectScript ?? defaultInject;
+
+  // Expose the running web5-core instance so the UMD bundle shares the same
+  // React-context instances instead of creating duplicates inside its own
+  // import scope. Same shared-global trick web50-server-ui has used since DL #056.
+  global[WEB5_CORE_GLOBAL] = Web5Core;
+  // The client UMD lists `react` and `react-dom` as externals (see
+  // packages/web5-core/scripts/vite-cdn-config.ts) and expects `window.React`
+  // and `window.ReactDOM`. embed-placement bundles its own React inside the
+  // widget IIFE — without these assignments the UMD evaluates against
+  // `undefined` and ReactDOM throws on `__SECRET_INTERNALS_DO_NOT_USE_…`.
+  global[REACT_GLOBAL] ?? (global[REACT_GLOBAL] = React);
+  global[REACT_DOM_GLOBAL] ?? (global[REACT_DOM_GLOBAL] = ReactDOM);
+
+  // NOTE: client bundles MUST be IIFEs, not UMD — Wix Thunderbolt host pages
+  // ship RequireJS, whose global `define.amd` makes a UMD wrapper register as
+  // an anonymous AMD module instead of assigning `window.W5ClientPackage`
+  // (observed as a blank app on demoweb5cr.com). The format is enforced at
+  // build time by `scripts/vite-cdn-config.ts`; this loader deliberately does
+  // NOT touch `window.define` at runtime.
+  return new Promise((resolve, reject) => {
+    const script = inject(bundleUrl);
+    script.onload = () => {
+      const mod = global[W5_CLIENT_PACKAGE_GLOBAL];
+      if (!mod) {
+        reject(new Error(`[Web5] Bundle at ${bundleUrl} did not expose window.${W5_CLIENT_PACKAGE_GLOBAL}`));
+        return;
+      }
+      resolve(mod);
+    };
+    script.onerror = () => reject(new Error(`[Web5] Failed to load client bundle from ${bundleUrl}`));
+  });
+}
+//# sourceMappingURL=loadClientBundle.js.map

package/dist/cjs/client/loadClientBundle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","_interopRequireWildcard","require","ReactDOM","Web5Core","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","W5_CLIENT_PACKAGE_GLOBAL","WEB5_CORE_GLOBAL","REACT_GLOBAL","REACT_DOM_GLOBAL","defaultInject","src","script","document","createElement","head","appendChild","loadClientBundle","bundleUrl","opts","global","globalRef","globalThis","inject","injectScript","Promise","resolve","reject","onload","mod","Error","onerror"],"sources":["../../../src/client/loadClientBundle.ts"],"sourcesContent":["/**\n * Client bundle loader (DL #088 D3.3, lifted from `web50-server-ui`).\n *\n * Injects a client UMD `<script>` tag at the given URL, exposes the running\n * `web5-core` instance as `window.Web5Core` so the bundle shares React-context\n * instances with the host, and resolves with whatever the bundle attached to\n * `window.W5ClientPackage`.\n *\n * Generic over the module shape — callers know what their specific bundle\n * exports, and this primitive intentionally doesn't enforce a schema. The\n * full app extends with rich `ClientPackageModule` / `ClientPackage` types\n * locally; placement-style consumers only need `createDefaultRegistry` from\n * the resolved object.\n */\nimport * as React from 'react';\nimport * as ReactDOM from 'react-dom';\nimport * as Web5Core from '../index';\n\nconst W5_CLIENT_PACKAGE_GLOBAL = 'W5ClientPackage';\nconst WEB5_CORE_GLOBAL = 'Web5Core';\nconst REACT_GLOBAL = 'React';\nconst REACT_DOM_GLOBAL = 'ReactDOM';\n\n/**\n * Subset of an HTMLScriptElement used by this module. Lets tests substitute a\n * plain object with `onload` / `onerror` setters rather than spinning up a DOM.\n */\nexport interface ScriptHandle {\n  onload: ((ev?: unknown) => void) | null;\n  onerror: ((ev?: unknown) => void) | null;\n}\n\ntype ScriptInjector = (src: string) => ScriptHandle;\n\nexport interface LoadClientBundleOptions {\n  /** Test hook — inject the `<script>` via a custom function. */\n  injectScript?: ScriptInjector;\n  /** Test hook — read/write the bundle + core globals on this object instead of `globalThis`. */\n  globalRef?: Record<string, unknown>;\n}\n\nfunction defaultInject(src: string): ScriptHandle {\n  const script = document.createElement('script');\n  script.src = src;\n  document.head.appendChild(script);\n  return script as ScriptHandle;\n}\n\n/**\n * Inject a client UMD bundle's `<script>` tag, expose the running `web5-core`\n * instance as `globalThis.Web5Core` for shared React contexts, and resolve\n * with the module the bundle attached to `globalThis.W5ClientPackage`.\n *\n * @param bundleUrl - The CDN URL of the client UMD. Typically comes from\n *   `Configuration.bundleUrl` (DL #075) or a route-specific override.\n * @param opts - Optional test hooks for DOM-less environments.\n */\nexport async function loadClientBundle<T>(\n  bundleUrl: string,\n  opts: LoadClientBundleOptions = {},\n): Promise<T> {\n  const global = opts.globalRef ?? (globalThis as unknown as Record<string, unknown>);\n  const inject = opts.injectScript ?? defaultInject;\n\n  // Expose the running web5-core instance so the UMD bundle shares the same\n  // React-context instances instead of creating duplicates inside its own\n  // import scope. Same shared-global trick web50-server-ui has used since DL #056.\n  global[WEB5_CORE_GLOBAL] = Web5Core;\n  // The client UMD lists `react` and `react-dom` as externals (see\n  // packages/web5-core/scripts/vite-cdn-config.ts) and expects `window.React`\n  // and `window.ReactDOM`. embed-placement bundles its own React inside the\n  // widget IIFE — without these assignments the UMD evaluates against\n  // `undefined` and ReactDOM throws on `__SECRET_INTERNALS_DO_NOT_USE_…`.\n  global[REACT_GLOBAL] ??= React;\n  global[REACT_DOM_GLOBAL] ??= ReactDOM;\n\n  // NOTE: client bundles MUST be IIFEs, not UMD — Wix Thunderbolt host pages\n  // ship RequireJS, whose global `define.amd` makes a UMD wrapper register as\n  // an anonymous AMD module instead of assigning `window.W5ClientPackage`\n  // (observed as a blank app on demoweb5cr.com). The format is enforced at\n  // build time by `scripts/vite-cdn-config.ts`; this loader deliberately does\n  // NOT touch `window.define` at runtime.\n  return new Promise<T>((resolve, reject) => {\n    const script = inject(bundleUrl);\n    script.onload = () => {\n      const mod = global[W5_CLIENT_PACKAGE_GLOBAL] as T | undefined;\n      if (!mod) {\n        reject(\n          new Error(\n            `[Web5] Bundle at ${bundleUrl} did not expose window.${W5_CLIENT_PACKAGE_GLOBAL}`,\n          ),\n        );\n        return;\n      }\n      resolve(mod);\n    };\n    script.onerror = () =>\n      reject(new Error(`[Web5] Failed to load client bundle from ${bundleUrl}`));\n  });\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/cjs/client/wixAuthFetch.js

@@ -0,0 +1,73 @@
+"use strict";
+
+exports.__esModule = true;
+exports.createWixAuthFetch = createWixAuthFetch;
+var _sdk = require("@wix/sdk");
+/**
+ * Wix-authenticated `fetch` for Web5 BE calls from a host (third-party) origin.
+ *
+ * `wixapis.com`'s `/wix-assistant-web5/v1/conversation` endpoint refuses
+ * cross-origin anonymous calls (HTTP 500) — the only auth path that survives
+ * CORS from a host (e.g. Shopify) origin is `@wix/sdk`'s `OAuthStrategy`, which
+ * supplies the `Authorization` header the BE allowlists.
+ *
+ * Shared by every embed bundle that talks to the conversation endpoint — the
+ * placement bundle and the input-widget chip generator — so they all attach
+ * the same token. Token caching uses the same `localStorage` key format
+ * (`web5_tokens_<clientId>`) as `web50-server-ui`'s token cache, so the loader,
+ * full app, placement, and input widget share one OAuth token instead of each
+ * burning a `/oauth2/token` round-trip per page load.
+ */
+
+const TOKEN_CACHE_KEY_PREFIX = 'web5_tokens_';
+function tokenKey(clientId) {
+  return `${TOKEN_CACHE_KEY_PREFIX}${clientId}`;
+}
+function loadTokens(client, clientId) {
+  try {
+    const raw = localStorage.getItem(tokenKey(clientId));
+    if (!raw) return;
+    client.auth.setTokens(JSON.parse(raw));
+  } catch {
+    try {
+      localStorage.removeItem(tokenKey(clientId));
+    } catch {
+      /* ignore */
+    }
+  }
+}
+function saveTokens(client, clientId) {
+  try {
+    localStorage.setItem(tokenKey(clientId), JSON.stringify(client.auth.getTokens()));
+  } catch {
+    // privacy mode / quota — in-memory token still works for this session
+  }
+}
+
+/**
+ * Build a `fetch`-shaped function pre-bound to the given Wix client id. The
+ * returned value is drop-in compatible with any `fetchImpl` option
+ * (`placementFetch`, `fetchContextualChips`, …).
+ *
+ * Each call loads cached tokens before the request, then saves the (possibly
+ * refreshed) tokens after the response headers arrive — we deliberately do NOT
+ * wait for the streaming body; the SDK's refresh runs alongside the stream and
+ * the saved tokens benefit subsequent calls.
+ */
+function createWixAuthFetch(clientId) {
+  if (!clientId) {
+    throw new Error('[web5-core] createWixAuthFetch: clientId is empty');
+  }
+  const client = (0, _sdk.createClient)({
+    auth: (0, _sdk.OAuthStrategy)({
+      clientId
+    })
+  });
+  return async (input, init) => {
+    loadTokens(client, clientId);
+    const res = await client.fetchWithAuth(input, init);
+    saveTokens(client, clientId);
+    return res;
+  };
+}
+//# sourceMappingURL=wixAuthFetch.js.map

package/dist/cjs/client/wixAuthFetch.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_sdk","require","TOKEN_CACHE_KEY_PREFIX","tokenKey","clientId","loadTokens","client","raw","localStorage","getItem","auth","setTokens","JSON","parse","removeItem","saveTokens","setItem","stringify","getTokens","createWixAuthFetch","Error","createClient","OAuthStrategy","input","init","res","fetchWithAuth"],"sources":["../../../src/client/wixAuthFetch.ts"],"sourcesContent":["/**\n * Wix-authenticated `fetch` for Web5 BE calls from a host (third-party) origin.\n *\n * `wixapis.com`'s `/wix-assistant-web5/v1/conversation` endpoint refuses\n * cross-origin anonymous calls (HTTP 500) — the only auth path that survives\n * CORS from a host (e.g. Shopify) origin is `@wix/sdk`'s `OAuthStrategy`, which\n * supplies the `Authorization` header the BE allowlists.\n *\n * Shared by every embed bundle that talks to the conversation endpoint — the\n * placement bundle and the input-widget chip generator — so they all attach\n * the same token. Token caching uses the same `localStorage` key format\n * (`web5_tokens_<clientId>`) as `web50-server-ui`'s token cache, so the loader,\n * full app, placement, and input widget share one OAuth token instead of each\n * burning a `/oauth2/token` round-trip per page load.\n */\nimport { createClient, OAuthStrategy } from '@wix/sdk';\n\nconst TOKEN_CACHE_KEY_PREFIX = 'web5_tokens_';\n\ninterface SdkClient {\n  fetchWithAuth: typeof fetch;\n  auth: {\n    setTokens: (tokens: unknown) => void;\n    getTokens: () => unknown;\n  };\n}\n\nfunction tokenKey(clientId: string): string {\n  return `${TOKEN_CACHE_KEY_PREFIX}${clientId}`;\n}\n\nfunction loadTokens(client: SdkClient, clientId: string): void {\n  try {\n    const raw = localStorage.getItem(tokenKey(clientId));\n    if (!raw) return;\n    client.auth.setTokens(JSON.parse(raw));\n  } catch {\n    try {\n      localStorage.removeItem(tokenKey(clientId));\n    } catch {\n      /* ignore */\n    }\n  }\n}\n\nfunction saveTokens(client: SdkClient, clientId: string): void {\n  try {\n    localStorage.setItem(\n      tokenKey(clientId),\n      JSON.stringify(client.auth.getTokens()),\n    );\n  } catch {\n    // privacy mode / quota — in-memory token still works for this session\n  }\n}\n\n/**\n * Build a `fetch`-shaped function pre-bound to the given Wix client id. The\n * returned value is drop-in compatible with any `fetchImpl` option\n * (`placementFetch`, `fetchContextualChips`, …).\n *\n * Each call loads cached tokens before the request, then saves the (possibly\n * refreshed) tokens after the response headers arrive — we deliberately do NOT\n * wait for the streaming body; the SDK's refresh runs alongside the stream and\n * the saved tokens benefit subsequent calls.\n */\nexport function createWixAuthFetch(clientId: string): typeof fetch {\n  if (!clientId) {\n    throw new Error('[web5-core] createWixAuthFetch: clientId is empty');\n  }\n  const client = createClient({\n    auth: OAuthStrategy({ clientId }),\n  }) as unknown as SdkClient;\n\n  return (async (input: RequestInfo | URL, init?: RequestInit) => {\n    loadTokens(client, clientId);\n    const res = await client.fetchWithAuth(input, init);\n    saveTokens(client, clientId);\n    return res;\n  }) as typeof fetch;\n}\n"],"mappings":";;;;AAeA,IAAAA,IAAA,GAAAC,OAAA;AAfA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,MAAMC,sBAAsB,GAAG,cAAc;AAU7C,SAASC,QAAQA,CAACC,QAAgB,EAAU;EAC1C,OAAO,GAAGF,sBAAsB,GAAGE,QAAQ,EAAE;AAC/C;AAEA,SAASC,UAAUA,CAACC,MAAiB,EAAEF,QAAgB,EAAQ;EAC7D,IAAI;IACF,MAAMG,GAAG,GAAGC,YAAY,CAACC,OAAO,CAACN,QAAQ,CAACC,QAAQ,CAAC,CAAC;IACpD,IAAI,CAACG,GAAG,EAAE;IACVD,MAAM,CAACI,IAAI,CAACC,SAAS,CAACC,IAAI,CAACC,KAAK,CAACN,GAAG,CAAC,CAAC;EACxC,CAAC,CAAC,MAAM;IACN,IAAI;MACFC,YAAY,CAACM,UAAU,CAACX,QAAQ,CAACC,QAAQ,CAAC,CAAC;IAC7C,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ;AACF;AAEA,SAASW,UAAUA,CAACT,MAAiB,EAAEF,QAAgB,EAAQ;EAC7D,IAAI;IACFI,YAAY,CAACQ,OAAO,CAClBb,QAAQ,CAACC,QAAQ,CAAC,EAClBQ,IAAI,CAACK,SAAS,CAACX,MAAM,CAACI,IAAI,CAACQ,SAAS,CAAC,CAAC,CACxC,CAAC;EACH,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,kBAAkBA,CAACf,QAAgB,EAAgB;EACjE,IAAI,CAACA,QAAQ,EAAE;IACb,MAAM,IAAIgB,KAAK,CAAC,mDAAmD,CAAC;EACtE;EACA,MAAMd,MAAM,GAAG,IAAAe,iBAAY,EAAC;IAC1BX,IAAI,EAAE,IAAAY,kBAAa,EAAC;MAAElB;IAAS,CAAC;EAClC,CAAC,CAAyB;EAE1B,OAAQ,OAAOmB,KAAwB,EAAEC,IAAkB,KAAK;IAC9DnB,UAAU,CAACC,MAAM,EAAEF,QAAQ,CAAC;IAC5B,MAAMqB,GAAG,GAAG,MAAMnB,MAAM,CAACoB,aAAa,CAACH,KAAK,EAAEC,IAAI,CAAC;IACnDT,UAAU,CAACT,MAAM,EAAEF,QAAQ,CAAC;IAC5B,OAAOqB,GAAG;EACZ,CAAC;AACH","ignoreList":[]}

package/dist/cjs/clients.js

@@ -0,0 +1,15 @@
+"use strict";
+
+exports.__esModule = true;
+exports.EXPERIMENT_IDS = exports.CLIENT_IDS = void 0;
+const CLIENT_IDS = exports.CLIENT_IDS = {
+  CIRCANA_DEMO: '9efd0d80-5661-4497-8267-76a2bb075d80',
+  CIRCANA_PROD: '976944ca-fead-4d31-94db-2b3ac4c55ad5',
+  FEATURE_COM: '9ed0cd73-31e2-48f6-83cd-df96267a8471'
+};
+
+/** Petri / Conductor experiment IDs evaluated in the `web5-embed` scope. */
+const EXPERIMENT_IDS = exports.EXPERIMENT_IDS = {
+  WEB5_CUSTOM: 'web5Custom'
+};
+//# sourceMappingURL=clients.js.map

package/dist/cjs/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CLIENT_IDS","exports","CIRCANA_DEMO","CIRCANA_PROD","FEATURE_COM","EXPERIMENT_IDS","WEB5_CUSTOM"],"sources":["../../src/clients.ts"],"sourcesContent":["export const CLIENT_IDS = {\n  CIRCANA_DEMO: '9efd0d80-5661-4497-8267-76a2bb075d80',\n  CIRCANA_PROD: '976944ca-fead-4d31-94db-2b3ac4c55ad5',\n  FEATURE_COM: '9ed0cd73-31e2-48f6-83cd-df96267a8471',\n} as const;\n\n/** Petri / Conductor experiment IDs evaluated in the `web5-embed` scope. */\nexport const EXPERIMENT_IDS = {\n  WEB5_CUSTOM: 'web5Custom',\n} as const;\n"],"mappings":";;;;AAAO,MAAMA,UAAU,GAAAC,OAAA,CAAAD,UAAA,GAAG;EACxBE,YAAY,EAAE,sCAAsC;EACpDC,YAAY,EAAE,sCAAsC;EACpDC,WAAW,EAAE;AACf,CAAU;;AAEV;AACO,MAAMC,cAAc,GAAAJ,OAAA,CAAAI,cAAA,GAAG;EAC5BC,WAAW,EAAE;AACf,CAAU","ignoreList":[]}

package/dist/cjs/color/colorUtils.js

@@ -0,0 +1,126 @@
+"use strict";
+
+exports.__esModule = true;
+exports.deriveDarkColor = deriveDarkColor;
+exports.deriveDarkGradient = deriveDarkGradient;
+exports.deriveLightColor = deriveLightColor;
+exports.ensureMinLightness = ensureMinLightness;
+exports.hslToRgb = hslToRgb;
+exports.rgbToHsl = rgbToHsl;
+exports.toRgb = toRgb;
+function rgbToHsl([r, g, b]) {
+  r /= 255;
+  g /= 255;
+  b /= 255;
+  const max = Math.max(r, g, b),
+    min = Math.min(r, g, b);
+  let h = 0,
+    s = 0;
+  const l = (max + min) / 2;
+  if (max !== min) {
+    const d = max - min;
+    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    if (max === r) {
+      h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+    } else if (max === g) {
+      h = ((b - r) / d + 2) / 6;
+    } else {
+      h = ((r - g) / d + 4) / 6;
+    }
+  }
+  return [h * 360, s * 100, l * 100];
+}
+function hslToRgb([h, s, l]) {
+  h /= 360;
+  s /= 100;
+  l /= 100;
+  if (s === 0) {
+    const v = Math.round(l * 255);
+    return [v, v, v];
+  }
+  const hue2rgb = (p, q, t) => {
+    if (t < 0) {
+      t += 1;
+    }
+    if (t > 1) {
+      t -= 1;
+    }
+    if (t < 1 / 6) {
+      return p + (q - p) * 6 * t;
+    }
+    if (t < 1 / 2) {
+      return q;
+    }
+    if (t < 2 / 3) {
+      return p + (q - p) * (2 / 3 - t) * 6;
+    }
+    return p;
+  };
+  const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+  const p = 2 * l - q;
+  return [Math.round(hue2rgb(p, q, h + 1 / 3) * 255), Math.round(hue2rgb(p, q, h) * 255), Math.round(hue2rgb(p, q, h - 1 / 3) * 255)];
+}
+function ensureMinLightness(rgb, minL) {
+  const [h, s, l] = rgbToHsl(rgb);
+  if (l >= minL) {
+    return rgb;
+  }
+  return hslToRgb([h, s, minL]);
+}
+function toRgb(c) {
+  return `rgb(${c[0]}, ${c[1]}, ${c[2]})`;
+}
+function deriveDarkColor(palette, minDarkness) {
+  if (!palette.length) {
+    return [0, 0, 0];
+  }
+  let darkest = palette[0];
+  let lowestL = rgbToHsl(palette[0])[2];
+  for (let i = 1; i < palette.length; i++) {
+    const l = rgbToHsl(palette[i])[2];
+    if (l < lowestL) {
+      lowestL = l;
+      darkest = palette[i];
+    }
+  }
+  const [h, s, l] = rgbToHsl(darkest);
+  const maxLightness = 100 - minDarkness;
+  if (l <= maxLightness) {
+    return darkest;
+  }
+  return hslToRgb([h, s, maxLightness]);
+}
+function deriveDarkGradient(palette, minDarkness) {
+  if (!palette.length) {
+    return ['rgb(0, 0, 0)', 'rgb(0, 0, 0)'];
+  }
+  const sorted = [...palette].sort((a, b) => rgbToHsl(a)[2] - rgbToHsl(b)[2]);
+  const maxLightness = 100 - minDarkness;
+  const enforce = rgb => {
+    const [h, s, l] = rgbToHsl(rgb);
+    return l <= maxLightness ? rgb : hslToRgb([h, s, maxLightness]);
+  };
+  const stop1 = enforce(sorted[0]);
+  const stop2 = enforce(sorted.length > 1 ? sorted[1] : sorted[0]);
+  return [toRgb(stop1), toRgb(stop2)];
+}
+function deriveLightColor(palette, minLightness) {
+  if (!palette.length) {
+    return [240, 240, 240];
+  }
+  let lightest = palette[0];
+  let highestL = rgbToHsl(palette[0])[2];
+  for (let i = 1; i < palette.length; i++) {
+    const l = rgbToHsl(palette[i])[2];
+    if (l > highestL) {
+      highestL = l;
+      lightest = palette[i];
+    }
+  }
+  const [h, s, l] = rgbToHsl(lightest);
+  if (l >= minLightness) {
+    return lightest;
+  }
+  return hslToRgb([h, s, minLightness]);
+}
+//# sourceMappingURL=colorUtils.js.map

package/dist/cjs/color/colorUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["rgbToHsl","r","g","b","max","Math","min","h","s","l","d","hslToRgb","v","round","hue2rgb","p","q","t","ensureMinLightness","rgb","minL","toRgb","c","deriveDarkColor","palette","minDarkness","length","darkest","lowestL","i","maxLightness","deriveDarkGradient","sorted","sort","a","enforce","stop1","stop2","deriveLightColor","minLightness","lightest","highestL"],"sources":["../../../src/color/colorUtils.ts"],"sourcesContent":["export type RGB = [number, number, number];\n\nexport function rgbToHsl([r, g, b]: RGB): [number, number, number] {\n  r /= 255;\n  g /= 255;\n  b /= 255;\n  const max = Math.max(r, g, b),\n    min = Math.min(r, g, b);\n  let h = 0,\n    s = 0;\n  const l = (max + min) / 2;\n  if (max !== min) {\n    const d = max - min;\n    s = l > 0.5 ? d / (2 - max - min) : d / (max + min);\n    if (max === r) {\n      h = ((g - b) / d + (g < b ? 6 : 0)) / 6;\n    } else if (max === g) {\n      h = ((b - r) / d + 2) / 6;\n    } else {\n      h = ((r - g) / d + 4) / 6;\n    }\n  }\n  return [h * 360, s * 100, l * 100];\n}\n\nexport function hslToRgb([h, s, l]: [number, number, number]): RGB {\n  h /= 360;\n  s /= 100;\n  l /= 100;\n  if (s === 0) {\n    const v = Math.round(l * 255);\n    return [v, v, v];\n  }\n  const hue2rgb = (p: number, q: number, t: number) => {\n    if (t < 0) {\n      t += 1;\n    }\n    if (t > 1) {\n      t -= 1;\n    }\n    if (t < 1 / 6) {\n      return p + (q - p) * 6 * t;\n    }\n    if (t < 1 / 2) {\n      return q;\n    }\n    if (t < 2 / 3) {\n      return p + (q - p) * (2 / 3 - t) * 6;\n    }\n    return p;\n  };\n  const q = l < 0.5 ? l * (1 + s) : l + s - l * s;\n  const p = 2 * l - q;\n  return [\n    Math.round(hue2rgb(p, q, h + 1 / 3) * 255),\n    Math.round(hue2rgb(p, q, h) * 255),\n    Math.round(hue2rgb(p, q, h - 1 / 3) * 255),\n  ];\n}\n\nexport function ensureMinLightness(rgb: RGB, minL: number): RGB {\n  const [h, s, l] = rgbToHsl(rgb);\n  if (l >= minL) {\n    return rgb;\n  }\n  return hslToRgb([h, s, minL]);\n}\n\nexport function toRgb(c: RGB): string {\n  return `rgb(${c[0]}, ${c[1]}, ${c[2]})`;\n}\n\nexport function deriveDarkColor(palette: RGB[], minDarkness: number): RGB {\n  if (!palette.length) {\n    return [0, 0, 0];\n  }\n  let darkest = palette[0];\n  let lowestL = rgbToHsl(palette[0])[2];\n  for (let i = 1; i < palette.length; i++) {\n    const l = rgbToHsl(palette[i])[2];\n    if (l < lowestL) {\n      lowestL = l;\n      darkest = palette[i];\n    }\n  }\n  const [h, s, l] = rgbToHsl(darkest);\n  const maxLightness = 100 - minDarkness;\n  if (l <= maxLightness) {\n    return darkest;\n  }\n  return hslToRgb([h, s, maxLightness]);\n}\n\nexport function deriveDarkGradient(\n  palette: RGB[],\n  minDarkness: number,\n): [string, string] {\n  if (!palette.length) {\n    return ['rgb(0, 0, 0)', 'rgb(0, 0, 0)'];\n  }\n\n  const sorted = [...palette].sort((a, b) => rgbToHsl(a)[2] - rgbToHsl(b)[2]);\n\n  const maxLightness = 100 - minDarkness;\n\n  const enforce = (rgb: RGB): RGB => {\n    const [h, s, l] = rgbToHsl(rgb);\n    return l <= maxLightness ? rgb : hslToRgb([h, s, maxLightness]);\n  };\n\n  const stop1 = enforce(sorted[0]);\n  const stop2 = enforce(sorted.length > 1 ? sorted[1] : sorted[0]);\n\n  return [toRgb(stop1), toRgb(stop2)];\n}\n\nexport function deriveLightColor(palette: RGB[], minLightness: number): RGB {\n  if (!palette.length) {\n    return [240, 240, 240];\n  }\n  let lightest = palette[0];\n  let highestL = rgbToHsl(palette[0])[2];\n  for (let i = 1; i < palette.length; i++) {\n    const l = rgbToHsl(palette[i])[2];\n    if (l > highestL) {\n      highestL = l;\n      lightest = palette[i];\n    }\n  }\n  const [h, s, l] = rgbToHsl(lightest);\n  if (l >= minLightness) {\n    return lightest;\n  }\n  return hslToRgb([h, s, minLightness]);\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/cjs/component/componentDefinitions/CalloutSectionDefinition.js

@@ -0,0 +1,67 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.CalloutSectionDefinition = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _parseUtils = require("./parse-utils");
+var _parts = require("../../parts/parts");
+class CalloutSectionDefinition {
+  constructor() {
+    (0, _defineProperty2.default)(this, "sectionType", 'callout');
+    (0, _defineProperty2.default)(this, "patterns", ['html_comment? > callout+']);
+    (0, _defineProperty2.default)(this, "defaults", {
+      callouts: [{
+        text: 'This is a callout.'
+      }]
+    });
+    (0, _defineProperty2.default)(this, "fixtures", [{
+      markdown: '> This is a callout blockquote.',
+      expected: {
+        callouts: [{
+          text: 'This is a callout blockquote.'
+        }]
+      }
+    }]);
+  }
+  parse(parts) {
+    const callouts = [];
+    const relatedLinks = [];
+    const seenUrls = new Set();
+    const calloutParts = (0, _parts.getPartsByType)(parts, 'callout');
+    for (const c of calloutParts) {
+      var _c$meta, _c$content;
+      const text = ((_c$meta = c.meta) == null || (_c$meta = _c$meta.markdown) == null ? void 0 : _c$meta.trim()) || ((_c$content = c.content) == null ? void 0 : _c$content.trim());
+      if (text) {
+        const parsed = (0, _parseUtils.parseCalloutTag)(text);
+        if (parsed.text) {
+          callouts.push({
+            text: parsed.text,
+            kind: parsed.kind
+          });
+        }
+      }
+    }
+
+    // Extract links from all parts
+    const links = (0, _parts.getLinks)(parts);
+    for (const link of links) {
+      var _link$meta, _link$content;
+      const href = (_link$meta = link.meta) == null ? void 0 : _link$meta.href;
+      const text = (_link$content = link.content) == null ? void 0 : _link$content.trim();
+      if (text && href && !seenUrls.has(href)) {
+        seenUrls.add(href);
+        relatedLinks.push({
+          text,
+          url: href
+        });
+      }
+    }
+    return {
+      callouts,
+      relatedLinks: relatedLinks.length > 0 ? relatedLinks : undefined
+    };
+  }
+}
+exports.CalloutSectionDefinition = CalloutSectionDefinition;
+//# sourceMappingURL=CalloutSectionDefinition.js.map

package/dist/cjs/component/componentDefinitions/CalloutSectionDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_parseUtils","require","_parts","CalloutSectionDefinition","constructor","_defineProperty2","default","callouts","text","markdown","expected","parse","parts","relatedLinks","seenUrls","Set","calloutParts","getPartsByType","c","_c$meta","_c$content","meta","trim","content","parsed","parseCalloutTag","push","kind","links","getLinks","link","_link$meta","_link$content","href","has","add","url","length","undefined","exports"],"sources":["../../../../src/component/componentDefinitions/CalloutSectionDefinition.ts"],"sourcesContent":["import { parseCalloutTag } from './parse-utils';\nimport { getPartsByType, getLinks, type Part } from '../../parts/parts';\nimport type { Callout } from '../../types/callout';\nimport type {\n  CalloutCompProps,\n  CalloutSectionComponent,\n  SectionFixture,\n} from '../types';\nimport type { SectionDefinition } from '../section-definition';\n\nexport class CalloutSectionDefinition\n  implements SectionDefinition<CalloutSectionComponent>\n{\n  sectionType = 'callout' as const;\n  patterns = ['html_comment? > callout+'];\n\n  defaults: CalloutCompProps = {\n    callouts: [{ text: 'This is a callout.' }],\n  };\n\n  fixtures: SectionFixture<CalloutCompProps>[] = [\n    {\n      markdown: '> This is a callout blockquote.',\n      expected: {\n        callouts: [{ text: 'This is a callout blockquote.' }],\n      },\n    },\n  ];\n\n  parse(parts: Part[]): CalloutCompProps {\n    const callouts: Callout[] = [];\n    const relatedLinks: { text: string; url: string }[] = [];\n    const seenUrls = new Set<string>();\n\n    const calloutParts = getPartsByType<Part>(parts, 'callout');\n    for (const c of calloutParts) {\n      const text = (c.meta?.markdown as string)?.trim() || c.content?.trim();\n      if (text) {\n        const parsed = parseCalloutTag(text);\n        if (parsed.text) {\n          callouts.push({ text: parsed.text, kind: parsed.kind });\n        }\n      }\n    }\n\n    // Extract links from all parts\n    const links = getLinks(parts);\n    for (const link of links) {\n      const href = link.meta?.href;\n      const text = link.content?.trim();\n      if (text && href && !seenUrls.has(href)) {\n        seenUrls.add(href);\n        relatedLinks.push({ text, url: href });\n      }\n    }\n\n    return {\n      callouts,\n      relatedLinks: relatedLinks.length > 0 ? relatedLinks : undefined,\n    };\n  }\n}\n"],"mappings":";;;;;;AAAA,IAAAA,WAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AASO,MAAME,wBAAwB,CAErC;EAAAC,YAAA;IAAA,IAAAC,gBAAA,CAAAC,OAAA,uBACgB,SAAS;IAAA,IAAAD,gBAAA,CAAAC,OAAA,oBACZ,CAAC,0BAA0B,CAAC;IAAA,IAAAD,gBAAA,CAAAC,OAAA,oBAEV;MAC3BC,QAAQ,EAAE,CAAC;QAAEC,IAAI,EAAE;MAAqB,CAAC;IAC3C,CAAC;IAAA,IAAAH,gBAAA,CAAAC,OAAA,oBAE8C,CAC7C;MACEG,QAAQ,EAAE,iCAAiC;MAC3CC,QAAQ,EAAE;QACRH,QAAQ,EAAE,CAAC;UAAEC,IAAI,EAAE;QAAgC,CAAC;MACtD;IACF,CAAC,CACF;EAAA;EAEDG,KAAKA,CAACC,KAAa,EAAoB;IACrC,MAAML,QAAmB,GAAG,EAAE;IAC9B,MAAMM,YAA6C,GAAG,EAAE;IACxD,MAAMC,QAAQ,GAAG,IAAIC,GAAG,CAAS,CAAC;IAElC,MAAMC,YAAY,GAAG,IAAAC,qBAAc,EAAOL,KAAK,EAAE,SAAS,CAAC;IAC3D,KAAK,MAAMM,CAAC,IAAIF,YAAY,EAAE;MAAA,IAAAG,OAAA,EAAAC,UAAA;MAC5B,MAAMZ,IAAI,GAAG,EAAAW,OAAA,GAACD,CAAC,CAACG,IAAI,cAAAF,OAAA,GAANA,OAAA,CAAQV,QAAQ,qBAAjBU,OAAA,CAA8BG,IAAI,CAAC,CAAC,OAAAF,UAAA,GAAIF,CAAC,CAACK,OAAO,qBAATH,UAAA,CAAWE,IAAI,CAAC,CAAC;MACtE,IAAId,IAAI,EAAE;QACR,MAAMgB,MAAM,GAAG,IAAAC,2BAAe,EAACjB,IAAI,CAAC;QACpC,IAAIgB,MAAM,CAAChB,IAAI,EAAE;UACfD,QAAQ,CAACmB,IAAI,CAAC;YAAElB,IAAI,EAAEgB,MAAM,CAAChB,IAAI;YAAEmB,IAAI,EAAEH,MAAM,CAACG;UAAK,CAAC,CAAC;QACzD;MACF;IACF;;IAEA;IACA,MAAMC,KAAK,GAAG,IAAAC,eAAQ,EAACjB,KAAK,CAAC;IAC7B,KAAK,MAAMkB,IAAI,IAAIF,KAAK,EAAE;MAAA,IAAAG,UAAA,EAAAC,aAAA;MACxB,MAAMC,IAAI,IAAAF,UAAA,GAAGD,IAAI,CAACT,IAAI,qBAATU,UAAA,CAAWE,IAAI;MAC5B,MAAMzB,IAAI,IAAAwB,aAAA,GAAGF,IAAI,CAACP,OAAO,qBAAZS,aAAA,CAAcV,IAAI,CAAC,CAAC;MACjC,IAAId,IAAI,IAAIyB,IAAI,IAAI,CAACnB,QAAQ,CAACoB,GAAG,CAACD,IAAI,CAAC,EAAE;QACvCnB,QAAQ,CAACqB,GAAG,CAACF,IAAI,CAAC;QAClBpB,YAAY,CAACa,IAAI,CAAC;UAAElB,IAAI;UAAE4B,GAAG,EAAEH;QAAK,CAAC,CAAC;MACxC;IACF;IAEA,OAAO;MACL1B,QAAQ;MACRM,YAAY,EAAEA,YAAY,CAACwB,MAAM,GAAG,CAAC,GAAGxB,YAAY,GAAGyB;IACzD,CAAC;EACH;AACF;AAACC,OAAA,CAAApC,wBAAA,GAAAA,wBAAA","ignoreList":[]}

package/dist/cjs/component/componentDefinitions/ComparisonSectionDefinition.js

@@ -0,0 +1,141 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.ComparisonSectionDefinition = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _parseUtils = require("./parse-utils");
+var _parts = require("../../parts/parts");
+var _diagnosticTypes = require("../diagnosticTypes");
+class ComparisonSectionDefinition {
+  constructor() {
+    (0, _defineProperty2.default)(this, "sectionType", 'comparison');
+    (0, _defineProperty2.default)(this, "patterns", ['html_comment[section^="comparison"] > (h2 | h3 | h4 | t) > html_comment? > t* > table > (t | link)?']);
+    (0, _defineProperty2.default)(this, "defaults", {
+      title: 'Comparison',
+      columnLabels: ['Option A', 'Option B'],
+      rows: [{
+        feature: 'Price',
+        values: ['$10', '$20']
+      }, {
+        feature: 'Storage',
+        values: ['100GB', '1TB']
+      }]
+    });
+    (0, _defineProperty2.default)(this, "fixtures", [{
+      markdown: `<!-- section: comparison -->
+## Compare Plans
+
+| Feature | Basic | Pro |
+|---------|-------|-----|
+| Users | 5 | Unlimited |
+| Storage | 100GB | 1TB |`,
+      expected: {
+        title: 'Compare Plans',
+        featureColumnLabel: 'Feature',
+        columnLabels: ['Basic', 'Pro'],
+        rows: [{
+          feature: 'Users',
+          values: ['5', 'Unlimited']
+        }, {
+          feature: 'Storage',
+          values: ['100GB', '1TB']
+        }]
+      }
+    }, {
+      markdown: `<!-- section: comparison -->
+## Platform Comparison
+
+See how our platform stacks up against the competition.
+
+| Feature | Our Platform | Competitor |
+|---------|--------------|------------|
+| Storage | 1TB | 100GB |
+| Users | Unlimited | 5 |
+| Support | 24/7 Priority | Email Only |
+
+[Get started](#signup)`,
+      expected: {
+        title: 'Platform Comparison',
+        description: 'See how our platform stacks up against the competition.',
+        featureColumnLabel: 'Feature',
+        columnLabels: ['Our Platform', 'Competitor'],
+        rows: [{
+          feature: 'Storage',
+          values: ['1TB', '100GB']
+        }, {
+          feature: 'Users',
+          values: ['Unlimited', '5']
+        }, {
+          feature: 'Support',
+          values: ['24/7 Priority', 'Email Only']
+        }],
+        ctaText: 'Get started',
+        ctaHref: '#signup'
+      }
+    }]);
+  }
+  parse(parts, context) {
+    var _tableParts$;
+    const title = (0, _parseUtils.headingText)(parts, 2) || (0, _parseUtils.headingText)(parts, 3) || (0, _parseUtils.headingText)(parts, 4) || 'Comparison';
+    const description = (0, _parseUtils.bodyText)(parts) || undefined;
+
+    // Table meta from nodesToParts: { columnLabels, featureColumnLabel, rows: { feature, values }[] }
+    const tableParts = (0, _parts.getPartsByType)(parts, 'table');
+    const tableMeta = (_tableParts$ = tableParts[0]) == null ? void 0 : _tableParts$.meta;
+    let columnLabels;
+    let columns;
+    let featureColumnLabel;
+    let rows;
+    if ((tableMeta == null ? void 0 : tableMeta.columnLabels) !== undefined) {
+      // SDK nodesToParts format
+      columnLabels = tableMeta.columnLabels;
+      columns = tableMeta.columns;
+      featureColumnLabel = tableMeta.featureColumnLabel || undefined;
+      rows = (tableMeta.rows ?? []).map(row => ({
+        feature: row.feature,
+        ...(row.iconHint ? {
+          iconHint: row.iconHint
+        } : {}),
+        values: row.values.map(_parseUtils.parseTableValue)
+      }));
+    } else {
+      // Legacy partsConverter format: { headers: string[], rows: string[][] }
+      const allHeaders = (tableMeta == null ? void 0 : tableMeta.headers) ?? [];
+      const rawRows = (tableMeta == null ? void 0 : tableMeta.rows) ?? [];
+      featureColumnLabel = allHeaders[0] || undefined;
+      columnLabels = allHeaders.slice(1);
+      columns = columnLabels.map(label => ({
+        label
+      }));
+      rows = rawRows.map(row => ({
+        feature: row[0] ?? '',
+        values: row.slice(1).map(_parseUtils.parseTableValue)
+      }));
+    }
+
+    // Extract CTA from link parts
+    const link = (0, _parseUtils.firstLink)(parts);
+    const ctaText = (link == null ? void 0 : link.text) || undefined;
+    const ctaHref = (link == null ? void 0 : link.href) || undefined;
+
+    // Filter out rows where all values are empty (e.g. trailing non-table text parsed as a row)
+    const filteredRows = rows.filter(row => row.values.some(v => v !== ''));
+    const droppedCount = rows.length - filteredRows.length;
+    if (droppedCount > 0) {
+      context == null || context.reportDiagnostic == null || context.reportDiagnostic(_diagnosticTypes.DIAGNOSTIC_TYPES.ITEMS_DROPPED, `comparison: ${droppedCount} row(s) dropped (all values empty)`);
+    }
+    return {
+      title,
+      description,
+      columnLabels,
+      columns,
+      rows: filteredRows,
+      featureColumnLabel,
+      ctaText,
+      ctaHref
+    };
+  }
+}
+exports.ComparisonSectionDefinition = ComparisonSectionDefinition;
+//# sourceMappingURL=ComparisonSectionDefinition.js.map