@signal9/era-ui 12.1.2 → 13.0.0

package/dist/apps/notes/notes.svelte

@@ -1,501 +0,0 @@
-<script lang="ts">
-	/**
-	 * Notes — a complete, client-side notes app.
-	 *
-	 * An era port of the term/web notes app: same TipTap editor, same slash menu
-	 * and selection toolbar, same heading-tree index. Two things changed.
-	 *
-	 * PERSISTENCE. The original round-tripped every edit through a server via
-	 * TanStack Query, which forced a whole dirty-override layer — local edits had
-	 * to out-rank refetched query data, or an in-flight save clobbered what you
-	 * were typing. Here the store IS the source of truth and persistence is a
-	 * debounced write behind it, so the editor writes straight through and there
-	 * is nothing to reconcile.
-	 *
-	 * CHROME. Everything visible is an era primitive (Bar, Button, Input, Badge,
-	 * Popover, ScrollArea, AlertDialog, Skeleton) on era tokens, so the app
-	 * follows the density, surface, corners, motion, and font axes like any other
-	 * component in the library.
-	 */
-	import { onDestroy, onMount, untrack, type Snippet } from 'svelte';
-	import FileText from '@lucide/svelte/icons/file-text';
-	import Plus from '@lucide/svelte/icons/plus';
-	import Search from '@lucide/svelte/icons/search';
-	import Pin from '@lucide/svelte/icons/pin';
-	import PinOff from '@lucide/svelte/icons/pin-off';
-	import Trash2 from '@lucide/svelte/icons/trash-2';
-	import { Bar } from '../../ui/bar/index.js';
-	import { Badge } from '../../ui/badge/index.js';
-	import { Button } from '../../ui/button/index.js';
-	import { Input } from '../../ui/input/index.js';
-	import { Skeleton } from '../../ui/skeleton/index.js';
-	import * as AlertDialog from '../../ui/alert-dialog/index.js';
-	import * as ContextMenu from '../../ui/context-menu/index.js';
-	import * as Popover from '../../ui/popover/index.js';
-	import * as ScrollArea from '../../ui/scroll-area/index.js';
-	import { cn, keys } from '../../utils/index.js';
-	import NoteEditor from './note-editor.svelte';
-	import { NotesStore, localStorageAdapter, type NotesAdapter } from './notes-store.svelte.js';
-	import type { Note, NoteInit, TiptapDocument } from './types.js';
-
-	interface Props {
-		/**
-		 * Bring your own store — for a custom adapter, or to share one set of
-		 * notes between two mounted views. When supplied, the host owns its
-		 * lifecycle: this component will not destroy it on unmount.
-		 */
-		store?: NotesStore;
-		/** Persistence for the store this component creates. Ignored if `store` is set. */
-		adapter?: NotesAdapter;
-		/** `localStorage` key for the default adapter. Ignored if `store`/`adapter` is set. */
-		storageKey?: string;
-		/** The open note. Bindable, so a host can deep-link or restore a session. */
-		noteId?: string | null;
-		/** Notes created only when storage comes back empty — a first-run sample. */
-		seed?: NoteInit[];
-		/**
-		 * The pane hosting this app, if any. Structural on purpose — an os-layer
-		 * `AppPane` satisfies it as-is, and Notes never has to import the os layer.
-		 * When provided, the document header (icon picker, title, save status)
-		 * moves out of the editor area and into the pane bar's CENTRE slot, the
-		 * way the reference terminal app titles its notes window; it is cleared
-		 * again on unmount. Omit it and the header renders above the editor as a
-		 * normal in-app bar.
-		 */
-		pane?: { center?: Snippet } | null;
-		class?: string;
-	}
-
-	let {
-		store: providedStore,
-		adapter,
-		storageKey,
-		noteId = $bindable(null),
-		seed,
-		pane,
-		class: className
-	}: Props = $props();
-
-	// Resolved once, on purpose — untrack() is the declaration of that intent, not
-	// a workaround. A store swapped in mid-flight would strand the notes currently
-	// on screen and the editor mounted over them.
-	const owned = untrack(() => providedStore === undefined);
-	const store = untrack(
-		() => providedStore ?? new NotesStore({ adapter: adapter ?? localStorageAdapter(storageKey) })
-	);
-
-	let query = $state('');
-	let pendingDelete = $state<string | null>(null);
-	let iconPickerOpen = $state(false);
-
-	const visible = $derived(store.search(query));
-	const selected = $derived(store.get(noteId));
-	const pendingDeleteNote = $derived(store.get(pendingDelete));
-
-	/** A compact glyph set — enough to tell notes apart at a glance, no picker UI. */
-	const ICON_ROWS = [
-		['📝', '📋', '📌', '💡', '🔥', '⭐'],
-		['🎯', '🚀', '🔧', '📦', '🔒', '🔑'],
-		['💻', '🤖', '🧠', '⚡', '🔍', '🌐']
-	];
-
-	onMount(async () => {
-		// `loading` is only true before a first successful load, so this is also the
-		// flag for "this mount is the one that hydrated the store". Seeding keys off
-		// it rather than off `owned`: a second view sharing an already-loaded store
-		// must not seed again, but a HOST-supplied store that comes back empty
-		// should still get its first-run notes.
-		const hydrating = store.loading;
-		if (hydrating) await store.load();
-		if (hydrating && seed?.length && store.notes.length === 0) {
-			for (const init of seed) store.create(init);
-		}
-		if (!store.get(noteId)) noteId = store.ordered[0]?.id ?? null;
-	});
-
-	onDestroy(() => {
-		if (owned) store.destroy();
-	});
-
-	// Claim the pane bar's centre for the document header. An effect rather than
-	// a one-shot: `pane` can arrive late (the docs shell finds its Reader pane
-	// after mount) or change identity, and each run releases the previous claim.
-	// The guard on the cleanup matters — if some later occupant already replaced
-	// the snippet, unmounting Notes must not blank THEIR chrome.
-	$effect(() => {
-		const host = pane;
-		if (!host) return;
-		host.center = paneHeader;
-		return () => {
-			if (host.center === paneHeader) host.center = undefined;
-		};
-	});
-
-	function createNote() {
-		const note = store.create();
-		noteId = note.id;
-		query = '';
-	}
-
-	function confirmDelete() {
-		const id = pendingDelete;
-		pendingDelete = null;
-		if (!id) return;
-		store.remove(id);
-		if (noteId === id) noteId = store.ordered[0]?.id ?? null;
-	}
-
-	/** Short relative age — the list has a single cell for it, so it must stay narrow. */
-	function formatAge(ts: number) {
-		const d = Date.now() - ts;
-		if (d < 60_000) return 'now';
-		if (d < 3_600_000) return `${Math.floor(d / 60_000)}m`;
-		if (d < 86_400_000) return `${Math.floor(d / 3_600_000)}h`;
-		return new Date(ts).toLocaleDateString();
-	}
-
-	function onRowKeydown(event: KeyboardEvent) {
-		if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp') return;
-		event.preventDefault();
-		const row = event.currentTarget as HTMLElement;
-		const next = event.key === 'ArrowDown' ? row.nextElementSibling : row.previousElementSibling;
-		(next as HTMLElement | null)?.focus();
-	}
-</script>
-
-{#snippet iconPicker(note: Note)}
-	<Popover.Root bind:open={iconPickerOpen}>
-		<Popover.Trigger icon size="pill" aria-label="Change icon" title="Change icon">
-			{#if note.icon}
-				<span aria-hidden="true">{note.icon}</span>
-			{:else}
-				<FileText />
-			{/if}
-		</Popover.Trigger>
-		<Popover.Content align="start" class="w-max">
-			<div class="flex flex-col gap-gutter">
-				{#each ICON_ROWS as row, r (r)}
-					<div class="flex gap-gutter">
-						{#each row as glyph (glyph)}
-							<Button
-								icon
-								size="control"
-								active={note.icon === glyph}
-								aria-label={glyph}
-								onclick={() => {
-									store.setIcon(note.id, glyph);
-									iconPickerOpen = false;
-								}}
-							>
-								{glyph}
-							</Button>
-						{/each}
-					</div>
-				{/each}
-				{#if note.icon}
-					<Button
-						size="chip"
-						class="w-full"
-						onclick={() => {
-							store.setIcon(note.id, null);
-							iconPickerOpen = false;
-						}}
-					>
-						Clear icon
-					</Button>
-				{/if}
-			</div>
-		</Popover.Content>
-	</Popover.Root>
-{/snippet}
-
-<!-- The document header, pane-bar edition: the same icon picker and title,
-     compacted for the bar's centre track. data-pane-control is what makes an
-     EDITABLE title possible inside a drag zone — a press on the cluster means
-     caret/click, everywhere else on the bar still means drag. The input is
-     content-sized (field-sizing) so the cluster hugs the title and stays
-     optically centred; the status badge hangs OFF the flow (absolute, past the
-     right edge) so saved/error appearing never nudges the centred title. -->
-{#snippet titleField(note: Note, cls: string)}
-	<Input
-		reveal
-		size="pill"
-		class={cls}
-		aria-label="Note title"
-		placeholder="Untitled"
-		value={note.title}
-		oninput={(e: Event & { currentTarget: HTMLInputElement }) =>
-			store.update(note.id, { title: e.currentTarget.value })}
-	/>
-{/snippet}
-
-{#snippet statusBadge()}
-	{#if store.status === 'saved'}
-		<Badge tone="success">saved</Badge>
-	{:else if store.status === 'error'}
-		<Badge tone="destructive" title={store.lastError ?? undefined}>error</Badge>
-	{/if}
-{/snippet}
-
-{#snippet paneHeader()}
-	{#if selected}
-		<div class="relative flex min-w-0 items-center gap-gutter" data-pane-control>
-			{@render iconPicker(selected)}
-			{@render titleField(selected, 'field-sizing-content max-w-56 min-w-0 text-center')}
-			<!-- Absolutely positioned, so the badge appearing never nudges the
-			     centred title; empty when the status is quiet, which costs
-			     nothing off-flow. -->
-			<span class="absolute top-1/2 left-full ml-gutter -translate-y-1/2">
-				{@render statusBadge()}
-			</span>
-		</div>
-	{/if}
-{/snippet}
-
-<div
-	class={cn('flex h-full min-h-0 text-body text-fg', className)}
-	use:keys={{
-		// Persistence is already debounced; Ctrl/Cmd-S is the reassurance gesture
-		// people press anyway, wired to a real immediate flush.
-		'$mod+s': (e) => {
-			e.preventDefault();
-			void store.flush();
-		}
-	}}
->
-	<!-- Sidebar: filter + note list -->
-	<div class="flex w-56 shrink-0 flex-col border-r border-divider-faded">
-		<!-- content="pill": 24/30/36/48 of chrome around an 18/20/22/26 field and
-		     button, with Bar deriving the two-tier concentric inset. A notes sidebar
-		     is chrome around a list; at the lg/md pairing it was a 32px bar over
-		     24px rows and the chrome outweighed the content. This is the tier pair
-		     term's notes app uses — its hardcoded 3px is what Bar now derives at
-		     dense. The field keeps its fill: xxs is the smallest tier a real field
-		     fits on. -->
-		<!-- The divider is drawn OUTSIDE the box, exactly as Pane.Handle draws its
-		     own: a border consumes a pixel of the bar's content box, so its children
-		     centred in 23px and sat 2.5px from the top against a 3px wall. Outset
-		     costs no layout, so the bar keeps its full tier height and every child
-		     sits the wall's distance from all four edges. -->
-		<Bar size="control" content="pill" divider class="rounded-none">
-			<Input
-				icon={Search}
-				size="pill"
-				class="min-w-0 flex-1"
-				type="text"
-				placeholder="Filter…"
-				aria-label="Filter notes"
-				bind:value={query}
-			/>
-			<Button icon size="pill" aria-label="New note" title="New note" onclick={createNote}>
-				<Plus />
-			</Button>
-		</Bar>
-
-		{#if store.loading}
-			<div class="flex flex-col gap-gutter p-gutter">
-				{#each Array.from({ length: 5 }, (_, i) => i) as i (i)}
-					<Skeleton class="h-control rounded-control" />
-				{/each}
-			</div>
-		{:else if visible.length === 0}
-			<!-- No call to action here: the document pane already carries the primary
-			     one, and the bar's + is always within reach. Two competing CTAs for
-			     an empty list reads as indecision. -->
-			<div
-				class="flex flex-1 flex-col items-center justify-center gap-gutter p-section text-center"
-			>
-				<p class="text-muted">{query ? 'No matches' : 'No notes yet'}</p>
-			</div>
-		{:else}
-			<ScrollArea.Root class="min-h-0 flex-1 rounded-none">
-				<ScrollArea.Viewport>
-					<div class="flex flex-col gap-gutter p-gutter" role="listbox" aria-label="Notes">
-						{#each visible as note (note.id)}
-							{@const current = note.id === noteId}
-							<!-- The row is the selectable option; the pin/delete buttons inside it
-							     are separate actions, so they stop propagation rather than
-							     selecting the note out from under the click.
-							     Right-click opens the same two actions as a real ContextMenu.
-							     `child` delegation is load-bearing: the trigger's props land ON
-							     the row instead of wrapping it, so the row stays a direct
-							     role="option" child of the listbox. A wrapper element there
-							     would put a non-option between them and break the relationship
-							     screen readers rely on.
-							     rounded-control, not rounded-menu-item: item-rd is the radius for a row
-							     inside a PANEL (it subtracts the panel's frame inset). A list
-							     row on a plain surface takes its own tier radius — the
-							     conversations-rail pattern. -->
-							<ContextMenu.Root>
-								<ContextMenu.Trigger>
-									{#snippet child({ props })}
-										<div
-											{...props}
-											class="group/row flex h-control cursor-pointer items-center gap-pill-inset-control rounded-control px-pill-inset-control leading-none {current
-												? 'bg-hover text-bright shadow-pressed'
-												: 'hover:bg-highlight hover:shadow-highlight'}"
-											role="option"
-											aria-selected={current}
-											tabindex="0"
-											onclick={() => (noteId = note.id)}
-											onkeydown={(e: KeyboardEvent) => {
-												if (e.key === 'Enter' || e.key === ' ') {
-													e.preventDefault();
-													noteId = note.id;
-													return;
-												}
-												onRowKeydown(e);
-											}}
-										>
-											<span class="flex size-pill shrink-0 items-center justify-center">
-												{#if note.icon}
-													{note.icon}
-												{:else}
-													<FileText class="size-glyph-pill text-muted" />
-												{/if}
-											</span>
-
-											<span class="min-w-0 flex-1 truncate">{note.title || 'Untitled'}</span>
-
-											<!-- One cell, two occupants: the age at rest, the actions on
-								     hover. Swapping them in place keeps the row from reflowing.
-								     At rest EVERY row shows its age and nothing else. A pinned
-								     row used to put a pin glyph here instead — the same glyph,
-								     in the same slot, as the pin BUTTON one state away — so a
-								     pinned row read as a row whose actions were stuck on. Being
-								     pinned is already visible: those rows sort to the top, and
-								     the button carries its latched state once you are on the
-								     row. -->
-											<span class="shrink-0 text-muted group-hover/row:hidden">
-												{formatAge(note.updatedAt)}
-											</span>
-											<span
-												class="hidden shrink-0 items-center gap-pill-inset-control group-hover/row:flex"
-											>
-												<Button
-													icon
-													size="pill"
-													aria-label={note.pinned ? 'Unpin note' : 'Pin note'}
-													title={note.pinned ? 'Unpin note' : 'Pin note'}
-													active={note.pinned}
-													onclick={(e: MouseEvent) => {
-														e.stopPropagation();
-														store.togglePin(note.id);
-													}}
-												>
-													{#if note.pinned}<PinOff />{:else}<Pin />{/if}
-												</Button>
-												<Button
-													icon
-													size="pill"
-													tone="destructive"
-													aria-label="Delete note"
-													title="Delete note"
-													onclick={(e: MouseEvent) => {
-														e.stopPropagation();
-														pendingDelete = note.id;
-													}}
-												>
-													<Trash2 />
-												</Button>
-											</span>
-										</div>
-									{/snippet}
-								</ContextMenu.Trigger>
-								<ContextMenu.Content>
-									<ContextMenu.Item onSelect={() => store.togglePin(note.id)}>
-										{#if note.pinned}
-											<PinOff class="size-icon text-muted" />
-											Unpin note
-										{:else}
-											<Pin class="size-icon text-muted" />
-											Pin note
-										{/if}
-									</ContextMenu.Item>
-									<!-- No separator: a rule groups things, and two actions on one row
-									     are one group — it was drawing a boundary through the middle of
-									     a pair. The panel's gutter gives them their own breathing room. -->
-									<!-- Routed through the same confirm dialog the toolbar button
-									     uses, not a direct delete: a destructive action should not
-									     get easier to reach by arriving from a different gesture. -->
-									<ContextMenu.Item onSelect={() => (pendingDelete = note.id)}>
-										<Trash2 class="size-icon text-destructive" />
-										Delete note
-									</ContextMenu.Item>
-								</ContextMenu.Content>
-							</ContextMenu.Root>
-						{/each}
-					</div>
-				</ScrollArea.Viewport>
-				<ScrollArea.Scrollbar orientation="vertical">
-					<ScrollArea.Thumb />
-				</ScrollArea.Scrollbar>
-			</ScrollArea.Root>
-		{/if}
-	</div>
-
-	<!-- Document pane -->
-	<div class="flex min-w-0 flex-1 flex-col">
-		{#if selected}
-			<!-- Matches the sidebar's filter bar exactly — the two headers sit side by
-			     side across the top of the app, so they must be the same tier. -->
-			<!-- Same outset divider as the sidebar's filter bar above. -->
-			<!-- Rendered only when no pane hosts the app — with a pane, the same
-			     header (see the snippets below) lives in the pane bar's centre and
-			     drawing it twice would title the document twice. -->
-			{#if !pane}
-				<Bar size="control" content="pill" divider class="rounded-none">
-					{@render iconPicker(selected)}
-					{@render titleField(selected, 'min-w-0 flex-1')}
-					<!-- Fixed-width so the badge appearing and clearing never nudges the
-					     title field; `saving` is deliberately silent — the badge only
-					     reports a settled outcome. -->
-					<span class="flex w-16 shrink-0 justify-end">
-						{@render statusBadge()}
-					</span>
-				</Bar>
-			{/if}
-
-			<div class="min-h-0 flex-1 overflow-x-hidden overflow-y-auto p-card">
-				<!-- ProseMirror owns the document once running, so switching notes
-				     rebuilds the editor rather than pushing new content into it. -->
-				{#key selected.id}
-					<NoteEditor
-						content={selected.content}
-						onUpdate={(json) => store.update(selected.id, { content: json as TiptapDocument })}
-					/>
-				{/key}
-			</div>
-		{:else}
-			<div class="flex flex-1 flex-col items-center justify-center gap-gutter p-section">
-				<p class="text-muted">
-					{store.notes.length === 0 ? 'Create a note to get started' : 'Select a note'}
-				</p>
-				{#if store.notes.length === 0}
-					<Button onclick={createNote}>
-						<Plus />
-						New note
-					</Button>
-				{/if}
-			</div>
-		{/if}
-	</div>
-</div>
-
-<AlertDialog.Root
-	open={pendingDelete !== null}
-	onOpenChange={(open) => {
-		if (!open) pendingDelete = null;
-	}}
->
-	<AlertDialog.Content>
-		<AlertDialog.Title>Delete note</AlertDialog.Title>
-		<AlertDialog.Description>
-			“{pendingDeleteNote?.title || 'Untitled'}” will be removed. This cannot be undone.
-		</AlertDialog.Description>
-		<div class="flex justify-end gap-gutter">
-			<AlertDialog.Cancel>Cancel</AlertDialog.Cancel>
-			<AlertDialog.Action tone="destructive" onclick={confirmDelete}>Delete</AlertDialog.Action>
-		</div>
-	</AlertDialog.Content>
-</AlertDialog.Root>

package/dist/apps/notes/notes.svelte.d.ts

@@ -1,53 +0,0 @@
-/**
-     * Notes — a complete, client-side notes app.
-     *
-     * An era port of the term/web notes app: same TipTap editor, same slash menu
-     * and selection toolbar, same heading-tree index. Two things changed.
-     *
-     * PERSISTENCE. The original round-tripped every edit through a server via
-     * TanStack Query, which forced a whole dirty-override layer — local edits had
-     * to out-rank refetched query data, or an in-flight save clobbered what you
-     * were typing. Here the store IS the source of truth and persistence is a
-     * debounced write behind it, so the editor writes straight through and there
-     * is nothing to reconcile.
-     *
-     * CHROME. Everything visible is an era primitive (Bar, Button, Input, Badge,
-     * Popover, ScrollArea, AlertDialog, Skeleton) on era tokens, so the app
-     * follows the density, surface, corners, motion, and font axes like any other
-     * component in the library.
-     */
-import { type Snippet } from 'svelte';
-import { NotesStore, type NotesAdapter } from './notes-store.svelte.js';
-import type { NoteInit } from './types.js';
-interface Props {
-    /**
-     * Bring your own store — for a custom adapter, or to share one set of
-     * notes between two mounted views. When supplied, the host owns its
-     * lifecycle: this component will not destroy it on unmount.
-     */
-    store?: NotesStore;
-    /** Persistence for the store this component creates. Ignored if `store` is set. */
-    adapter?: NotesAdapter;
-    /** `localStorage` key for the default adapter. Ignored if `store`/`adapter` is set. */
-    storageKey?: string;
-    /** The open note. Bindable, so a host can deep-link or restore a session. */
-    noteId?: string | null;
-    /** Notes created only when storage comes back empty — a first-run sample. */
-    seed?: NoteInit[];
-    /**
-     * The pane hosting this app, if any. Structural on purpose — an os-layer
-     * `AppPane` satisfies it as-is, and Notes never has to import the os layer.
-     * When provided, the document header (icon picker, title, save status)
-     * moves out of the editor area and into the pane bar's CENTRE slot, the
-     * way the reference terminal app titles its notes window; it is cleared
-     * again on unmount. Omit it and the header renders above the editor as a
-     * normal in-app bar.
-     */
-    pane?: {
-        center?: Snippet;
-    } | null;
-    class?: string;
-}
-declare const Notes: import("svelte").Component<Props, {}, "noteId">;
-type Notes = ReturnType<typeof Notes>;
-export default Notes;

package/dist/apps/notes/tree.d.ts

@@ -1,70 +0,0 @@
-/**
- * Notes tree index — a hierarchical table of contents built by walking a
- * TipTap document's heading structure.
- *
- * This is the retrieval half of the app. Instead of embedding notes and
- * hoping vector similarity lands on the right paragraph, a model is handed
- * `treeToText(tree)` as a table of contents and reasons about which section to
- * open — then `extractSection()` returns just that slice, structure intact
- * (PageIndex-style reasoning-based retrieval).
- *
- * Nothing here touches the editor or the DOM: it operates on stored documents,
- * so it is equally usable from a tool handler, a worker, or a build step.
- */
-import type { TiptapDocument, TiptapNode } from './types.js';
-export interface NoteTreeNode {
-    title: string;
-    noteId?: string;
-    headingId?: string;
-    /** 0=root, 1=note, 2=H1, 3=H2, 4=H3 — heading level shifted by the note row. */
-    level: number;
-    /** Words in this section's own content, not its children's. */
-    wordCount: number;
-    children: NoteTreeNode[];
-}
-export interface SectionResult {
-    /** `Note Title > H2 > H3` */
-    headingPath: string;
-    /** Markdown for this section — structure-preserving, not flattened text. */
-    content: string;
-    wordCount: number;
-}
-export interface SectionNodes {
-    headingPath: string;
-    nodes: TiptapNode[];
-}
-/** Build a tree for one note's document. */
-export declare function buildNoteTree(noteId: string, title: string, doc: TiptapDocument): NoteTreeNode;
-/** Combine every note into one index tree. */
-export declare function buildGlobalTree(notes: Array<{
-    id: string;
-    title: string;
-    content: TiptapDocument;
-}>): NoteTreeNode;
-/** Node count below (and including) this node. */
-export declare function countNodes(node: NoteTreeNode): number;
-/** Total words in this subtree. */
-export declare function totalWords(node: NoteTreeNode): number;
-/**
- * Render the tree as YAML-shaped key/value text for a model to read.
- *
- * YAML-style indented pairs beat JSON on nested data in the 2025 retrieval
- * benchmarks, and the labelled fields (`id`, `hid`) are copy-pasteable straight
- * back into a `get(id)` / `extractSection(noteId, headingId)` call, which is
- * the whole point of handing over a TOC.
- */
-export declare function treeToText(tree: NoteTreeNode): string;
-/**
- * The raw nodes of one section: everything between the target heading and the
- * next heading of the same or a higher level, plus the breadcrumb that led to
- * it. Callers pick their own serialisation.
- */
-export declare function extractSectionNodes(noteTitle: string, doc: TiptapDocument, targetHeadingId: string): SectionNodes | null;
-/**
- * One section, serialised to markdown.
- *
- * Markdown rather than flattened text on purpose: plain-text extraction garbles
- * lists, tables, and code blocks, which is exactly the structure a model needs
- * to answer from a retrieved section.
- */
-export declare function extractSection(noteTitle: string, doc: TiptapDocument, targetHeadingId: string): SectionResult | null;