@pilotiq/tiptap 0.1.0

package/dist/extensions/TextSizeMarks.js

@@ -0,0 +1,47 @@
+import { Mark, mergeAttributes } from '@tiptap/core';
+/**
+ * Two inline marks for paragraph-style size variants beyond the standard
+ * heading levels:
+ *
+ *   - `lead`  — opening / lede paragraph styling. Renders as
+ *               `<span class="lead">…</span>` so authors keep paragraph
+ *               semantics; styling is owned by the consumer's CSS (the
+ *               adapter doesn't ship a `.lead` rule — every site already
+ *               has one).
+ *   - `small` — semantic `<small>` mark. Mirrors the HTML element so
+ *               read-side renderers don't need a special class to style
+ *               fine print.
+ *
+ * Both marks live in the standard inline group so they compose with bold,
+ * italic, color, etc. without exclusivity rules. Excluding each other isn't
+ * useful — a `<small lead>` selection would be inert visually anyway.
+ */
+export const LeadMarkExtension = Mark.create({
+    name: 'lead',
+    parseHTML() {
+        return [{ tag: 'span.lead' }];
+    },
+    renderHTML({ HTMLAttributes }) {
+        return ['span', mergeAttributes({ class: 'lead' }, HTMLAttributes), 0];
+    },
+    addCommands() {
+        return {
+            toggleLead: () => ({ commands }) => commands.toggleMark(this.name),
+        };
+    },
+});
+export const SmallMarkExtension = Mark.create({
+    name: 'small',
+    parseHTML() {
+        return [{ tag: 'small' }];
+    },
+    renderHTML({ HTMLAttributes }) {
+        return ['small', mergeAttributes(HTMLAttributes), 0];
+    },
+    addCommands() {
+        return {
+            toggleSmall: () => ({ commands }) => commands.toggleMark(this.name),
+        };
+    },
+});
+//# sourceMappingURL=TextSizeMarks.js.map

package/dist/extensions/TextSizeMarks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextSizeMarks.js","sourceRoot":"","sources":["../../src/extensions/TextSizeMarks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAepD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,MAAM;IAEZ,SAAS;QACP,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAA;IAC/B,CAAC;IAED,UAAU,CAAC,EAAE,cAAc,EAAE;QAC3B,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,CAAA;IACxE,CAAC;IAED,WAAW;QACT,OAAO;YACL,UAAU,EACR,GAAG,EAAE,CACL,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CACf,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;SACnC,CAAA;IACH,CAAC;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,OAAO;IAEb,SAAS;QACP,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;IAC3B,CAAC;IAED,UAAU,CAAC,EAAE,cAAc,EAAE;QAC3B,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAA;IACtD,CAAC;IAED,WAAW;QACT,OAAO;YACL,WAAW,EACT,GAAG,EAAE,CACL,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CACf,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;SACnC,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { RichTextField, DEFAULT_TOOLBAR_GROUPS, DEFAULT_TEXT_COLORS, DEFAULT_HIGHLIGHT_COLORS, type ColorSwatch, type RichTextAttachmentVisibility, type RichTextFieldMeta, type RichTextStorage, type ToolbarButtonId, type ToolbarGroups, } from './RichTextField.js';
+export { Block, type BlockMeta } from './Block.js';
+export { MentionProvider, type MentionItem, type MentionProviderMeta, } from './MentionProvider.js';
+export { registerTiptap } from './register.js';
+export { tiptap } from './plugin.js';
+export { TiptapEditor } from './react/TiptapEditor.js';
+export { renderRichTextToHtml, isRichTextValue, type RenderRichTextOptions, type TiptapNode, type TiptapMark, } from './render.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,WAAW,EAChB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { RichTextField, DEFAULT_TOOLBAR_GROUPS, DEFAULT_TEXT_COLORS, DEFAULT_HIGHLIGHT_COLORS, } from './RichTextField.js';
+export { Block } from './Block.js';
+export { MentionProvider, } from './MentionProvider.js';
+export { registerTiptap } from './register.js';
+export { tiptap } from './plugin.js';
+export { TiptapEditor } from './react/TiptapEditor.js';
+export { renderRichTextToHtml, isRichTextValue, } from './render.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,GAOzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAA;AAClD,OAAO,EACL,eAAe,GAGhB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EACL,oBAAoB,EACpB,eAAe,GAIhB,MAAM,aAAa,CAAA"}

package/dist/plugin.d.ts

