@flamingo-stack/openframe-frontend-core 0.0.204 → 0.0.205

package/dist/components/chat/utils/chat-nav-resolution.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Embed-mode navigation resolver + shared click-handling primitives.
+ *
+ * Used by the lib chat panel's chip + card click handlers to force
+ * new-tab + absolutize against the embedder-supplied content origin.
+ *
+ * Refactor from hub origin (D5): inferTargetPlatformFromHref +
+ * getPlatformDomain dropped. Caller threads `targetPlatform` directly.
+ * Relative URLs without a defaultContentOrigin emit a dev warning
+ * and resolve against window.location.origin (likely wrong in embed
+ * mode; embedder should set defaultContentOrigin).
+ */
+import type { ChatRuntime } from '../../../contexts/chat-runtime-context';
+/** Arguments accepted by `window.open` for a new tab — keep `noopener`
+ *  + `noreferrer` to prevent the opened page from accessing
+ *  window.opener (reverse-tabnabbing class). */
+export declare const NEW_TAB_FEATURES = "noopener,noreferrer";
+/** Modifier-click predicate — matches the existing useNavLink branch
+ *  (cmd/ctrl/shift/alt OR non-primary mouse button). */
+export declare function isModifierClick(e: {
+    button?: number;
+    metaKey?: boolean;
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}): boolean;
+/** Strip the origin from a same-origin absolute URL, returning a relative
+ *  path the host's router will treat as in-app navigation. Pass-through
+ *  for already-relative URLs and for cross-origin URLs. */
+export declare function stripSameOriginToPath(href: string): string;
+export interface ExternalNavResolution {
+    /** Absolutized href — relative paths are joined with
+     *  `runtime.navigation.defaultContentOrigin` (embed contract). */
+    href: string;
+    /** Synchronous opener. MUST be invoked inline from a user gesture for
+     *  popup-blocker compatibility (Safari/Firefox). Honors
+     *  runtime.navigation.openExternal override, else falls back to
+     *  window.open(href, '_blank', 'noopener,noreferrer'). */
+    open: () => void;
+}
+/**
+ * Pre-resolve an href against the embed-mode `defaultContentOrigin`.
+ *
+ * In `embed` mode every chat-rendered anchor MUST point at an absolute
+ * URL on the hub origin (not the embedder origin). Without
+ * pre-resolution, relative paths like `/knowledge-base/foo.md` render
+ * as `<a href="/knowledge-base/...">` — the click handler intercepts
+ * primary-button clicks correctly, but modifier-click (cmd/ctrl/middle/
+ * right) bypasses the handler and opens `<embedder-origin>/...` → 404.
+ * Pre-resolution at render time makes every browser-native navigation
+ * path (hover preview, status bar, copy-link, new-tab via modifier)
+ * land on the hub correctly.
+ *
+ * In `host` mode (the hub itself) the href is returned unchanged —
+ * relative paths resolve naturally against the hub's own origin.
+ *
+ * Absolute URLs and protocol-relative URLs are returned unchanged in
+ * both modes.
+ */
+export declare function resolveHrefForRuntime(href: string, runtime: ChatRuntime): string;
+/**
+ * Resolve external navigation in embed mode.
+ *
+ * Browser-only: called from React event handlers (onClick, imperative
+ * click handlers) after mount. No SSR-reachable paths.
+ */
+export declare function resolveExternalNavigation(args: {
+    href: string;
+    targetPlatform: string | null | undefined;
+    runtime: ChatRuntime;
+}): ExternalNavResolution;
+//# sourceMappingURL=chat-nav-resolution.d.ts.map

package/dist/components/chat/utils/chat-nav-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-nav-resolution.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/chat-nav-resolution.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AAEzE;;gDAEgD;AAChD,eAAO,MAAM,gBAAgB,wBAAwB,CAAA;AAErD;wDACwD;AACxD,wBAAgB,eAAe,CAAC,CAAC,EAAE;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,GAAG,OAAO,CAQV;AAED;;2DAE2D;AAC3D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED,MAAM,WAAW,qBAAqB;IACpC;sEACkE;IAClE,IAAI,EAAE,MAAM,CAAA;IACZ;;;8DAG0D;IAC1D,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,GACnB,MAAM,CAOR;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACzC,OAAO,EAAE,WAAW,CAAA;CACrB,GAAG,qBAAqB,CA6CxB"}

package/dist/components/chat/utils/chat-proxy-auth-storage.d.ts

