@connextar/house 0.1.1 → 0.3.0

package/dist/editor/suggestions.d.ts

@@ -0,0 +1,93 @@
+import { Extension, type Editor, type Range } from "@tiptap/core";
+import { type LucideIcon } from "lucide-react";
+/**
+ * The character-triggered lookups the editor offers:
+ *
+ * - `/` opens the block menu — the same list the bubble menu's "Turn into" and
+ *   each block's grip use, plus a few insert-only actions;
+ * - `:` completes an emoji shortcode from the curated set;
+ * - `@` references something linkable, and `#` completes a tag — both only when
+ *   the host app supplies a source, because only the app knows what its people,
+ *   records and tags are.
+ *
+ * None of them inserts a custom node. `@` becomes ordinary text carrying an
+ * ordinary link mark (`[@label](href)` in Markdown), `#` and `:` become plain
+ * text, and `/` converts the current block through the same commands the
+ * Markdown input rules use — so the stored Markdown needs no special dialect,
+ * survives any renderer, and a server can mirror `@` and `#` by regex without an
+ * editor in the loop.
+ */
+/** One row in the suggestion popup — every kind, one shape. */
+export interface SuggestionItem {
+    key: string;
+    label: string;
+    hint: string | null;
+    /** A lucide icon for block/action rows. */
+    icon?: LucideIcon;
+    /** A literal glyph instead of an icon — an emoji. */
+    glyph?: string;
+    /** A person: initials (and picture), shown as an avatar. */
+    avatar?: {
+        initials: string;
+        image: string | null;
+    };
+    /** The heading this row sits under; the popup prints one per run of rows. */
+    group?: string;
+    /** What accepting this row does to the document. */
+    insert: {
+        kind: "reference";
+        href: string;
+    } | {
+        kind: "text";
+        text: string;
+    } | {
+        kind: "emoji";
+        char: string;
+    } | {
+        kind: "block";
+        run: (editor: Editor) => void;
+    };
+}
+/** Where `@` and `#` get their rows. Omit one and its trigger does nothing. */
+export interface SuggestionSources {
+    references?: (query: string) => Promise<SuggestionItem[]>;
+    tags?: (query: string) => Promise<SuggestionItem[]>;
+}
+/** What the editor component needs to render and drive the popup. */
+export interface SuggestionSession {
+    items: SuggestionItem[];
+    clientRect: (() => DOMRect | null) | null;
+    command: (item: SuggestionItem) => void;
+}
+export interface SuggestionUiHandle {
+    onOpen: (session: SuggestionSession) => void;
+    onClose: () => void;
+    /** Returns true when the popup consumed the key (arrows, Enter, Escape). */
+    onKeyDown: (event: KeyboardEvent) => boolean;
+}
+export interface SuggestionOptions {
+    /** Today's date as the `/` menu inserts it. */
+    formatDate: (date: Date) => string;
+}
+export declare const DEFAULT_SUGGESTION_OPTIONS: SuggestionOptions;
+export declare function emojiItems(query: string): SuggestionItem[];
+/**
+ * The `/` menu: every block type, then the insert-only actions. Filtered by
+ * label and keywords so `/todo`, `/h2`, `/date` all land where expected.
+ */
+export declare function slashItems(query: string, sources: SuggestionSources, options: SuggestionOptions): SuggestionItem[];
+/** Apply an accepted row to the document, replacing the trigger text. */
+export declare function applySuggestion(editor: Editor, range: Range, item: SuggestionItem): void;
+/**
+ * Every lookup as one extension. `ui` and `sources` are ref-like holders read
+ * lazily on every callback, so the extension (created once per editor) always
+ * talks to the current render's handlers and the app's current sources.
+ */
+export declare function createSuggestions(ui: {
+    current: SuggestionUiHandle;
+}, sources: {
+    current: SuggestionSources;
+}, options: {
+    current: SuggestionOptions;
+}): Extension<any, any>;
+//# sourceMappingURL=suggestions.d.ts.map