@@ -0,0 +1,18 @@
+import type { PilotiqPlugin } from '@pilotiq/pilotiq';
+/**
+ * Pilotiq plugin that registers the Tiptap rich-text renderer.
+ *
+ * Use with `Pilotiq.make(...).plugins([tiptap()])` instead of calling
+ * `registerTiptap()` directly from your app's client entry — the plugin
+ * runs through the panel module so it's wired in one place.
+ *
+ * @example
+ * ```ts
+ * import { Pilotiq } from '@pilotiq/pilotiq'
+ * import { tiptap } from '@pilotiq/tiptap'
+ *
+ * Pilotiq.make('Admin').plugins([tiptap()])
+ * ```
+ */
+export declare function tiptap(): PilotiqPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGrD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,IAAI,aAAa,CAOtC"}

package/dist/plugin.js

@@ -0,0 +1,25 @@
+import { registerTiptap } from './register.js';
+/**
+ * Pilotiq plugin that registers the Tiptap rich-text renderer.
+ *
+ * Use with `Pilotiq.make(...).plugins([tiptap()])` instead of calling
+ * `registerTiptap()` directly from your app's client entry — the plugin
+ * runs through the panel module so it's wired in one place.
+ *
+ * @example
+ * ```ts
+ * import { Pilotiq } from '@pilotiq/pilotiq'
+ * import { tiptap } from '@pilotiq/tiptap'
+ *
+ * Pilotiq.make('Admin').plugins([tiptap()])
+ * ```
+ */
+export function tiptap() {
+    return {
+        name: '@pilotiq/tiptap',
+        register() {
+            registerTiptap();
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,QAAQ;YACN,cAAc,EAAE,CAAA;QAClB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/react/BlockNodeView.d.ts

@@ -0,0 +1,19 @@
+import { type NodeViewProps } from '@tiptap/react';
+/**
+ * Generic React NodeView for the `pilotiqBlock` ProseMirror node. Reads
+ * the block type from `node.attrs.blockType`, looks up its `BlockMeta`
+ * in `BlockNodeExtension.options.blocks`, and renders a compact inline
+ * summary card with an "Edit" button.
+ *
+ * Editing happens in a side panel hosted by `TiptapEditor`, NOT inline.
+ * The NodeView fires `BlockNodeExtension.options.onEdit(getPos())` when
+ * the Edit button is clicked; the host opens its panel anchored to the
+ * editor wrapper. NodeViews live in a separate React tree from the host
+ * editor, so the bridge has to go through extension options — context
+ * doesn't cross trees.
+ *
+ * If no `onEdit` is wired (e.g. a consumer that uses `BlockNodeExtension`
+ * standalone without `TiptapEditor`'s panel), the Edit button is hidden.
+ */
+export declare function BlockNodeView(props: NodeViewProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=BlockNodeView.d.ts.map

package/dist/react/BlockNodeView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockNodeView.d.ts","sourceRoot":"","sources":["../../src/react/BlockNodeView.tsx"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAGnE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,kDA8EjD"}

package/dist/react/BlockNodeView.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect } from 'react';
+import { NodeViewWrapper } from '@tiptap/react';
+/**
+ * Generic React NodeView for the `pilotiqBlock` ProseMirror node. Reads
+ * the block type from `node.attrs.blockType`, looks up its `BlockMeta`
+ * in `BlockNodeExtension.options.blocks`, and renders a compact inline
+ * summary card with an "Edit" button.
+ *
+ * Editing happens in a side panel hosted by `TiptapEditor`, NOT inline.
+ * The NodeView fires `BlockNodeExtension.options.onEdit(getPos())` when
+ * the Edit button is clicked; the host opens its panel anchored to the
+ * editor wrapper. NodeViews live in a separate React tree from the host
+ * editor, so the bridge has to go through extension options — context
+ * doesn't cross trees.
+ *
+ * If no `onEdit` is wired (e.g. a consumer that uses `BlockNodeExtension`
+ * standalone without `TiptapEditor`'s panel), the Edit button is hidden.
+ */
+export function BlockNodeView(props) {
+    const { editor, node, getPos, deleteNode } = props;
+    const blockType = String(node.attrs['blockType'] ?? '');
+    const blockData = node.attrs['blockData'] ?? {};
+    // Tiptap mounts NodeViews in a separate React tree, so we can't read the
+    // block registry through context. Pull it off the extension's options
+    // instead — set by RichTextField via BlockNodeExtension.configure({ blocks }).
+    const blockExt = editor.extensionManager.extensions.find((e) => e.name === 'pilotiqBlock');
+    const blocks = blockExt?.options['blocks'] ?? [];
+    const onEdit = blockExt?.options['onEdit'];
+    const meta = blocks.find((b) => b.name === blockType);
+    // Self-heal: a block with no `blockType` is malformed — almost always
+    // means a stale node from a prior buggy insert. Delete it on mount so
+    // the editor doesn't get stuck in an unrecoverable state.
+    useEffect(() => {
+        if (blockType === '')
+            deleteNode();
+    }, [blockType, deleteNode]);
+    if (!meta) {
+        if (blockType === '')
+            return null;
+        return (_jsxs(NodeViewWrapper, { className: "my-2 rounded-md border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive", children: ["Unknown block type: ", _jsx("code", { children: blockType })] }));
+    }
+    const summary = meta.schema
+        .map((f) => {
+        const v = blockData[f.name];
+        return typeof v === 'string' && v ? v : '';
+    })
+        .filter(Boolean)
+        .join(' · ') || meta.label;
+    const handleEdit = () => {
+        if (!onEdit)
+            return;
+        const pos = getPos();
+        if (typeof pos !== 'number')
+            return;
+        onEdit(pos);
+    };
+    return (_jsx(NodeViewWrapper, { className: "pilotiq-block my-3 rounded-lg border bg-muted/30", children: _jsxs("div", { className: "flex items-start justify-between gap-2 px-3 py-2", children: [_jsxs("button", { type: "button", onClick: handleEdit, disabled: !onEdit, className: "flex items-center gap-2 text-left text-sm disabled:cursor-default", children: [meta.icon && _jsx("span", { "aria-hidden": "true", children: meta.icon }), _jsx("span", { className: "font-medium", children: meta.label }), _jsx("span", { className: "text-xs text-muted-foreground line-clamp-1", children: summary })] }), _jsxs("div", { className: "flex items-center gap-2", children: [onEdit && (_jsx("button", { type: "button", onClick: handleEdit, className: "text-xs text-muted-foreground hover:text-foreground", children: "Edit" })), _jsx("button", { type: "button", onClick: () => deleteNode(), className: "text-xs text-destructive hover:underline", children: "Remove" })] })] }) }));
+}
+//# sourceMappingURL=BlockNodeView.js.map

package/dist/react/BlockNodeView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockNodeView.js","sourceRoot":"","sources":["../../src/react/BlockNodeView.tsx"],"names":[],"mappings":"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"}

package/dist/react/BlockSidePanel.d.ts

@@ -0,0 +1,105 @@
+import type { Editor } from '@tiptap/react';
+import type { BlockMeta } from '../Block.js';
+/**
+ * Floating right-docked side panel for editing a custom block's schema
+ * fields. Mounted by `TiptapEditor` once the user clicks the Edit button
+ * on a `pilotiqBlock` NodeView; reads/writes flow through ProseMirror
+ * directly (no form submit, no roundtrip).
+ *
+ * Why a sibling of the NodeView and not the NodeView itself:
+ *   - NodeViews mount in a separate React tree (Tiptap quirk), so they
+ *     can't reach pilotiq's `FormFields` renderer or any provider on
+ *     the host page (Theme, Toaster, etc.). Hosting the panel here in
+ *     the host's tree gives us the full pilotiq field surface for free.
+ *
+ * Reads: each field's `defaultValue` is overridden from the block's
+ * stored `blockData`. Inputs are uncontrolled (outside `FormStateProvider`,
+ * pilotiq's renderers fall back to `defaultValue` automatically).
+ *
+ * Writes: container-level event delegation on the form element. Every
+ * change snapshots the entire form via `new FormData(formEl)` →
+ * `parseFormDataToNested` (rebuilds nested arrays/objects from
+ * dotted-path inputs like `myrep.0.title`) → `coerceBlockValues`
+ * (per-fieldType JSON parse / boolean / number coerce so nested-shape
+ * fields round-trip in their canonical wire form). The result is
+ * dispatched through `state.tr.setNodeMarkup` on the tracked position.
+ * The position is kept fresh by mapping it through every editor
+ * transaction so live edits elsewhere in the document don't desync.
+ *
+ * V2 (2026-05-04 cont'd): nested-shape fields now round-trip cleanly:
+ * Repeater (array of subschema rows), Builder (heterogeneous block
+ * rows), TagsInput / KeyValue / FileUpload (JSON-encoded hidden
+ * inputs), Markdown (plain textarea), and the standard primitives
+ * (text / textarea / select / toggle / checkbox / radio / date /
+ * datetime / number / slider / color / toggleButtons / checkboxList).
+ */
+export interface BlockSidePanelProps {
+    editor: Editor;
+    /** Position at open time. Tracked + remapped on every transaction. */
+    initialPos: number;
+    /** Block type at open time — guards against the user clicking Edit on
+     *  one block, then someone else's edit replacing it with a different
+     *  block at the same position. */
+    blockType: string;
+    blocks: BlockMeta[];
+    onClose: () => void;
+}
+export declare function BlockSidePanel({ editor, initialPos, blockType, blocks, onClose, }: BlockSidePanelProps): React.ReactElement | null;
+/**
+ * Clamp + sanitize a candidate panel width against this panel's bounds
+ * (`[PANEL_WIDTH_MIN, PANEL_WIDTH_MAX]`, default `PANEL_WIDTH_DEFAULT`).
+ * Thin wrapper around the shared `clampPanelWidth` helper from
+ * `@pilotiq/pilotiq/react` — kept exported with the panel-specific
+ * defaults baked in so existing tests + downstream callers don't have
+ * to plumb the bounds themselves.
+ */
+export declare function clampPanelWidth(value: unknown): number;
+/**
+ * Per-fieldType coerce of a nested values map (built by
+ * `parseFormDataToNested`) against the block's schema. Mirrors the
+ * server-side `coerceFormValues` at a small subset suitable for the
+ * side panel — we only run on top-level block fields plus the immediate
+ * children of any Repeater rows / Builder rows.data, which is all the
+ * V2 surface needs.
+ *
+ * Non-coerce passthrough for: text, textarea, select, radio, date,
+ * dateTime, email, color, toggleButtons, slug, hidden. (Their wire shape
+ * is already a plain string / array of strings.)
+ *
+ * Coerce branches:
+ * - `toggle` / `checkbox`: 'true' / 'false' string → boolean.
+ * - `number` / `slider`: parse to Number, null on empty, raw string
+ *   passthrough on NaN (so a half-typed value isn't lost).
+ * - `tagsInput`: JSON-encoded string → string[].
+ * - `checkboxList`: JSON-encoded string OR array → string[].
+ * - `keyValue`: JSON-encoded string → Record<string, unknown>.
+ * - `fileUpload`: single → URL string passthrough; multiple →
+ *   JSON-encoded string → string[].
+ * - `repeater`: each row in the array gets recursive coerce against
+ *   the field's `template` (the inner field schema definition).
+ * - `builder`: each row's `data` gets recursive coerce against the
+ *   block matching `row.type` from `field.blocks[]`. Unknown block
+ *   types pass through verbatim — the renderer shows a placeholder
+ *   and the data round-trips intact across config rollbacks.
+ *
+ * Exported for unit tests. Pure — no React, no DOM, no editor.
+ */
+export declare function coerceBlockValues(raw: Record<string, unknown>, schema: ReadonlyArray<Record<string, unknown>>): Record<string, unknown>;
+/**
+ * Read the resolved field value for a given input event target. Kept
+ * for back-compat — V1 used this in the per-event handler. V2 reads
+ * the entire form via `FormData` instead, but this helper still maps
+ * cleanly onto a single-input read for testing and is exported.
+ *
+ * String passthrough for the common case; explicit coercion for
+ * booleans and numerics so the round-trip into the node attrs preserves
+ * shape.
+ */
+export declare function readBlockFieldValue(target: {
+    type?: string;
+    value: string;
+    checked?: boolean;
+}, fieldMeta: {
+    fieldType?: unknown;
+}): unknown;
+//# sourceMappingURL=BlockSidePanel.d.ts.map

package/dist/react/BlockSidePanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockSidePanel.d.ts","sourceRoot":"","sources":["../../src/react/BlockSidePanel.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAO3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAkB5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAK,MAAM,CAAA;IACjB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAA;IAClB;;sCAEkC;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAK,SAAS,EAAE,CAAA;IACtB,OAAO,EAAI,MAAM,IAAI,CAAA;CACtB;AAED,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,UAAU,EACV,SAAS,EACT,MAAM,EACN,OAAO,GACR,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAsLjD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMtD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAsFD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAK;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9D,SAAS,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAYT"}