@@ -0,0 +1,43 @@
+export interface ChatProxyAuth {
+    secret: string;
+    email: string;
+    /** Optional identity passthrough — empty/omitted = not sent. Server
+     *  parses these as `X-Chat-{First,Last}-Name` / `X-Chat-Avatar-Url` and
+     *  threads them through `resolveChatProxyIdentity`'s returned user. */
+    firstName?: string;
+    lastName?: string;
+    avatarUrl?: string;
+}
+/**
+ * Returns full credentials (secret + email + optional identity passthrough)
+ * when secret + email are available in localStorage. Survives page reloads.
+ * Returns `null` when nothing is saved — callers treat that as "fall back
+ * to cookie auth".
+ */
+export declare function getChatProxyAuth(): ChatProxyAuth | null;
+/**
+ * Returns the LAST email the admin saved. The bar reads this to pre-fill
+ * the email field on mount.
+ */
+export declare function getPersistedProxyEmail(): string | null;
+/** Save the proxy creds to localStorage. Secret + email are required;
+ *  identity-passthrough fields are persisted only when non-empty. */
+export declare function setChatProxyAuth(value: ChatProxyAuth): void;
+/** Drop the persisted creds. */
+export declare function clearChatProxyAuth(): void;
+/**
+ * Apply the chat-proxy auth (Bearer + X-Chat-Act-As) to a fetch call's
+ * URL + headers. Used by every chat-side route that needs to identify
+ * itself as the proxied customer (the docs chat stream AND every
+ * confirm-tool / agent-* route the chat shell calls afterwards). When
+ * proxy auth is absent (regular cookie-session users), returns the
+ * inputs unchanged so the cookie-auth path still works.
+ *
+ * `X-Chat-Act-As` header (vs a URL query param) keeps PII out of
+ * access logs, Sentry breadcrumbs, browser history, and CDN analytics.
+ */
+export declare function applyProxyAuth(url: string, baseHeaders?: Record<string, string>): {
+    url: string;
+    headers: Record<string, string>;
+};
+//# sourceMappingURL=chat-proxy-auth-storage.d.ts.map

package/dist/components/chat/utils/chat-proxy-auth-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-proxy-auth-storage.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/chat-proxy-auth-storage.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb;;2EAEuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAuCD;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAUvD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAGtD;AAED;qEACqE;AACrE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAQ3D;AAED,gCAAgC;AAChC,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAA0C,GAC3E;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAelD"}

package/dist/components/chat/utils/chip-action-class.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Single CSS string for chip-density action buttons (Recent / Search /
+ * Find / Display, plus the inline Display popover's submit / cancel
+ * buttons).
+ *
+ * Shared between the empty-state chip's action row and the
+ * `<DisplayChipAction>` popover so both render with byte-equivalent
+ * styling — no per-call ad-hoc Tailwind chain that drifts over time.
+ *
+ * Sizing intent: 11px font + tight `px-2 py-1` padding lands below UI-Kit
+ * `Button size="small"` (24-32px min-height). These are chip-density
+ * action buttons, not standard buttons — they sit inside the empty-state
+ * chip card's tertiary action row.
+ */
+export declare const CHIP_ACTION_BUTTON_CLASS: string;
+//# sourceMappingURL=chip-action-class.d.ts.map

package/dist/components/chat/utils/chip-action-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chip-action-class.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/chip-action-class.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,QAIL,CAAA"}

package/dist/components/chat/utils/chip-styles.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Shared className generator for the chat-adjacent UI family:
+ *  - **Source chips** (citation list below an assistant turn)
+ *  - **Inline entity-card pills** (within prose, marker-rendered)
+ *  - **Search-result rows** (dropdown beneath the search input)
+ *
+ * Centralising the token here means a single ODS change propagates to
+ * every surface — chip / card / dropdown row read as the same family.
+ *
+ * The `tone` arg controls the resting text color:
+ *  - `secondary` — citation chips and tertiary metadata. Muted resting.
+ *  - `primary`   — chips that ARE the subject of the sentence. Matches
+ *    body text color so the chip reads as content, not metadata.
+ *
+ * The `density` arg controls size / padding:
+ *  - `'chip'`     — inline pill (`px-2 py-0.5 text-[11px]`). Default;
+ *    used by the citation row and inline entity-card markers.
+ *  - `'list-row'` — wider, taller row (`px-3 py-2 text-sm`). Used by
+ *    the search-bar dropdown. Same ODS family — same border, hover
+ *    transition, accent treatment — just larger touch target.
+ *  - `'card-row'` — for the tracking strip beneath a card frame
+ *    (`px-2 py-1 text-[11px]` no border). Same family, no frame.
+ */
+export interface ChipClassOptions {
+    tone: 'primary' | 'secondary';
+    /** Visual density. Defaults to `'chip'`. */
+    density?: 'chip' | 'list-row' | 'card-row';
+    /** Extra classes appended verbatim (e.g. `cursor-pointer`). */
+    extra?: string;
+}
+export declare function chatChipClass({ tone, density, extra }: ChipClassOptions): string;
+//# sourceMappingURL=chip-styles.d.ts.map