package/dist/editor/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../../src/editor/suggestions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAKvF;;;;;;;;;;;;;;;;GAgBG;AAEH,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACpD,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,MAAM,EACF;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GACnC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAC9B;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAC/B;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CACtD;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACrD;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,UAAU,EAAE,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,4EAA4E;IAC5E,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;CACpC;AAID,eAAO,MAAM,0BAA0B,EAAE,iBAExC,CAAC;AAIF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,CAQ1D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAsDlH;AAID,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CA0BxF;AAeD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE;IAAE,OAAO,EAAE,kBAAkB,CAAA;CAAE,EACnC,OAAO,EAAE;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,EACvC,OAAO,EAAE;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,uBA0DxC"}

package/dist/editor/suggestions.js

@@ -0,0 +1,179 @@
+"use client";
+import { Extension } from "@tiptap/core";
+import { PluginKey } from "@tiptap/pm/state";
+import { Suggestion } from "@tiptap/suggestion";
+import { AtSign, CalendarDays, Minus, SmilePlus } from "lucide-react";
+import { BLOCK_TYPES } from "./blocks.js";
+import { searchEmoji } from "./emoji.js";
+const ukShortDate = new Intl.DateTimeFormat("en-GB", { day: "numeric", month: "short", year: "numeric" });
+export const DEFAULT_SUGGESTION_OPTIONS = {
+    formatDate: (date) => ukShortDate.format(date),
+};
+/* ── Item sources ─────────────────────────────────────────────────────── */
+export function emojiItems(query) {
+    return searchEmoji(query, 8).map((entry) => ({
+        key: `emoji:${entry.name}`,
+        label: entry.name.replace(/_/g, " "),
+        hint: null,
+        glyph: entry.char,
+        insert: { kind: "emoji", char: entry.char },
+    }));
+}
+/**
+ * The `/` menu: every block type, then the insert-only actions. Filtered by
+ * label and keywords so `/todo`, `/h2`, `/date` all land where expected.
+ */
+export function slashItems(query, sources, options) {
+    const term = query.trim().toLowerCase();
+    const blocks = BLOCK_TYPES.map((type) => ({
+        key: `block:${type.id}`,
+        label: type.label,
+        hint: type.shortcut.trim() || null,
+        icon: type.icon,
+        insert: { kind: "block", run: (editor) => void type.apply(editor.chain().focus()).run() },
+    }));
+    const today = options.formatDate(new Date());
+    const actions = [
+        {
+            key: "action:divider",
+            label: "Divider",
+            hint: "---",
+            icon: Minus,
+            insert: { kind: "block", run: (editor) => void editor.chain().focus().setHorizontalRule().run() },
+        },
+        {
+            key: "action:date",
+            label: "Today's date",
+            hint: today,
+            icon: CalendarDays,
+            insert: { kind: "block", run: (editor) => void editor.chain().focus().insertContent(`${today} `).run() },
+        },
+        ...(sources.references
+            ? [
+                {
+                    key: "action:reference",
+                    label: "Reference…",
+                    hint: "@",
+                    icon: AtSign,
+                    insert: { kind: "block", run: (editor) => void editor.chain().focus().insertContent("@").run() },
+                },
+            ]
+            : []),
+        {
+            key: "action:emoji",
+            label: "Emoji…",
+            hint: ":",
+            icon: SmilePlus,
+            insert: { kind: "block", run: (editor) => void editor.chain().focus().insertContent(":").run() },
+        },
+    ];
+    const all = [...blocks, ...actions];
+    if (!term)
+        return all;
+    const keywordsOf = (item) => BLOCK_TYPES.find((type) => `block:${type.id}` === item.key)?.keywords ?? [];
+    return all.filter((item) => item.label.toLowerCase().includes(term) ||
+        (item.hint ?? "").toLowerCase().startsWith(term) ||
+        keywordsOf(item).some((keyword) => keyword.includes(term)));
+}
+/* ── Applying a choice ────────────────────────────────────────────────── */
+/** Apply an accepted row to the document, replacing the trigger text. */
+export function applySuggestion(editor, range, item) {
+    switch (item.insert.kind) {
+        case "reference":
+            editor
+                .chain()
+                .focus()
+                .insertContentAt(range, [
+                { type: "text", text: `@${item.label}`, marks: [{ type: "link", attrs: { href: item.insert.href } }] },
+                // The space deliberately carries no marks, so the link stops here
+                // instead of bleeding into whatever is typed next.
+                { type: "text", text: " " },
+            ])
+                .run();
+            return;
+        case "text":
+            editor.chain().focus().insertContentAt(range, `${item.insert.text} `).run();
+            return;
+        case "emoji":
+            editor.chain().focus().insertContentAt(range, `${item.insert.char} `).run();
+            return;
+        case "block":
+            // Remove the "/query" first, then run the block command on what's left.
+            editor.chain().focus().deleteRange(range).run();
+            item.insert.run(editor);
+            return;
+    }
+}
+function renderInto(ui) {
+    return () => ({
+        onStart: (props) => {
+            ui.current.onOpen({ items: props.items, clientRect: props.clientRect ?? null, command: props.command });
+        },
+        onUpdate: (props) => {
+            ui.current.onOpen({ items: props.items, clientRect: props.clientRect ?? null, command: props.command });
+        },
+        onKeyDown: (props) => ui.current.onKeyDown(props.event),
+        onExit: () => ui.current.onClose(),
+    });
+}
+/**
+ * Every lookup as one extension. `ui` and `sources` are ref-like holders read
+ * lazily on every callback, so the extension (created once per editor) always
+ * talks to the current render's handlers and the app's current sources.
+ */
+export function createSuggestions(ui, sources, options) {
+    const shared = {
+        decorationClass: "house-suggestion",
+        command: ({ editor, range, props }) => applySuggestion(editor, range, props),
+        render: renderInto(ui),
+    };
+    return Extension.create({
+        name: "houseSuggestions",
+        addProseMirrorPlugins() {
+            return [
+                Suggestion({
+                    ...shared,
+                    pluginKey: new PluginKey("houseReferenceSuggestion"),
+                    editor: this.editor,
+                    char: "@",
+                    // Open on the `@` itself, as Notion does: the list shows what you
+                    // work with before anything is typed.
+                    minQueryLength: 0,
+                    debounce: 150,
+                    allow: () => Boolean(sources.current.references),
+                    items: ({ query }) => sources.current.references?.(query) ?? [],
+                }),
+                Suggestion({
+                    ...shared,
+                    pluginKey: new PluginKey("houseTagSuggestion"),
+                    editor: this.editor,
+                    char: "#",
+                    minQueryLength: 1,
+                    debounce: 150,
+                    allow: () => Boolean(sources.current.tags),
+                    items: ({ query }) => sources.current.tags?.(query) ?? [],
+                }),
+                Suggestion({
+                    ...shared,
+                    pluginKey: new PluginKey("houseSlashSuggestion"),
+                    editor: this.editor,
+                    char: "/",
+                    // Only after a space or at the start of a block, so `and/or` and the
+                    // `/` inside a URL never open the menu.
+                    allowedPrefixes: [" "],
+                    items: ({ query }) => slashItems(query, sources.current, options.current),
+                }),
+                Suggestion({
+                    ...shared,
+                    pluginKey: new PluginKey("houseEmojiSuggestion"),
+                    editor: this.editor,
+                    char: ":",
+                    minQueryLength: 2,
+                    allowedPrefixes: [" "],
+                    items: ({ query }) => emojiItems(query),
+                }),
+            ];
+        },
+    });
+}
+//# sourceMappingURL=suggestions.js.map

