@atmo-dev/kit 0.0.0-stage → 0.0.2

package/dist/components/login/recent-accounts.js

@@ -0,0 +1,87 @@
+import { cleanActors, isActorSummary } from './search.js';
+export const RECENT_ACCOUNTS_STORAGE_KEY = 'atmo-kit:recent-accounts:v1';
+function target(storage) {
+    try {
+        return storage === null
+            ? undefined
+            : (storage ?? (typeof localStorage !== 'undefined' ? localStorage : undefined));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function recentAccountLimit(max = 4) {
+    return Number.isFinite(max) ? Math.max(0, Math.min(20, Math.trunc(max))) : 4;
+}
+export function loadRecentAccounts({ storage, key = RECENT_ACCOUNTS_STORAGE_KEY, max = 4 } = {}) {
+    try {
+        const data = JSON.parse(target(storage)?.getItem(key) ?? 'null');
+        if (!data || typeof data !== 'object')
+            return [];
+        // Accept Fox UI's origin-local recent-logins record when the caller selects that key.
+        const raw = 'version' in data && data.version === 1 && 'accounts' in data && Array.isArray(data.accounts)
+            ? data.accounts
+            : Object.values(data);
+        const rows = raw.filter(isActorSummary).map((actor) => ({
+            ...cleanActors([actor], 1)[0],
+            lastUsedAt: 'lastUsedAt' in actor &&
+                typeof actor.lastUsedAt === 'string' &&
+                Number.isFinite(Date.parse(actor.lastUsedAt))
+                ? actor.lastUsedAt
+                : new Date(0).toISOString()
+        }));
+        const seen = new Set();
+        return rows
+            .sort((a, b) => Date.parse(b.lastUsedAt) - Date.parse(a.lastUsedAt))
+            .filter((actor) => {
+            if (seen.has(actor.did))
+                return false;
+            seen.add(actor.did);
+            return true;
+        })
+            .slice(0, recentAccountLimit(max));
+    }
+    catch {
+        return [];
+    }
+}
+export function writeRecentAccounts(accounts, { storage, key = RECENT_ACCOUNTS_STORAGE_KEY, max = 4 } = {}) {
+    const seen = new Set();
+    const next = accounts
+        .filter(isActorSummary)
+        .filter((actor) => {
+        if (seen.has(actor.did))
+            return false;
+        seen.add(actor.did);
+        return true;
+    })
+        .slice(0, recentAccountLimit(max))
+        .map((actor) => ({
+        ...cleanActors([actor], 1)[0],
+        lastUsedAt: 'lastUsedAt' in actor && typeof actor.lastUsedAt === 'string'
+            ? actor.lastUsedAt
+            : new Date().toISOString()
+    }));
+    try {
+        const store = target(storage);
+        if (next.length)
+            store?.setItem(key, JSON.stringify({ version: 1, accounts: next }));
+        else
+            store?.removeItem(key);
+    }
+    catch {
+        /* Blocked/full storage must not break login. */
+    }
+    return next;
+}
+export function saveRecentAccount(actor, options = {}) {
+    if (!isActorSummary(actor))
+        return loadRecentAccounts(options);
+    return writeRecentAccounts([
+        { ...actor, lastUsedAt: new Date().toISOString() },
+        ...loadRecentAccounts(options).filter((account) => account.did !== actor.did && account.handle !== actor.handle)
+    ], options);
+}
+export function removeRecentAccount(did, options = {}) {
+    return writeRecentAccounts(loadRecentAccounts(options).filter((account) => account.did !== did), options);
+}

package/dist/components/login/search.d.ts

@@ -0,0 +1,9 @@
+import type { ActorSearch, ActorSummary } from './types.js';
+export declare function isActorSummary(value: unknown): value is ActorSummary;
+export declare function cleanActors(values: readonly unknown[], limit?: number): ActorSummary[];
+/** Explicitly opt into public AppView search. The form never calls this by default. */
+export declare function createActorSearch({ host, limit, fetch: fetcher }?: {
+    host?: string;
+    limit?: number;
+    fetch?: typeof globalThis.fetch;
+}): ActorSearch;

package/dist/components/login/search.js

@@ -0,0 +1,47 @@
+import { isValidHandle } from './handle.js';
+export function isActorSummary(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const actor = value;
+    return (typeof actor.did === 'string' &&
+        actor.did.startsWith('did:') &&
+        actor.did.length > 4 &&
+        typeof actor.handle === 'string' &&
+        actor.handle !== 'handle.invalid' &&
+        isValidHandle(actor.handle));
+}
+export function cleanActors(values, limit = 6) {
+    const seen = new Set();
+    return values
+        .filter(isActorSummary)
+        .filter((actor) => {
+        if (seen.has(actor.did))
+            return false;
+        seen.add(actor.did);
+        return true;
+    })
+        .slice(0, limit)
+        .map((actor) => ({
+        did: actor.did,
+        handle: actor.handle,
+        displayName: typeof actor.displayName === 'string' ? actor.displayName : undefined,
+        avatar: typeof actor.avatar === 'string' && /^https?:\/\//i.test(actor.avatar)
+            ? actor.avatar
+            : undefined
+    }));
+}
+/** Explicitly opt into public AppView search. The form never calls this by default. */
+export function createActorSearch({ host = 'https://public.api.bsky.app', limit = 6, fetch: fetcher = globalThis.fetch } = {}) {
+    const count = Number.isFinite(limit) ? Math.max(1, Math.min(25, Math.trunc(limit))) : 6;
+    return async (query, signal) => {
+        const url = new URL('/xrpc/app.bsky.actor.searchActorsTypeahead', host);
+        url.searchParams.set('q', query.trim());
+        url.searchParams.set('limit', String(count));
+        const response = await fetcher(url, { signal, headers: { accept: 'application/json' } });
+        if (!response.ok)
+            throw new Error('Account search is unavailable. You can still enter your full handle.');
+        const data = await response.json();
+        const actors = data && typeof data === 'object' && 'actors' in data ? data.actors : undefined;
+        return Array.isArray(actors) ? cleanActors(actors, count) : [];
+    };
+}

package/dist/components/login/types.d.ts

@@ -0,0 +1,27 @@
+import type { IconNode } from '@sketchyicons/svelte';
+/** Profile data for display, never evidence of an authenticated session. */
+export type ActorSummary = {
+    did: string;
+    handle: string;
+    displayName?: string;
+    avatar?: string;
+};
+export type ActorSearch = (query: string, signal: AbortSignal) => Promise<readonly ActorSummary[]>;
+export type LoginStep = 'login' | 'permissions' | 'signup';
+export type LoginPermission = {
+    id: string;
+    label: string;
+    description: string;
+    scopes: readonly string[];
+    icon?: IconNode;
+    required?: boolean;
+    defaultSelected?: boolean;
+};
+/** Requested scopes, not proof of the permissions ultimately granted by OAuth. */
+export type LoginOptions = {
+    permissionIds: string[];
+    scopes: string[];
+};
+export type LoginResult = boolean | void;
+export type LoginCallback = (handle: string, actor?: ActorSummary, options?: LoginOptions) => LoginResult | Promise<LoginResult>;
+export declare const actorName: (actor: ActorSummary) => string;

package/dist/components/login/types.js

@@ -0,0 +1 @@
+export const actorName = (actor) => actor.displayName?.trim() || `@${actor.handle}`;

package/dist/confetti.d.ts

@@ -0,0 +1,2 @@
+/** Optional, explicit celebration. No global setup or effects on import. */
+export declare function launchConfetti(): Promise<void>;

package/dist/confetti.js

@@ -0,0 +1,13 @@
+/** Optional, explicit celebration. No global setup or effects on import. */
+export async function launchConfetti() {
+    if (typeof window === 'undefined' ||
+        window.matchMedia('(prefers-reduced-motion: reduce)').matches)
+        return;
+    const { default: confetti } = await import('canvas-confetti');
+    await confetti({
+        particleCount: 90,
+        spread: 65,
+        origin: { y: 0.7 },
+        disableForReducedMotion: true
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+export { default as Button } from './components/Button.svelte';
+export type { ButtonProps } from './components/Button.svelte';
+export { default as IconButton } from './components/IconButton.svelte';
+export { default as Input } from './components/Input.svelte';
+export type { InputProps } from './components/Input.svelte';
+export { default as Textarea } from './components/Textarea.svelte';
+export { default as Select } from './components/Select.svelte';
+export { default as Checkbox } from './components/Checkbox.svelte';
+export { default as Label } from './components/Label.svelte';
+export { default as PageTitle } from './components/PageTitle.svelte';
+export { default as Heading } from './components/Heading.svelte';
+export { default as Subheading } from './components/Subheading.svelte';
+export { default as Surface } from './components/Surface.svelte';
+export { default as Avatar } from './components/Avatar.svelte';
+export { default as InsetImage } from './components/InsetImage.svelte';
+export { default as Badge } from './components/Badge.svelte';
+export { default as Modal } from './components/Modal.svelte';
+export { default as Tabs } from './components/Tabs.svelte';
+export type { TabItem } from './components/Tabs.svelte';
+export { default as Icon } from './components/Icon.svelte';
+export type { IconNode, SketchyIconProps } from '@sketchyicons/svelte';
+export { default as IconRail } from './components/IconRail.svelte';
+export type { IconRailItem } from './components/IconRail.svelte';
+export { default as WorkspaceSidebar } from './components/WorkspaceSidebar.svelte';
+export { default as LoginForm } from './components/login/LoginForm.svelte';
+export type { LoginFormProps } from './components/login/LoginForm.svelte';
+export { default as LoginDialog } from './components/login/LoginDialog.svelte';
+export type { LoginDialogProps } from './components/login/LoginDialog.svelte';
+export { default as ActorSearchField } from './components/login/ActorSearchField.svelte';
+export { default as RecentAccounts } from './components/login/RecentAccounts.svelte';
+export type { ActorSummary, ActorSearch, LoginCallback, LoginResult, LoginPermission, LoginOptions, LoginStep } from './components/login/types.js';
+export { createActorSearch } from './components/login/search.js';
+export { normalizeHandle, isValidHandle } from './components/login/handle.js';
+export { resolveLoginOptions, isPermissionSelected } from './components/login/permissions.js';
+export { loadRecentAccounts, writeRecentAccounts, saveRecentAccount, removeRecentAccount, RECENT_ACCOUNTS_STORAGE_KEY } from './components/login/recent-accounts.js';
+export type { RecentAccount, RecentAccountStorage, RecentAccountStorageOptions } from './components/login/recent-accounts.js';
+export { default as ToggleGroup } from './components/ToggleGroup.svelte';
+export { default as ToggleGroupItem } from './components/ToggleGroupItem.svelte';
+export { default as Popover } from './components/Popover.svelte';
+export { default as LinkCard } from './components/LinkCard.svelte';
+export { default as InlineEditor } from './components/InlineEditor.svelte';
+export { default as PostComposer } from './components/PostComposer.svelte';
+export { default as NestedComments } from './components/NestedComments.svelte';
+export { default as PostContent } from './components/PostContent.svelte';
+export { blueskyPostToPostData } from './social/posts.js';
+export type { PostData, PostEmbed, BlueskyPostView } from './social/posts.js';
+export { editorJsonToBlueskyPost, textToDoc, graphemeLength } from './social/richtext.js';
+export type { Facet } from './social/richtext.js';
+export type { Editor, JSONContent } from '@tiptap/core';
+export { launchConfetti } from './confetti.js';
+export { cn } from './utils.js';
+export { baseColors, accentColors } from './palettes.js';

package/dist/index.js

@@ -0,0 +1,40 @@
+export { default as Button } from './components/Button.svelte';
+export { default as IconButton } from './components/IconButton.svelte';
+export { default as Input } from './components/Input.svelte';
+export { default as Textarea } from './components/Textarea.svelte';
+export { default as Select } from './components/Select.svelte';
+export { default as Checkbox } from './components/Checkbox.svelte';
+export { default as Label } from './components/Label.svelte';
+export { default as PageTitle } from './components/PageTitle.svelte';
+export { default as Heading } from './components/Heading.svelte';
+export { default as Subheading } from './components/Subheading.svelte';
+export { default as Surface } from './components/Surface.svelte';
+export { default as Avatar } from './components/Avatar.svelte';
+export { default as InsetImage } from './components/InsetImage.svelte';
+export { default as Badge } from './components/Badge.svelte';
+export { default as Modal } from './components/Modal.svelte';
+export { default as Tabs } from './components/Tabs.svelte';
+export { default as Icon } from './components/Icon.svelte';
+export { default as IconRail } from './components/IconRail.svelte';
+export { default as WorkspaceSidebar } from './components/WorkspaceSidebar.svelte';
+export { default as LoginForm } from './components/login/LoginForm.svelte';
+export { default as LoginDialog } from './components/login/LoginDialog.svelte';
+export { default as ActorSearchField } from './components/login/ActorSearchField.svelte';
+export { default as RecentAccounts } from './components/login/RecentAccounts.svelte';
+export { createActorSearch } from './components/login/search.js';
+export { normalizeHandle, isValidHandle } from './components/login/handle.js';
+export { resolveLoginOptions, isPermissionSelected } from './components/login/permissions.js';
+export { loadRecentAccounts, writeRecentAccounts, saveRecentAccount, removeRecentAccount, RECENT_ACCOUNTS_STORAGE_KEY } from './components/login/recent-accounts.js';
+export { default as ToggleGroup } from './components/ToggleGroup.svelte';
+export { default as ToggleGroupItem } from './components/ToggleGroupItem.svelte';
+export { default as Popover } from './components/Popover.svelte';
+export { default as LinkCard } from './components/LinkCard.svelte';
+export { default as InlineEditor } from './components/InlineEditor.svelte';
+export { default as PostComposer } from './components/PostComposer.svelte';
+export { default as NestedComments } from './components/NestedComments.svelte';
+export { default as PostContent } from './components/PostContent.svelte';
+export { blueskyPostToPostData } from './social/posts.js';
+export { editorJsonToBlueskyPost, textToDoc, graphemeLength } from './social/richtext.js';
+export { launchConfetti } from './confetti.js';
+export { cn } from './utils.js';
+export { baseColors, accentColors } from './palettes.js';

package/dist/palettes.d.ts

@@ -0,0 +1,2 @@
+export declare const baseColors: readonly ["gray", "zinc", "neutral", "stone", "slate", "mist", "mauve", "olive", "taupe"];
+export declare const accentColors: readonly ["red", "orange", "amber", "yellow", "lime", "green", "emerald", "teal", "cyan", "sky", "blue", "indigo", "violet", "purple", "fuchsia", "pink", "rose"];

package/dist/palettes.js

@@ -0,0 +1,30 @@
+export const baseColors = [
+    'gray',
+    'zinc',
+    'neutral',
+    'stone',
+    'slate',
+    'mist',
+    'mauve',
+    'olive',
+    'taupe'
+];
+export const accentColors = [
+    'red',
+    'orange',
+    'amber',
+    'yellow',
+    'lime',
+    'green',
+    'emerald',
+    'teal',
+    'cyan',
+    'sky',
+    'blue',
+    'indigo',
+    'violet',
+    'purple',
+    'fuchsia',
+    'pink',
+    'rose'
+];

package/dist/social/mention-suggestions.d.ts

@@ -0,0 +1,35 @@
+import type { Editor } from '@tiptap/core';
+import type { ActorSearch, ActorSummary } from '../components/login/types.js';
+/** DOM is constructed with textContent: profile data never becomes HTML. */
+export declare function mentionSuggestions(search: ActorSearch, host: () => HTMLElement): {
+    char: string;
+    debounce: number;
+    minQueryLength: number;
+    items: ({ query }: {
+        query: string;
+    }) => Promise<ActorSummary[]>;
+    render: () => {
+        onStart: (props: {
+            items: ActorSummary[];
+            command: (actor: {
+                id: string;
+                label: string;
+            }) => void;
+            clientRect?: (() => DOMRect | null) | null;
+            editor: Editor;
+        }) => void;
+        onUpdate: (props: {
+            items: ActorSummary[];
+            command: (actor: {
+                id: string;
+                label: string;
+            }) => void;
+            clientRect?: (() => DOMRect | null) | null;
+            editor: Editor;
+        }) => void;
+        onKeyDown: ({ event }: {
+            event: KeyboardEvent;
+        }) => boolean;
+        onExit: () => void;
+    };
+};

package/dist/social/mention-suggestions.js

@@ -0,0 +1,122 @@
+/** DOM is constructed with textContent: profile data never becomes HTML. */
+export function mentionSuggestions(search, host) {
+    let controller;
+    let menu;
+    let selected = 0;
+    let current;
+    const close = () => {
+        menu?.remove();
+        menu = undefined;
+        current?.editor.view.dom.removeAttribute('aria-controls');
+        current?.editor.view.dom.removeAttribute('aria-activedescendant');
+        current?.editor.view.dom.setAttribute('aria-expanded', 'false');
+    };
+    const choose = (index) => {
+        const actor = current.items[index];
+        if (actor)
+            current.command({ id: actor.did, label: actor.handle });
+    };
+    function draw() {
+        if (!menu)
+            return;
+        menu.replaceChildren();
+        const rect = current.clientRect?.();
+        const bounds = host().getBoundingClientRect();
+        if (rect) {
+            menu.style.top = `${rect.bottom - bounds.top + host().scrollTop + 6}px`;
+            menu.style.left = `${Math.max(0, Math.min(rect.left - bounds.left, bounds.width - 280))}px`;
+        }
+        if (!current.items.length) {
+            const empty = document.createElement('p');
+            empty.role = 'option';
+            empty.setAttribute('aria-disabled', 'true');
+            empty.setAttribute('aria-selected', 'false');
+            empty.className = 'p-3 text-xs text-muted';
+            empty.textContent = 'No accounts found';
+            menu.append(empty);
+        }
+        current.items.forEach((actor, index) => {
+            const option = document.createElement('button');
+            option.type = 'button';
+            option.role = 'option';
+            option.id = `${menu.id}-${index}`;
+            option.setAttribute('aria-selected', String(index === selected));
+            option.className =
+                'block w-full rounded-ui px-3 py-2 text-left text-xs text-ink hover:bg-recess aria-selected:bg-recess';
+            const name = document.createElement('strong');
+            name.className = 'block truncate font-medium';
+            name.textContent = actor.displayName || actor.handle;
+            const handle = document.createElement('span');
+            handle.className = 'block truncate text-muted';
+            handle.textContent = `@${actor.handle}`;
+            option.append(name, handle);
+            option.onmousedown = (event) => event.preventDefault();
+            option.onclick = () => choose(index);
+            menu.append(option);
+        });
+        current.editor.view.dom.setAttribute('aria-controls', menu.id);
+        current.editor.view.dom.setAttribute('aria-expanded', 'true');
+        if (current.items.length)
+            current.editor.view.dom.setAttribute('aria-activedescendant', `${menu.id}-${selected}`);
+        else
+            current.editor.view.dom.removeAttribute('aria-activedescendant');
+    }
+    return {
+        char: '@',
+        debounce: 200,
+        minQueryLength: 1,
+        items: async ({ query }) => {
+            controller?.abort();
+            controller = new AbortController();
+            try {
+                return [...(await search(query, controller.signal))].slice(0, 6);
+            }
+            catch {
+                return [];
+            }
+        },
+        render: () => ({
+            onStart: (props) => {
+                current = props;
+                selected = 0;
+                menu = document.createElement('div');
+                menu.id = `${props.editor.view.dom.id}-mentions`;
+                menu.role = 'listbox';
+                menu.setAttribute('aria-label', 'Mention suggestions');
+                menu.className =
+                    'absolute z-60 w-70 max-w-full overflow-hidden rounded-ui border border-line bg-page p-1 font-sans text-ink';
+                host().append(menu);
+                draw();
+            },
+            onUpdate: (props) => {
+                current = props;
+                selected = 0;
+                draw();
+            },
+            onKeyDown: ({ event }) => {
+                if (event.key === 'Escape') {
+                    close();
+                    return true;
+                }
+                if (!current.items.length)
+                    return false;
+                if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+                    selected =
+                        (selected + (event.key === 'ArrowDown' ? 1 : -1) + current.items.length) %
+                            current.items.length;
+                    draw();
+                    return true;
+                }
+                if (event.key === 'Enter' || event.key === 'Tab') {
+                    choose(selected);
+                    return true;
+                }
+                return false;
+            },
+            onExit: () => {
+                controller?.abort();
+                close();
+            }
+        })
+    };
+}

package/dist/social/posts.d.ts

@@ -0,0 +1,95 @@
+import type { Facet } from './richtext.js';
+export type PostEmbed = {
+    type: 'images';
+    images: {
+        src: string;
+        fullsize?: string;
+        alt: string;
+        width?: number;
+        height?: number;
+    }[];
+} | {
+    type: 'external';
+    uri: string;
+    title: string;
+    description?: string;
+    image?: string;
+} | {
+    type: 'video';
+    playlist: string;
+    poster?: string;
+    alt?: string;
+} | {
+    type: 'quote';
+    post?: PostData;
+    unavailable?: boolean;
+};
+export type PostData = {
+    uri: string;
+    href: string;
+    author: {
+        did: string;
+        handle: string;
+        name: string;
+        avatar?: string;
+    };
+    text: string;
+    facets?: Facet[];
+    createdAt?: string;
+    replyCount?: number;
+    likeCount?: number;
+    embeds?: PostEmbed[];
+    replies?: PostData[];
+};
+/** The public AppView view shape; no session or network dependency. */
+export type BlueskyPostView = {
+    uri: string;
+    author: {
+        did: string;
+        handle: string;
+        displayName?: string;
+        avatar?: string;
+    };
+    record?: {
+        text?: string;
+        facets?: Facet[];
+        createdAt?: string;
+    };
+    value?: {
+        text?: string;
+        facets?: Facet[];
+        createdAt?: string;
+    };
+    embed?: BlueskyEmbedView;
+    embeds?: BlueskyEmbedView[];
+    replyCount?: number;
+    likeCount?: number;
+};
+type BlueskyEmbedView = {
+    $type?: string;
+    images?: {
+        thumb: string;
+        fullsize?: string;
+        alt: string;
+        aspectRatio?: {
+            width: number;
+            height: number;
+        };
+    }[];
+    external?: {
+        uri: string;
+        title: string;
+        description?: string;
+        thumb?: string;
+    };
+    playlist?: string;
+    thumbnail?: string;
+    alt?: string;
+    record?: BlueskyPostView & {
+        $type?: string;
+        record?: BlueskyPostView;
+    };
+    media?: BlueskyEmbedView;
+};
+export declare function blueskyPostToPostData(post: BlueskyPostView, depth?: number): PostData;
+export {};

package/dist/social/posts.js

@@ -0,0 +1,59 @@
+export function blueskyPostToPostData(post, depth = 0) {
+    const record = post.record ?? post.value;
+    const result = {
+        uri: post.uri,
+        href: `https://bsky.app/profile/${encodeURIComponent(post.author.did)}/post/${encodeURIComponent(post.uri.split('/').at(-1) ?? '')}`,
+        author: {
+            did: post.author.did,
+            handle: post.author.handle,
+            name: post.author.displayName || post.author.handle,
+            avatar: post.author.avatar
+        },
+        text: record?.text ?? '',
+        facets: record?.facets,
+        createdAt: record?.createdAt,
+        replyCount: post.replyCount,
+        likeCount: post.likeCount,
+        embeds: []
+    };
+    function add(embed) {
+        if (embed.images)
+            result.embeds.push({
+                type: 'images',
+                images: embed.images.map((image) => ({
+                    src: image.thumb,
+                    fullsize: image.fullsize,
+                    alt: image.alt,
+                    ...image.aspectRatio
+                }))
+            });
+        if (embed.external)
+            result.embeds.push({
+                type: 'external',
+                uri: embed.external.uri,
+                title: embed.external.title,
+                description: embed.external.description,
+                image: embed.external.thumb
+            });
+        if (embed.playlist)
+            result.embeds.push({
+                type: 'video',
+                playlist: embed.playlist,
+                poster: embed.thumbnail,
+                alt: embed.alt
+            });
+        if (embed.media)
+            add(embed.media);
+        if (embed.record && depth < 3) {
+            const quote = embed.record.record ?? embed.record;
+            result.embeds.push({
+                type: 'quote',
+                post: quote.author && quote.uri ? blueskyPostToPostData(quote, depth + 1) : undefined,
+                unavailable: !quote.author
+            });
+        }
+    }
+    for (const embed of post.embeds ?? (post.embed ? [post.embed] : []))
+        add(embed);
+    return result;
+}

package/dist/social/richtext.d.ts

@@ -0,0 +1,25 @@
+import type { JSONContent } from '@tiptap/core';
+export type Facet = {
+    index: {
+        byteStart: number;
+        byteEnd: number;
+    };
+    features: {
+        $type: string;
+        did?: string;
+        uri?: string;
+        tag?: string;
+    }[];
+};
+export declare function safeWebUrl(url: string | undefined): string | undefined;
+export declare function textToDoc(text: string): JSONContent;
+/** Serialize mention nodes first, then detect links/tags using UTF-8 byte offsets. */
+export declare function editorJsonToBlueskyPost(doc: JSONContent): {
+    text: string;
+    facets: Facet[];
+};
+export declare function richTextSegments(text: string, facets?: Facet[]): {
+    text: string;
+    href?: string;
+}[];
+export declare function graphemeLength(text: string): number;