package/dist/components/chat/utils/chip-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chip-styles.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/chip-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,GAAG,WAAW,CAAA;IAC7B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAA;IAC1C,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,KAAK,EAAE,EAAE,gBAAgB,GAAG,MAAM,CAmBzF"}

package/dist/components/chat/utils/clickup-task-type-utils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ClickUp custom_item_id → human-readable label resolver.
+ *
+ * Lib-side subset of the hub's `lib/utils/clickup-task-type-utils.ts`.
+ * The hub file also exports delivery / workspace slug helpers used by
+ * the sync engine; only the chat-surfaced label resolver migrates here
+ * because chat-inline cards and activity feeds need it.
+ *
+ * Reference: ClickUp's standard task types (custom_item_id values):
+ *   null/1000=Task, 1001=Milestone, 1002=Recurring, 1003=Subtask,
+ *   1004=Form, 1006=Plan, 1007=Strategy, 1008=Bug, 1009=Request,
+ *   1010=Feature, 1011=Story, 1012=Epic, 1013=Component, 1014=Initiative.
+ */
+export declare const CUSTOM_ITEM_ID: {
+    readonly TASK: 1000;
+    readonly MILESTONE: 1001;
+    readonly RECURRING: 1002;
+    readonly SUBTASK: 1003;
+    readonly FORM: 1004;
+    readonly PLAN: 1006;
+    readonly STRATEGY: 1007;
+    readonly BUG: 1008;
+    readonly REQUEST: 1009;
+    readonly FEATURE: 1010;
+    readonly STORY: 1011;
+    readonly EPIC: 1012;
+    readonly COMPONENT: 1013;
+    readonly INITIATIVE: 1014;
+};
+/**
+ * Display name for a ClickUp task type — used in chat-inline cards and
+ * activity feeds where the type badge would otherwise show a numeric ID.
+ *
+ * Returning `null` for unknown IDs lets callers fall back to a generic
+ * "Task" affordance rather than printing `task-1100` or similar.
+ */
+export declare function getTaskTypeLabel(customItemId: number | null | undefined): string | null;
+//# sourceMappingURL=clickup-task-type-utils.d.ts.map

package/dist/components/chat/utils/clickup-task-type-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickup-task-type-utils.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/clickup-task-type-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;CAejB,CAAA;AAEV;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,MAAM,GAAG,IAAI,CAkBf"}

package/dist/components/chat/utils/compact-card-classes.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Compact-card class constants — single source of truth for the chat-inline
+ * `size='sm'` card frame.
+ *
+ * Lifted from the hub's `components/shared/compact-card/compact-card-classes.ts`
+ * so the pure-presentation cards in `entity-cards/` can stop importing from
+ * the hub tree. Every compact card across the chat shell shares the SAME
+ * outer frame, skeleton frame, image slot, icon slot, text column, and
+ * per-line typography.
+ *
+ * Card-specific variation (Play overlay on podcasts, #N pill on investor
+ * updates, status badge on roadmap) lives INSIDE the card next to its
+ * other type-specific JSX; the frame stays uniform across types.
+ */
+/** Loaded compact card outer frame for INTERACTIVE state — anchor wrap
+ *  with hover/transition affordance. Use ONLY when the card resolves
+ *  to a real, safe href; the user expects a clickable feel. */
+export declare const COMPACT_CARD_OUTER = "my-1.5 flex items-start gap-3 w-full p-2 rounded-lg border border-ods-border bg-ods-card no-underline transition-colors hover:border-ods-text-secondary/40";
+/** Loaded compact card outer frame for NON-INTERACTIVE state — span wrap
+ *  used when `safeHref()` rejects the chat ref's url. */
+export declare const COMPACT_CARD_OUTER_STATIC = "my-1.5 flex items-start gap-3 w-full p-2 rounded-lg border border-ods-border bg-ods-card no-underline cursor-default";
+/** Skeleton outer frame — same dimensions as loaded, plus `animate-pulse`. */
+export declare const COMPACT_CARD_SKELETON_OUTER = "my-1.5 flex w-full animate-pulse items-start gap-3 rounded-lg border border-ods-border bg-ods-card p-2";
+/** 56×56 image slot — for cards with a cover image. */
+export declare const COMPACT_CARD_IMAGE_SLOT = "relative block shrink-0 self-start w-14 h-14 aspect-square overflow-hidden rounded-md bg-ods-bg";
+/** 56×56 placeholder slot for skeletons. */
+export declare const COMPACT_CARD_SKELETON_IMAGE_SLOT = "block h-14 w-14 aspect-square shrink-0 self-start rounded-md bg-ods-bg";
+/** 56×56 icon slot — for cards without a cover image. */
+export declare const COMPACT_CARD_ICON_SLOT = "flex h-14 w-14 aspect-square shrink-0 self-start items-center justify-center rounded-md bg-ods-bg text-ods-accent";
+/** Text column wrapper — explicit 56px height with `flex flex-col`. */
+export declare const COMPACT_CARD_TEXT_COL = "flex min-w-0 flex-1 flex-col gap-0.5 min-h-14";
+/** Title row container — fixed 20px (h-5) to match `text-sm leading-5`. */
+export declare const COMPACT_CARD_TITLE_ROW = "flex items-center min-w-0 h-5";
+/** Subtitle / summary row container — fixed 16px (h-4). */
+export declare const COMPACT_CARD_META_ROW_BOX = "flex items-center min-w-0 h-4";
+/** Title text — bold 14px on a 20px line. */
+export declare const COMPACT_CARD_TITLE = "truncate text-sm font-semibold leading-5 text-ods-text-primary";
+/** Subtitle text — 11px on a 16px line. */
+export declare const COMPACT_CARD_SUBTITLE = "truncate text-[11px] leading-4 text-ods-text-secondary";
+/** Summary text — same metrics as subtitle, dropped to 80% opacity. */
+export declare const COMPACT_CARD_SUMMARY = "truncate text-[11px] leading-4 text-ods-text-secondary/80";
+/** Meta-row variant — multi-part 11px metadata. */
+export declare const COMPACT_CARD_META_ROW = "flex items-center gap-1.5 min-w-0 text-[11px] leading-4 text-ods-text-secondary";
+/** Non-breaking space — used as a fallback child so the row's height stays 16px. */
+export declare const COMPACT_CARD_ROW_FILLER = "\u00A0";
+/** Return the input url ONLY if it's safe to drop into an `<a href>`:
+ *  the scheme must be http / https / mailto, or the URL must be a
+ *  same-origin path (`/blog/foo`). Otherwise returns `null`. */
+export declare function safeHref(url: string | null | undefined): string | null;
+//# sourceMappingURL=compact-card-classes.d.ts.map