package/dist/editor/suggestions.js.map

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

package/dist/editor/ui.d.ts

@@ -0,0 +1,54 @@
+import * as DropdownMenu from "@radix-ui/react-dropdown-menu";
+import * as Popover from "@radix-ui/react-popover";
+import { type ButtonHTMLAttributes, type InputHTMLAttributes, type ReactNode } from "react";
+/**
+ * The few controls the editor's own chrome needs — a menu, a popover, a small
+ * button — built on Radix and the house token classes.
+ *
+ * Not the host app's design system, and not a replacement for it. The package
+ * README's rule is that nothing here brings a second Button into an app; these
+ * are the editor's internal parts (the formatting bubble, the block menu, the
+ * link box), never exported, and they exist because the apps' own primitive
+ * sets differ — several have no popover or toggle at all — so the editor
+ * cannot ask for them.
+ */
+export declare const buttonClass = "inline-flex shrink-0 items-center justify-center gap-1.5 rounded-md text-sm font-medium whitespace-nowrap transition-colors outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50";
+export declare const ghostButtonClass: string;
+export declare const primaryButtonClass: string;
+export declare const IconButton: import("react").ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & {
+    pressed?: boolean;
+} & import("react").RefAttributes<HTMLButtonElement>>;
+export declare const TextInput: import("react").ForwardRefExoticComponent<InputHTMLAttributes<HTMLInputElement> & import("react").RefAttributes<HTMLInputElement>>;
+export declare function VerticalSeparator(): import("react").JSX.Element;
+export declare const Menu: import("react").FC<DropdownMenu.DropdownMenuProps>;
+export declare const MenuTrigger: import("react").ForwardRefExoticComponent<DropdownMenu.DropdownMenuTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
+export declare const MenuSub: import("react").FC<DropdownMenu.DropdownMenuSubProps>;
+export declare function MenuContent({ children, className, align, }: {
+    children: ReactNode;
+    className?: string;
+    align?: "start" | "center" | "end";
+}): import("react").JSX.Element;
+export declare function MenuItem({ children, onSelect, className, }: {
+    children: ReactNode;
+    onSelect: () => void;
+    className?: string;
+}): import("react").JSX.Element;
+export declare function MenuLabel({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function MenuSeparator(): import("react").JSX.Element;
+export declare function MenuSubTrigger({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function MenuSubContent({ children, className }: {
+    children: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;
+export declare const PopoverRoot: import("react").FC<Popover.PopoverProps>;
+export declare const PopoverTrigger: import("react").ForwardRefExoticComponent<Popover.PopoverTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
+export declare function PopoverContent({ children, className, align, }: {
+    children: ReactNode;
+    className?: string;
+    align?: "start" | "center" | "end";
+}): import("react").JSX.Element;
+//# sourceMappingURL=ui.d.ts.map

package/dist/editor/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/editor/ui.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,YAAY,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,OAAO,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAc,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIxG;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,WAAW,2OACkN,CAAC;AAE3O,eAAO,MAAM,gBAAgB,QAAkF,CAAC;AAEhH,eAAO,MAAM,kBAAkB,QAAqF,CAAC;AAQrH,eAAO,MAAM,UAAU;cAEiC,OAAO;qDAW7D,CAAC;AAEH,eAAO,MAAM,SAAS,oIAcpB,CAAC;AAEH,wBAAgB,iBAAiB,gCAEhC;AAED,eAAO,MAAM,IAAI,oDAAoB,CAAC;AACtC,eAAO,MAAM,WAAW,qIAAuB,CAAC;AAChD,eAAO,MAAM,OAAO,uDAAmB,CAAC;AAExC,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,SAAS,EACT,KAAe,GAChB,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CACpC,+BAQA;AAED,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,QAAQ,EACR,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAMA;AAED,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAM9D;AAED,wBAAgB,aAAa,gCAE5B;AAED,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAMnE;AAED,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,+BAQlG;AAED,eAAO,MAAM,WAAW,0CAAe,CAAC;AACxC,eAAO,MAAM,cAAc,2HAAkB,CAAC;AAE9C,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,SAAS,EACT,KAAe,GAChB,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CACpC,+BAeA"}

package/dist/editor/ui.js

@@ -0,0 +1,58 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as DropdownMenu from "@radix-ui/react-dropdown-menu";
+import * as Popover from "@radix-ui/react-popover";
+import { forwardRef } from "react";
+import { cx } from "../internal/cx.js";
+/**
+ * The few controls the editor's own chrome needs — a menu, a popover, a small
+ * button — built on Radix and the house token classes.
+ *
+ * Not the host app's design system, and not a replacement for it. The package
+ * README's rule is that nothing here brings a second Button into an app; these
+ * are the editor's internal parts (the formatting bubble, the block menu, the
+ * link box), never exported, and they exist because the apps' own primitive
+ * sets differ — several have no popover or toggle at all — so the editor
+ * cannot ask for them.
+ */
+export const buttonClass = "inline-flex shrink-0 items-center justify-center gap-1.5 rounded-md text-sm font-medium whitespace-nowrap transition-colors outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50";
+export const ghostButtonClass = cx(buttonClass, "text-foreground hover:bg-accent hover:text-accent-foreground");
+export const primaryButtonClass = cx(buttonClass, "h-8 bg-primary px-3 text-primary-foreground hover:bg-primary/90");
+const menuSurfaceClass = "z-50 min-w-[10rem] overflow-hidden rounded-md border border-border bg-popover p-1 text-popover-foreground shadow-md";
+const menuItemClass = "relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none select-none focus:bg-accent focus:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50";
+export const IconButton = forwardRef(function IconButton({ pressed, className, type = "button", ...props }, ref) {
+    return (_jsx("button", { ref: ref, type: type, "aria-pressed": pressed, className: cx(ghostButtonClass, "size-8 p-0", pressed && "bg-accent text-accent-foreground", className), ...props }));
+});
+export const TextInput = forwardRef(function TextInput({ className, ...props }, ref) {
+    return (_jsx("input", { ref: ref, className: cx("flex h-9 w-full rounded-md border border-input bg-background px-3 py-1 text-sm text-foreground shadow-xs outline-none placeholder:text-muted-foreground focus-visible:ring-2 focus-visible:ring-ring", className), ...props }));
+});
+export function VerticalSeparator() {
+    return _jsx("span", { role: "separator", "aria-orientation": "vertical", className: "mx-0.5 h-5 w-px bg-border" });
+}
+export const Menu = DropdownMenu.Root;
+export const MenuTrigger = DropdownMenu.Trigger;
+export const MenuSub = DropdownMenu.Sub;
+export function MenuContent({ children, className, align = "start", }) {
+    return (_jsx(DropdownMenu.Portal, { children: _jsx(DropdownMenu.Content, { align: align, sideOffset: 4, className: cx(menuSurfaceClass, className), children: children }) }));
+}
+export function MenuItem({ children, onSelect, className, }) {
+    return (_jsx(DropdownMenu.Item, { onSelect: onSelect, className: cx(menuItemClass, className), children: children }));
+}
+export function MenuLabel({ children }) {
+    return (_jsx(DropdownMenu.Label, { className: "px-2 py-1.5 text-[11px] font-semibold tracking-wide text-muted-foreground uppercase", children: children }));
+}
+export function MenuSeparator() {
+    return _jsx(DropdownMenu.Separator, { className: "-mx-1 my-1 h-px bg-border" });
+}
+export function MenuSubTrigger({ children }) {
+    return (_jsx(DropdownMenu.SubTrigger, { className: cx(menuItemClass, "data-[state=open]:bg-accent"), children: children }));
+}
+export function MenuSubContent({ children, className }) {
+    return (_jsx(DropdownMenu.Portal, { children: _jsx(DropdownMenu.SubContent, { sideOffset: 4, className: cx(menuSurfaceClass, className), children: children }) }));
+}
+export const PopoverRoot = Popover.Root;
+export const PopoverTrigger = Popover.Trigger;
+export function PopoverContent({ children, className, align = "start", }) {
+    return (_jsx(Popover.Portal, { children: _jsx(Popover.Content, { align: align, sideOffset: 6, className: cx("z-50 rounded-md border border-border bg-popover p-3 text-popover-foreground shadow-md outline-none", className), children: children }) }));
+}
+//# sourceMappingURL=ui.js.map

package/dist/editor/ui.js.map

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