package/dist/components/chat/utils/compact-card-classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-card-classes.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/compact-card-classes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;+DAE+D;AAC/D,eAAO,MAAM,kBAAkB,+JAC+H,CAAA;AAE9J;yDACyD;AACzD,eAAO,MAAM,yBAAyB,yHACkF,CAAA;AAExH,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,2GACkE,CAAA;AAE1G,uDAAuD;AACvD,eAAO,MAAM,uBAAuB,oGAC+D,CAAA;AAEnG,4CAA4C;AAC5C,eAAO,MAAM,gCAAgC,2EAC6B,CAAA;AAE1E,yDAAyD;AACzD,eAAO,MAAM,sBAAsB,sHACkF,CAAA;AAErH,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,kDACe,CAAA;AAEjD,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,kCAAkC,CAAA;AAErE,2DAA2D;AAC3D,eAAO,MAAM,yBAAyB,kCAAkC,CAAA;AAExE,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,mEACmC,CAAA;AAElE,2CAA2C;AAC3C,eAAO,MAAM,qBAAqB,2DACwB,CAAA;AAE1D,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,8DAC4B,CAAA;AAE7D,mDAAmD;AACnD,eAAO,MAAM,qBAAqB,oFACiD,CAAA;AAEnF,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,WAAM,CAAA;AAK1C;;gEAEgE;AAChE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAmBtE"}

package/dist/components/chat/utils/decide-new-tab.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Pure new-tab decision helper.
+ *
+ * Same logic as the hub's prior inline `decideNewTab`, but parameterized:
+ *   - `currentSource` is passed by caller (was `currentPlatform()` reads
+ *     inside the body). Hub callers pass `currentPlatform()`; lib chip
+ *     code passes `runtime.source ?? ''`.
+ *
+ * BRANCH PRIORITY:
+ *   1. `runtimeMode === 'embed'` → always new-tab (embed-mode short-circuit)
+ *   2. `openIn === 'new-tab'` or `'same-tab'` — explicit caller override
+ *   3. `alwaysNewTab === true` (legacy synonym for `openIn: 'new-tab'`)
+ *   4. `targetPlatform` defined AND `currentSource` non-empty →
+ *      platform comparison (cross-app → new tab, same-app → same tab)
+ *   5. Legacy fallback: `isCrossOriginUrl(href)` — origin compare. Works
+ *      in prod (distinct hosts) but degrades to "always same-tab" in dev.
+ *
+ * No call site implements its own variant of the rule.
+ */
+export type NavSurface = 'useNavLink' | 'useUnifiedNav';
+export type RuntimeMode = 'host' | 'embed';
+export interface DecideNewTabInput {
+    href: string | null | undefined;
+    targetPlatform?: string | null;
+    openIn?: 'new-tab' | 'same-tab';
+    alwaysNewTab?: boolean;
+    /** Caller tag — labels the decision in any external trace logging. */
+    surface?: NavSurface;
+    /** Optional chat-runtime mode. When omitted OR set to `'host'`,
+     *  behavior is byte-equivalent to the legacy logic. Only `'embed'`
+     *  triggers the new priority-1 branch that forces new-tab. */
+    runtimeMode?: RuntimeMode;
+    /** Current chat source / platform identifier — caller-threaded.
+     *  Empty string disables the platform-comparison branch (falls
+     *  through to the origin-compare fallback). */
+    currentSource: string;
+}
+export declare function decideNewTab(input: DecideNewTabInput): boolean;
+//# sourceMappingURL=decide-new-tab.d.ts.map

package/dist/components/chat/utils/decide-new-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide-new-tab.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/decide-new-tab.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,eAAe,CAAA;AACvD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,sEAAsE;IACtE,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB;;kEAE8D;IAC9D,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB;;mDAE+C;IAC/C,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAc9D"}

package/dist/components/chat/utils/external-app-urls.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Unified URL builders for the third-party app deep-links used by chat
+ * surfaces (chip clicks, inline-card tracking rows).
+ *
+ * Lib-side subset of the hub's `lib/utils/external-app-urls.ts`. Today
+ * it carries the ClickUp deep-link helper only — HubSpot and admin
+ * routes stay hub-side because they're consumed exclusively by
+ * hub-internal mappers.
+ */
+/** ClickUp task detail page in the ClickUp UI. Returns `null` when the
+ *  external id is missing so consumers don't end up with a
+ *  `.../t/undefined` link. */
+export declare function clickupTaskUrl(externalId: string | null | undefined): string | null;
+//# sourceMappingURL=external-app-urls.d.ts.map

package/dist/components/chat/utils/external-app-urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-app-urls.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/external-app-urls.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;8BAE8B;AAC9B,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGnF"}

package/dist/components/chat/utils/flatten-assistant-content.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `flattenAssistantContent` — coerce a chat message's `content` field
+ * (string OR `MessageSegment[]`) into a plain string for wire transport.
+ *
+ * Background: useChat populates assistant messages with a structured
+ * segment array as the streamed SSE arrives (text segments, approval
+ * cards, tool_execution blocks, thinking blocks). The local React
+ * state holds `content: MessageSegment[]` for those turns. When the
+ * client serializes the conversation back to the server for the NEXT
+ * turn, a naive `typeof content === 'string' ? content : ''` strip-
+ * to-empty silently drops every post-approve receipt, every Sonnet-
+ * streamed answer, and every diagnostic Q — Anthropic receives
+ * `assistant: ""` for those turns and has no context to follow.
+ *
+ * The function:
+ *   1. Returns plain strings as-is.
+ *   2. For arrays, joins every `text`-typed segment's `text` field
+ *      with `\n\n` separators. Non-text segments (approval_request,
+ *      tool_execution, thinking) have no LLM-visible textual content
+ *      and are intentionally skipped — they shouldn't bloat the
+ *      request body.
+ *   3. Returns `''` for anything else (null, undefined, unknown shape).
+ */
+export declare function flattenAssistantContent(raw: unknown): string;
+//# sourceMappingURL=flatten-assistant-content.d.ts.map

package/dist/components/chat/utils/flatten-assistant-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten-assistant-content.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/flatten-assistant-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAW5D"}

package/dist/components/chat/utils/icon-registry.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Icon registry — string `icon_name` → React component.
+ *
+ * SINGLE SOURCE OF TRUTH (no, really this time) for every icon-name →
+ * React-component lookup across the lib + the hub. Two DB columns feed
+ * in with DIFFERENT conventions:
+ *
+ *   - `chat_admin_slash_commands.icon_name` — kebab-case (`'rocket'`,
+ *     `'hubspot'`, `'github'`, `'dollar-sign'`).
+ *   - `social_platforms.icon_name` — PascalCase component names
+ *     (`'LinkedInIcon'`, `'XLogo'`, `'YouTubeIcon'`, `'Github'`).
+ *
+ * The registry stores entries under kebab-case keys (URL/DB-friendly,
+ * shell-safe, matches `lucide-react`'s own file-naming convention).
+ * The PascalCase variants come in via `normalizeIconKey()`, which maps
+ * known PascalCase aliases → kebab-case before the lookup runs.
+ *
+ * Adding a new icon: import the component below, add a `'name': Component`
+ * entry in `ICON_REGISTRY`, and (if the same icon also flows in from a DB
+ * column that uses PascalCase) add a `PascalName → 'name'` row to
+ * `PASCAL_TO_KEBAB_ALIASES`.
+ *
+ * Fallback: an unknown / null icon_name resolves to `FileText` so a chip
+ * never renders without an icon.
+ */
+import { type ComponentType, type ReactNode } from 'react';
+/**
+ * Loose icon-component shape: every entry accepts `className`; `color` is
+ * optional (lucide + most brand icons accept it; OpenFrameLogo doesn't,
+ * but `color` is optional so passing `undefined` is a no-op). Loose enough
+ * to accept both lucide's `LucideIcon` and our brand SVG components.
+ */
+type IconComponent = ComponentType<{
+    className?: string;
+    color?: string;
+}>;
+/**
+ * The kebab-case registry. ALL lookups go through here; PascalCase
+ * aliases route through `normalizeIconKey()` first.
+ */
+export declare const ICON_REGISTRY: Record<string, IconComponent>;
+/**
+ * Normalize an icon key to the registry's canonical kebab-case form.
+ * Accepts PascalCase variants (from `social_platforms.icon_name`-style
+ * columns) and passes kebab-case keys through unchanged.
+ */
+export declare function normalizeIconKey(key: string): string;
+/**
+ * Resolve an `icon_name` to its React component. Accepts both PascalCase
+ * and kebab-case keys (normalizes PascalCase first). Unknown / null /
+ * undefined names fall back to `FileText` — chips always render with
+ * SOMETHING rather than a missing glyph. The fallback is intentional:
+ * a typo in a new admin-authored row shouldn't crash render.
+ */
+export declare function getIconComponent(iconName: string | null | undefined): ComponentType<{
+    className?: string;
+    color?: string;
+}>;
+export type DynamicIconSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/**
+ * Render an icon by name with a size preset + optional className.
+ * Replaces the old `src/utils/dynamic-icons.tsx#getDynamicIcon`. Accepts
+ * both PascalCase and kebab-case keys (via `normalizeIconKey()`).
+ */
+export declare function getDynamicIcon(iconName: string | undefined | null, size?: DynamicIconSize, className?: string): ReactNode;
+export {};
+//# sourceMappingURL=icon-registry.d.ts.map

package/dist/components/chat/utils/icon-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-registry.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/icon-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAgEzE;;;;;GAKG;AACH,KAAK,aAAa,GAAG,aAAa,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE1E;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAwDvD,CAAA;AA2DD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,aAAa,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAGvD;AAMD,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAqB9D;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACnC,IAAI,GAAE,eAAsB,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,SAAS,CAsBX"}

package/dist/components/chat/utils/index.d.ts

@@ -7,4 +7,25 @@ export { MessageSegmentAccumulator, createMessageSegmentAccumulator, type Accumu
 export { processHistoricalMessages, extractErrorMessages, processHistoricalMessagesWithErrors, } from './process-historical-messages';
 export { extractIncompleteMessageState, } from './extract-incomplete-message-state';
 export { getCommandText } from './tool-call-helpers';
+export { CHIP_ACTION_BUTTON_CLASS } from './chip-action-class';
+export { chatChipClass, type ChipClassOptions } from './chip-styles';
+export { NEW_TAB_FEATURES, isModifierClick, stripSameOriginToPath, resolveExternalNavigation, type ExternalNavResolution, } from './chat-nav-resolution';
+export { handleChatNavClick, type ChatNavClickInput, } from './nav-click-handler';
+export { computeIsNewTab, newTabAnchorAttrs, buildAnchorProps, } from './nav-anchor-props';
+export { isCrossOriginUrl } from './is-cross-origin-url';
+export { decideNewTab, type DecideNewTabInput, type NavSurface, type RuntimeMode, } from './decide-new-tab';
+export { getChatProxyAuth, getPersistedProxyEmail, setChatProxyAuth, clearChatProxyAuth, applyProxyAuth, type ChatProxyAuth, } from './chat-proxy-auth-storage';
+export { chatAuthedFetch } from './chat-authed-fetch';
+export { flattenAssistantContent } from './flatten-assistant-content';
+export { SCROLL_ANCHOR, type ScrollAnchor, SCROLL_ANCHOR_WIRE_KEY, parseScrollAnchor, } from './scroll-anchor';
+export { AUTO_CONTINUATION_DIRECTIVE_PREFIX, buildAutoContinuationDirective, type BuildAutoContinuationOptions, } from './auto-continuation-directive';
+export { type WireCommandOverride, parseWireCommandOverride, sanitizeTitleForChat, formatSingularLookupInvocation, type CommandOverride, extractEntityIdFilter, buildDiscussAddendum, } from './slash-dispatch-utils';
+export { CHAT_ATTACHMENT_VIEW_URL_PREFIX, CHAT_ATTACHMENT_VIEW_TOKEN_QUERY_PARAM, ANTHROPIC_SUPPORTED_IMAGE_MIME, type ChatAttachment, buildChatAttachmentViewUrl, escapeMarkdownInline, formatChatAttachmentMarkdownForBubble, CHAT_ATTACHMENT_VIEW_URL_PREFIX_REGEX_ESCAPED, CHAT_ATTACHMENT_MARKDOWN_PATTERN, stripChatAttachmentMarkdown, } from './chat-attachment-markdown';
+export { clickupTaskUrl } from './external-app-urls';
+export { type ColorScheme, getStatusColorScheme } from './agent-status-message';
+export { getTaskTypeLabel, CUSTOM_ITEM_ID } from './clickup-task-type-utils';
+export { COMPACT_CARD_OUTER, COMPACT_CARD_OUTER_STATIC, COMPACT_CARD_SKELETON_OUTER, COMPACT_CARD_IMAGE_SLOT, COMPACT_CARD_SKELETON_IMAGE_SLOT, COMPACT_CARD_ICON_SLOT, COMPACT_CARD_TEXT_COL, COMPACT_CARD_TITLE_ROW, COMPACT_CARD_META_ROW_BOX, COMPACT_CARD_TITLE, COMPACT_CARD_SUBTITLE, COMPACT_CARD_SUMMARY, COMPACT_CARD_META_ROW, COMPACT_CARD_ROW_FILLER, safeHref, } from './compact-card-classes';
+export { ICON_REGISTRY, getIconComponent, normalizeIconKey, getDynamicIcon, type DynamicIconSize, } from './icon-registry';
+export { SOURCE_ICON_NAMES, getSourceIconName, SOURCE_LABELS_BY_TABLE, getSourceLabel, DEFAULT_DOCUMENT_TYPE_TO_TABLE_ID, defaultTableIdForDocumentType, } from './source-icons';
+export { type SourceRowInput, type SourceRowContext, type SourceRowCTA, resolveSourceRowCTA, resolveSourceIcon, } from './source-row-cta';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/chat/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,yBAAyB,EACzB,+BAA+B,EAC/B,KAAK,oBAAoB,GAC1B,MAAM,+BAA+B,CAAA;AAGtC,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,mCAAmC,GACpC,MAAM,+BAA+B,CAAA;AAGtC,OAAO,EACL,6BAA6B,GAC9B,MAAM,oCAAoC,CAAA;AAG3C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/index.ts"],"names":[],"mappings":"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"}

package/dist/components/chat/utils/is-cross-origin-url.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Pure utility — true iff `url` has an explicit host (i.e. would resolve
+ * to a different origin than where the consumer is running). Used by
+ * chat nav decisions and the extracted `decideNewTab` helper.
+ *
+ * SSR-deterministic: any URL with an explicit host (http://, https://,
+ * or protocol-relative //) is treated as cross-origin. By convention
+ * same-origin same-app navigation uses RELATIVE paths; an absolute URL
+ * with a host is external.
+ *
+ * Why deterministic: an earlier `window`-dependent implementation
+ * returned different values during SSR (false — no window) vs client
+ * hydration (true — origin differs), causing React hydration mismatches
+ * on every anchor that fell into the no-targetPlatform fallback (e.g.
+ * footer "Support" links to flamingo.run/support). Same-platform
+ * absolute URLs (rare — they only happen when a composer like
+ * `buildContentURL` returns an absolute URL for a non-current platform)
+ * flow through `decideNewTab`'s PLATFORM branch first (which uses
+ * `targetPlatform !== currentSource`) and never reach this fallback.
+ */
+export declare function isCrossOriginUrl(url: string | null | undefined): boolean;
+//# sourceMappingURL=is-cross-origin-url.d.ts.map

package/dist/components/chat/utils/is-cross-origin-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-cross-origin-url.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/is-cross-origin-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAOxE"}

package/dist/components/chat/utils/nav-anchor-props.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Pure helpers for the new-tab decision + anchor attribute pair used
+ * by chat-rendered links.
+ *
+ * After the navigation unification (ChatCardLoader pre-resolves
+ * `chatRef.url` via `resolveSourceRowCTA` + `resolveHrefForRuntime`,
+ * and `ChatCardNavWrap` handles every primary click via `onClickCapture`
+ * → `handleChatNavClick`), the per-card wrapper only needs
+ * `{href, target, rel}` on its inner `<a>` so modifier-click /
+ * hover-preview / copy-link work natively.
+ *
+ * `computeIsNewTab` is the SINGLE source of the new-tab rule across
+ * inline cards, source chips, and `NavLinkAnchorViaRuntime`. Do NOT
+ * inline the `runtime.navigation.mode === 'embed'` short-circuit + the
+ * `decideNewTab` fallback chain anywhere else.
+ *
+ * Rules:
+ *   - `embed` mode → ALWAYS new-tab. The chat lives on the embedder
+ *     origin; content lives on the hub. Same-tab nav would leave the
+ *     embedder entirely.
+ *   - `host` mode → defer to the runtime's `decideNewTab` callback
+ *     (cross-platform → new-tab) or the lib's default.
+ */
+import type { ChatRuntime } from '../../../contexts/chat-runtime-context';
+export declare function computeIsNewTab(runtime: ChatRuntime, href: string | null | undefined, targetPlatform: string | null): boolean;
+/**
+ * Returns the `target` + `rel` attribute pair for an inner `<a>` based
+ * on the new-tab decision. Spread directly into JSX:
+ *   <a href={href} {...newTabAnchorAttrs(isNewTab)} />
+ *
+ * Single helper so chat anchors stay consistent — new-tab links always
+ * pair `_blank` with `noopener noreferrer` (defense against window.opener
+ * tab-nabbing) and same-tab links don't render either attribute.
+ */
+export declare function newTabAnchorAttrs(isNewTab: boolean): {
+    target?: '_blank';
+    rel?: 'noopener noreferrer';
+};
+/**
+ * Combine `href` + new-tab attrs into a card's `anchorProps` slot.
+ * Returns `undefined` (not a falsy object) when there's no URL, so card
+ * components can branch on `anchorProps != null` to render either a
+ * clickable `<a>` or a static `<span>`.
+ *
+ * Replaces the repeated inline
+ * `chatRef.url ? { href: chatRef.url, ...newTabAnchorAttrs(isNewTab) } : undefined`
+ * pattern across the 7 dispatcher wrappers.
+ */
+export declare function buildAnchorProps(href: string | null | undefined, isNewTab: boolean): {
+    href: string;
+    target?: '_blank';
+    rel?: 'noopener noreferrer';
+} | undefined;
+//# sourceMappingURL=nav-anchor-props.d.ts.map

package/dist/components/chat/utils/nav-anchor-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-anchor-props.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/nav-anchor-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AAGzE,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,OAAO,CAWT;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG;IACpD,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,GAAG,CAAC,EAAE,qBAAqB,CAAA;CAC5B,CAIA;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,QAAQ,EAAE,OAAO,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAAC,GAAG,CAAC,EAAE,qBAAqB,CAAA;CAAE,GAAG,SAAS,CAE9E"}

package/dist/components/chat/utils/nav-click-handler.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Pure click-handler helper for chat-rendered nav links.
+ *
+ * Single click router shared by:
+ *   - The chip block inside EmbeddableChat
+ *   - `<ChatCardNavWrap>` inside the entity-card dispatcher
+ *   - `<NavLinkAnchorViaRuntime>` (markdown-body anchor wrapper)
+ *
+ * Returns `true` when the handler took action (called preventDefault); the
+ * caller can treat that as "I handled it" and skip any further routing.
+ * Returns `false` for modifier-clicks / non-primary buttons — those pass
+ * through to the browser's default behavior (open in new tab, etc.).
+ *
+ * The new-tab decision (`computeIsNewTab` — embed-mode short-circuit +
+ * `runtime.navigation.decideNewTab` + lib fallback) is the single source
+ * of truth and is consumed here directly. No caller needs to duplicate
+ * the embed-vs-host logic.
+ *
+ * Routing rules:
+ *   - Empty href → preventDefault + return true (no-op nav)
+ *   - Non-primary mouse button OR any modifier key → return false (let
+ *     the browser handle it; `<a>` semantics take over)
+ *   - new-tab (`computeIsNewTab` true) → `runtime.navigation.openExternal`
+ *     or `window.open(href, '_blank')`. Covers embed mode and
+ *     cross-platform host mode uniformly.
+ *   - same-tab → `runtime.navigation.navigate?.(…)` → fallback
+ *     `window.location.assign(stripSameOriginToPath(href))`
+ */
+import type { ChatRuntime } from '../../../contexts/chat-runtime-context';
+export interface ChatNavClickInput {
+    href: string;
+    path?: string | null;
+    targetPlatform?: string | null;
+}
+/**
+ * Minimal mouse-event surface the click handler needs. Accepting a
+ * structural type rather than `React.MouseEvent<HTMLAnchorElement>` keeps
+ * the helper callable from non-anchor surfaces (chip buttons, tile
+ * containers) without forcing a cast.
+ */
+interface NavClickEvent {
+    preventDefault(): void;
+    button?: number;
+    metaKey?: boolean;
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}
+export declare function handleChatNavClick(e: NavClickEvent, runtime: ChatRuntime, { href, path, targetPlatform }: ChatNavClickInput): boolean;
+export {};
+//# sourceMappingURL=nav-click-handler.d.ts.map

package/dist/components/chat/utils/nav-click-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-click-handler.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/nav-click-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AAEzE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED;;;;;GAKG;AACH,UAAU,aAAa;IACrB,cAAc,IAAI,IAAI,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,aAAa,EAChB,OAAO,EAAE,WAAW,EACpB,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,iBAAiB,GAChD,OAAO,CAsBT"}