@damiro/stylo 0.15.1 → 0.16.0

package/dist/types/sources.d.ts

@@ -0,0 +1,66 @@
+import type { ReactNode } from "react";
+/** One `[[wikilink]]` autocomplete candidate returned by `wikiLinkSource`. */
+export interface WikiLinkCompletion {
+    /** Written verbatim between `[[` and `]]`. */
+    target: string;
+    /**
+     * Shown in the dropdown in place of `target`. When it differs from `target`,
+     * the accepted link is written `[[target|label]]`.
+     */
+    label?: string;
+}
+/**
+ * Supplies `[[wikilink]]` autocomplete candidates. Called with the text typed
+ * after `[[` (before any `|`) while the caret sits inside an unclosed `[[…`;
+ * return the matches your index finds, already ordered — Stylo does not re-rank
+ * or filter. May be async (e.g. a vault search endpoint). Pass it to enable the
+ * feature; omit it and there is no wikilink completion. Read once, at mount.
+ * Affects the CodeMirror surfaces only (`source`, `split`, `in-place`).
+ */
+export type WikiLinkSource = (query: string) => readonly WikiLinkCompletion[] | Promise<readonly WikiLinkCompletion[]>;
+/** One `#tag` autocomplete candidate returned by `tagSource`. */
+export interface TagCompletion {
+    /** Written verbatim after `#`. No alias — tags have no `#tag|label` syntax. */
+    tag: string;
+}
+/**
+ * Supplies `#tag` autocomplete candidates. Called with the text typed after `#`
+ * while the caret sits inside an unclosed `#…` word; return the matches your
+ * index finds, already ordered — Stylo does not re-rank or filter. May be async
+ * (e.g. a tag-index lookup). Pass it to enable the feature; omit it and there is
+ * no tag completion. Read once, at mount. Never fires on a `# Heading` marker
+ * (the space breaks the match) or mid-word (`word#word`, a URL fragment).
+ */
+export type TagSource = (query: string) => readonly TagCompletion[] | Promise<readonly TagCompletion[]>;
+/**
+ * Resolves an `![[ref]]` embed (transclusion) to something to render. Called
+ * with the raw reference — everything between `![[` and `]]`, trimmed, with any
+ * `#heading` / `#^blockid` / `|size` suffix left intact for the host to parse.
+ * Stylo has no vault, so it cannot resolve the reference itself; it detects the
+ * `![[…]]` and renders whatever node you return in its place. May be async (a
+ * vault lookup, a fetch). Return `null` to leave the reference as literal text.
+ *
+ * Pass it to enable embeds; omit it and `![[…]]` stays literal. Works on
+ * `preview`, `split`, and the in-place canvas (ADR-009). A `![[…]]` alone on its
+ * line renders as a **block**; one mid-sentence renders **inline** — return
+ * phrasing content (not a block element) for the inline case. `![[…]]` inside
+ * code stays literal, and inside an **in-place table cell** it stays literal too
+ * (a table cell there is for editing tabular text; `preview` / `split` do
+ * transclude in cells). Give it a stable reference — the render pipeline
+ * rebuilds when its identity changes, and the in-place canvas reads it once at
+ * mount.
+ *
+ * Results are memoised by `ref` per function identity (so a scroll or a
+ * re-render does not re-resolve). If your source's output for a given `ref` can
+ * change over time, vary the `ref` or pass a new `embedSource` to invalidate.
+ * Rejections are not cached.
+ */
+export type EmbedSource = (ref: string) => ReactNode | Promise<ReactNode>;
+/** Which host resolver rejected, and the argument it was called with. */
+export interface ResolveErrorInfo {
+    /** The prop whose function threw or returned a rejected promise. */
+    source: "embedSource" | "wikiLinkSource" | "tagSource";
+    /** What it was asked to resolve — an `![[ref]]` reference, or the `[[` query. */
+    input: string;
+}
+//# sourceMappingURL=sources.d.ts.map

package/dist/types/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/types/sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,MAAM,KACV,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAA;AAE3E,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,MAAM,KACV,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;AAEzE,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,MAAM,EAAE,aAAa,GAAG,gBAAgB,GAAG,WAAW,CAAA;IACtD,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAA;CACd"}

package/dist/types/toolbar.d.ts

@@ -0,0 +1,72 @@
+import type { ReactNode } from "react";
+import type { EditorState } from "@codemirror/state";
+import type { EditorView } from "@codemirror/view";
+/**
+ * Built-in toolbar command identifiers. In a `ToolbarConfig["items"]` list,
+ * `"|"` inserts a visual separator. See ADR-002 §2.
+ */
+export type ToolbarCommandId = "undo" | "redo" | "save" | "search" | "h1" | "h2" | "h3" | "body" | "bold" | "italic" | "strike" | "underline" | "code" | "codeBlock" | "link" | "wikilink" | "quote" | "bulletList" | "orderedList" | "task" | "hr" | "frontmatter" | "table" | "math" | "mathBlock";
+/**
+ * A consumer-supplied toolbar button. Mixed into `ToolbarConfig["items"]`
+ * alongside the built-in ids. It runs against the same live `EditorView` the
+ * built-ins do; `isActive` / `disabled` are read back from the state on every
+ * selection, key, and pointer change, exactly like a built-in.
+ *
+ * No `keys` field: built-in shortcuts are compiled into CodeMirror's keymap at
+ * editor construction, so a custom binding would need its own keymap. Bind it
+ * yourself against `getView()` for now.
+ */
+export interface ToolbarCustomItem {
+    /**
+     * Stable identity, also the React key. Must not collide with a built-in id
+     * (`bold`, `h1`, …) or another custom item.
+     */
+    id: string;
+    /** Tooltip and accessible label. */
+    title: string;
+    /** Button content — an inline SVG, a glyph, a short label. */
+    icon: ReactNode;
+    /** Run against the live view. The return value is ignored. */
+    run: (view: EditorView) => void;
+    /** Reflected as the button's pressed state (`aria-pressed`, `data-active`). */
+    isActive?: (state: EditorState) => boolean;
+    /** When true, the button is rendered `disabled`. */
+    disabled?: (state: EditorState) => boolean;
+}
+/** One rendered slot: a built-in id, a `"|"` separator, or a custom button. */
+export type ToolbarItem = ToolbarCommandId | "|" | ToolbarCustomItem;
+export interface ToolbarConfig {
+    /**
+     * Ordered toolbar slots — built-in command ids, `"|"` separators, and
+     * {@link ToolbarCustomItem} objects, in any order. Omit for the full default
+     * bar.
+     */
+    items?: ToolbarItem[];
+    /**
+     * Wrap or replace the rendered bar. `bar` is the built-in
+     * `<div role="toolbar">` element; return it wrapped, with extra chrome
+     * appended, or ignore it entirely and return your own. `view` is `null` until
+     * the surface has mounted.
+     */
+    render?: (bar: ReactNode, ctx: {
+        view: EditorView | null;
+    }) => ReactNode;
+    /**
+     * Fix the bar to an edge of the **window** instead of wherever `<Stylo>`
+     * sits on the page. `"bottom"` (or `true`) rides above the on-screen
+     * keyboard, tracked via the `visualViewport` API; `"top"` pins to the top
+     * edge, which needs no keyboard tracking and can't be covered by it or by a
+     * platform's own input accessory bar. Off (`false`, the default) is right
+     * for a small embedded field; a host opts in deliberately for a
+     * full-screen editor. See the toolbar reference's "On touch" section.
+     */
+    sticky?: boolean | "top" | "bottom";
+    /**
+     * When `sticky` is set, whether the bar stays on screen the whole time
+     * (`"consistent"`, the default) or only while the editing surface actually
+     * has focus (`"dynamic"`) — faded out otherwise, so it doesn't sit over the
+     * content while the caret is elsewhere. Ignored when `sticky` is off.
+     */
+    stickyVisibility?: "consistent" | "dynamic";
+}
+//# sourceMappingURL=toolbar.d.ts.map

package/dist/types/toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../src/types/toolbar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,GACN,MAAM,GACN,QAAQ,GACR,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,MAAM,GACN,WAAW,GACX,MAAM,GACN,UAAU,GACV,OAAO,GACP,YAAY,GACZ,aAAa,GACb,MAAM,GACN,IAAI,GACJ,aAAa,GACb,OAAO,GACP,MAAM,GACN,WAAW,CAAA;AAEf;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAA;IACV,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,IAAI,EAAE,SAAS,CAAA;IACf,8DAA8D;IAC9D,GAAG,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAA;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAA;IAC1C,oDAAoD;IACpD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAA;CAC3C;AAED,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,GAAG,GAAG,iBAAiB,CAAA;AAEpE,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,CAAA;IACrB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE;QAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE,KAAK,SAAS,CAAA;IACxE;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAA;IACnC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CAC5C"}

package/dist/types.d.ts

@@ -1,408 +1,13 @@
-import type { ReactNode } from "react";
-import type { Language, LanguageDescription } from "@codemirror/language";
-import type { EditorState } from "@codemirror/state";
-import type { EditorView } from "@codemirror/view";
-export type StyloMode = "in-place" | "source" | "preview" | "split";
 /**
- * How `preview` (and the preview pane of `split`) treats the leading `---` YAML
- * block. `"hidden"` (default) drops it from the render; `"code"` renders it as a
- * styled `<pre class="stylo-frontmatter">` a consumer can restyle with its own
- * CSS. A parsed key/value panel is deferred (ADR-001, needs a YAML parser).
- */
-export type FrontmatterDisplay = "hidden" | "code";
-/**
- * Built-in toolbar command identifiers. In a `ToolbarConfig["items"]` list,
- * `"|"` inserts a visual separator. See ADR-002 §2.
- */
-export type ToolbarCommandId = "undo" | "redo" | "save" | "search" | "h1" | "h2" | "h3" | "body" | "bold" | "italic" | "strike" | "underline" | "code" | "codeBlock" | "link" | "wikilink" | "quote" | "bulletList" | "orderedList" | "task" | "hr" | "frontmatter" | "table" | "math" | "mathBlock";
-/**
- * A consumer-supplied toolbar button. Mixed into `ToolbarConfig["items"]`
- * alongside the built-in ids. It runs against the same live `EditorView` the
- * built-ins do; `isActive` / `disabled` are read back from the state on every
- * selection, key, and pointer change, exactly like a built-in.
- *
- * No `keys` field: built-in shortcuts are compiled into CodeMirror's keymap at
- * editor construction, so a custom binding would need its own keymap. Bind it
- * yourself against `getView()` for now.
- */
-export interface ToolbarCustomItem {
-    /**
-     * Stable identity, also the React key. Must not collide with a built-in id
-     * (`bold`, `h1`, …) or another custom item.
-     */
-    id: string;
-    /** Tooltip and accessible label. */
-    title: string;
-    /** Button content — an inline SVG, a glyph, a short label. */
-    icon: ReactNode;
-    /** Run against the live view. The return value is ignored. */
-    run: (view: EditorView) => void;
-    /** Reflected as the button's pressed state (`aria-pressed`, `data-active`). */
-    isActive?: (state: EditorState) => boolean;
-    /** When true, the button is rendered `disabled`. */
-    disabled?: (state: EditorState) => boolean;
-}
-/** One rendered slot: a built-in id, a `"|"` separator, or a custom button. */
-export type ToolbarItem = ToolbarCommandId | "|" | ToolbarCustomItem;
-export interface ToolbarConfig {
-    /**
-     * Ordered toolbar slots — built-in command ids, `"|"` separators, and
-     * {@link ToolbarCustomItem} objects, in any order. Omit for the full default
-     * bar.
-     */
-    items?: ToolbarItem[];
-    /**
-     * Wrap or replace the rendered bar. `bar` is the built-in
-     * `<div role="toolbar">` element; return it wrapped, with extra chrome
-     * appended, or ignore it entirely and return your own. `view` is `null` until
-     * the surface has mounted.
-     */
-    render?: (bar: ReactNode, ctx: {
-        view: EditorView | null;
-    }) => ReactNode;
-    /**
-     * Fix the bar to an edge of the **window** instead of wherever `<Stylo>`
-     * sits on the page. `"bottom"` (or `true`) rides above the on-screen
-     * keyboard, tracked via the `visualViewport` API; `"top"` pins to the top
-     * edge, which needs no keyboard tracking and can't be covered by it or by a
-     * platform's own input accessory bar. Off (`false`, the default) is right
-     * for a small embedded field; a host opts in deliberately for a
-     * full-screen editor. See the toolbar reference's "On touch" section.
-     */
-    sticky?: boolean | "top" | "bottom";
-    /**
-     * When `sticky` is set, whether the bar stays on screen the whole time
-     * (`"consistent"`, the default) or only while the editing surface actually
-     * has focus (`"dynamic"`) — faded out otherwise, so it doesn't sit over the
-     * content while the caret is elsewhere. Ignored when `sticky` is off.
-     */
-    stickyVisibility?: "consistent" | "dynamic";
-}
-/**
- * Grammars for fenced-code sub-highlighting. Stylo ships none by default — a
- * consumer opts in with exactly the set they want (`codeLanguages={languages}`
- * from `@codemirror/language-data`, or a hand-built list). Forwarded verbatim
- * to `@codemirror/lang-markdown` for the CodeMirror surfaces (`source`,
- * `split`, `in-place`); `preview` resolves a fence's language the same way
- * (same fuzzy `LanguageDescription` match, or the function form called with
- * the same name) and colours it with the same `--stylo-syntax-*` tokens, so a
- * block reads identically whether it's being read or edited. See the ADR-001
- * amendment and ADR-002 §3's 2026-09-13 amendment.
- */
-export type CodeLanguages = readonly LanguageDescription[] | ((info: string) => Language | LanguageDescription | null);
-/** One `[[wikilink]]` autocomplete candidate returned by `wikiLinkSource`. */
-export interface WikiLinkCompletion {
-    /** Written verbatim between `[[` and `]]`. */
-    target: string;
-    /**
-     * Shown in the dropdown in place of `target`. When it differs from `target`,
-     * the accepted link is written `[[target|label]]`.
-     */
-    label?: string;
-}
-/**
- * Supplies `[[wikilink]]` autocomplete candidates. Called with the text typed
- * after `[[` (before any `|`) while the caret sits inside an unclosed `[[…`;
- * return the matches your index finds, already ordered — Stylo does not re-rank
- * or filter. May be async (e.g. a vault search endpoint). Pass it to enable the
- * feature; omit it and there is no wikilink completion. Read once, at mount.
- * Affects the CodeMirror surfaces only (`source`, `split`, `in-place`).
- */
-export type WikiLinkSource = (query: string) => readonly WikiLinkCompletion[] | Promise<readonly WikiLinkCompletion[]>;
-/** One `#tag` autocomplete candidate returned by `tagSource`. */
-export interface TagCompletion {
-    /** Written verbatim after `#`. No alias — tags have no `#tag|label` syntax. */
-    tag: string;
-}
-/**
- * Supplies `#tag` autocomplete candidates. Called with the text typed after `#`
- * while the caret sits inside an unclosed `#…` word; return the matches your
- * index finds, already ordered — Stylo does not re-rank or filter. May be async
- * (e.g. a tag-index lookup). Pass it to enable the feature; omit it and there is
- * no tag completion. Read once, at mount. Never fires on a `# Heading` marker
- * (the space breaks the match) or mid-word (`word#word`, a URL fragment).
- */
-export type TagSource = (query: string) => readonly TagCompletion[] | Promise<readonly TagCompletion[]>;
-/**
- * Resolves an `![[ref]]` embed (transclusion) to something to render. Called
- * with the raw reference — everything between `![[` and `]]`, trimmed, with any
- * `#heading` / `#^blockid` / `|size` suffix left intact for the host to parse.
- * Stylo has no vault, so it cannot resolve the reference itself; it detects the
- * `![[…]]` and renders whatever node you return in its place. May be async (a
- * vault lookup, a fetch). Return `null` to leave the reference as literal text.
- *
- * Pass it to enable embeds; omit it and `![[…]]` stays literal. Works on
- * `preview`, `split`, and the in-place canvas (ADR-009). A `![[…]]` alone on its
- * line renders as a **block**; one mid-sentence renders **inline** — return
- * phrasing content (not a block element) for the inline case. `![[…]]` inside
- * code stays literal, and inside an **in-place table cell** it stays literal too
- * (a table cell there is for editing tabular text; `preview` / `split` do
- * transclude in cells). Give it a stable reference — the render pipeline
- * rebuilds when its identity changes, and the in-place canvas reads it once at
- * mount.
- *
- * Results are memoised by `ref` per function identity (so a scroll or a
- * re-render does not re-resolve). If your source's output for a given `ref` can
- * change over time, vary the `ref` or pass a new `embedSource` to invalidate.
- * Rejections are not cached.
- */
-export type EmbedSource = (ref: string) => ReactNode | Promise<ReactNode>;
-/** Which host resolver rejected, and the argument it was called with. */
-export interface ResolveErrorInfo {
-    /** The prop whose function threw or returned a rejected promise. */
-    source: "embedSource" | "wikiLinkSource" | "tagSource";
-    /** What it was asked to resolve — an `![[ref]]` reference, or the `[[` query. */
-    input: string;
-}
-/**
- * Reported by `onTaskToggle` when a `preview` task-list checkbox is clicked.
- * `start`/`end` are raw offsets into `value` bracketing the `[ ]` / `[x]`
- * marker itself (`end - start === 3`); splice in the new marker text to apply
- * the toggle: `value.slice(0, start) + (checked ? "[x]" : "[ ]") +
- * value.slice(end)`. `checked` is the box's new state, not its state before
- * the click.
- */
-export interface TaskToggleInfo {
-    /** Offset of the marker's opening `[` in `value`. */
-    start: number;
-    /** Offset just past the marker's closing `]` in `value`. */
-    end: number;
-    /** The checkbox's new state. */
-    checked: boolean;
-}
-/**
- * Per-construct on/off switches for the in-place canvas. Each key defaults to
- * `true`; setting one `false` leaves that construct as plain source — no
- * decoration, no cursor-reveal behaviour. See ADR-005.
- */
-export interface InPlaceDecorationToggles {
-    headings?: boolean;
-    emphasis?: boolean;
-    links?: boolean;
-    wikilinks?: boolean;
-    math?: boolean;
-    lists?: boolean;
-    tasks?: boolean;
-    blockquote?: boolean;
-    horizontalRule?: boolean;
-    code?: boolean;
-    frontmatter?: boolean;
-    tables?: boolean;
-    /** `![[ref]]` transclusion blocks. Needs `embedSource` set; see ADR-009. */
-    embeds?: boolean;
-}
-/**
- * How the in-place canvas handles editing a table.
- * `"source"` (default) reveals the aligned pipe source under the caret;
- * `"cells"` keeps the rendered `<table>` and edits its cells in place.
- */
-export type TableEditing = "source" | "cells";
-/**
- * Whether the in-place canvas shows a construct's Markdown markers when the
- * caret is on its line. `"caret"` (default) reveals them for editing and
- * re-hides them on the way out — Obsidian's Live Preview. `"never"` keeps every
- * inline marker hidden at all times; formatting is changed through the toolbar,
- * the right-click menu, shortcuts, and autoformat-on-type instead. See ADR-007;
- * `"never"` is being rolled out in stages.
- */
-export type RevealMode = "caret" | "never";
-/**
- * What appears when text is selected in the in-place canvas. `"menu"` (default)
- * puts the inline-formatting group in the right-click menu and shows no floating
- * bar; `"bar"` shows a floating bar above the selection and drops that group
- * from the menu so nothing is doubled; `"none"` shows neither and leaves the
- * main toolbar as the only formatting surface. The toolbar is independent of
- * this setting — it is always available (unless hidden via `toolbar`) and always
- * acts on the selection.
- */
-export type SelectionUI = "menu" | "bar" | "none";
-/**
- * The right-click menu's top-level groups. `link` is the internal / external
- * link field rows; `format` the inline-mark submenu; `paragraph` the block-type
- * submenu; `insert` the new-block submenu; `clipboard` cut / copy / paste.
- */
-export type MenuGroupId = "link" | "format" | "paragraph" | "insert" | "clipboard";
-export interface ContextMenuConfig {
-    /**
-     * Which top-level groups the menu shows, in order. Omit for all five in their
-     * default order. `link` and `format` still yield to `selectionUI` when it is
-     * not `"menu"` (they move to the floating bar / toolbar).
-     */
-    groups?: MenuGroupId[];
-}
-export interface InPlaceConfig {
-    /** Which decoration types the in-place canvas renders. Read once, at mount. */
-    decorations?: InPlaceDecorationToggles;
-    /** Table editing mode (see `TableEditing`). Read once, at mount. */
-    table?: TableEditing;
-    /**
-     * Marker reveal behaviour (see `RevealMode`). Optional, defaults to
-     * `"caret"`. Read once, at mount.
-     */
-    reveal?: RevealMode;
-    /**
-     * Right-click a block for a context menu (inline actions on a selection,
-     * block + insert actions otherwise). `false` keeps the browser's own menu; an
-     * object picks and orders the menu's groups. Defaults to `true`. Read once,
-     * at mount.
-     */
-    contextMenu?: boolean | ContextMenuConfig;
-    /**
-     * What a non-empty selection offers (see `SelectionUI`). Defaults to
-     * `"menu"`. Read once, at mount.
-     */
-    selectionUI?: SelectionUI;
-    /**
-     * Which buttons the floating selection bar shows (`selectionUI: "bar"`), in
-     * order. Any of `bold` / `italic` / `strike` / `code` / `link` / `wikilink` /
-     * `math`. Omit for all seven. Read once, at mount.
-     */
-    selectionBarItems?: ToolbarCommandId[];
-}
-export interface StyloProps {
-    /** The canonical Markdown document. Stylo never holds a parsed model of it. */
-    value: string;
-    /** Called with the complete Markdown string on every edit. */
-    onChange: (next: string) => void;
-    /**
-     * Interaction layout. Defaults to `"in-place"` — the live decoration canvas.
-     * `"source"` is the plain surface and avoids loading the render chunk.
-     */
-    mode?: StyloMode;
-    /**
-     * Called with the full Markdown string when `Mod-s` is pressed on any editing
-     * surface; the browser's own save dialog is then suppressed. Omit it and
-     * `Mod-s` keeps its default browser behaviour. Stylo holds no dirty state —
-     * `value` is yours, so compare it against your last-saved copy.
-     */
-    onSave?: (value: string) => void;
-    /**
-     * Called on mount and whenever the leading `---` YAML block changes, with its
-     * inner text (no fences), or `null` when there is no block. Stylo does not
-     * parse it — pass `raw` to your own YAML parser for a structured panel. The
-     * same split is available synchronously as the exported `splitFrontmatter`.
-     */
-    onFrontmatter?: (raw: string | null) => void;
-    /** Invoked when a `[[wikilink]]` is activated in the preview or in-place canvas. */
-    onWikiLinkClick?: (target: string) => void;
-    /**
-     * Invoked by the in-place link editor's "Open link" action with the link's
-     * `href`. Stylo does not navigate on its own.
-     */
-    onLinkClick?: (href: string) => void;
-    /** Configures the in-place canvas (ADR-005). Applied when it mounts. */
-    inPlace?: InPlaceConfig;
-    /**
-     * How `preview` (and `split`'s preview pane) shows the leading `---` YAML
-     * block. `"hidden"` (default) drops it; `"code"` renders it as a styled
-     * `<pre class="stylo-frontmatter">`.
-     */
-    frontmatter?: FrontmatterDisplay;
-    /**
-     * Turn a single line ending into a real `<br>` in `preview` (and `split`'s
-     * preview pane), instead of CommonMark's default — a blank line required to
-     * start a new paragraph, so consecutive lines join into one run. Obsidian's
-     * Live Preview reads this way. Off by default: a real, visible change to
-     * every existing render, so a host opts in deliberately rather than
-     * inheriting it. No effect on `in-place` / `source` — CodeMirror already
-     * decorates each source line independently there.
-     */
-    softBreaks?: boolean;
-    /**
-     * Makes `preview` (and `split`'s preview pane) task-list checkboxes
-     * clickable instead of `disabled`. Fired with a {@link TaskToggleInfo} — raw
-     * offsets into `value` bracketing the clicked `[ ]` / `[x]` marker, and its
-     * new state. Stylo never mutates `value` itself; splice the marker and pass
-     * the result to `onChange`, same division of labour as `onWikiLinkClick`.
-     * Off by default: every checkbox stays `disabled`, exactly like today,
-     * until a host opts in.
-     */
-    onTaskToggle?: (info: TaskToggleInfo) => void;
-    /**
-     * Grammars for fenced-code sub-highlighting on the CodeMirror surfaces
-     * (`source`, `split`, `in-place`). None by default. Read once, at mount.
-     */
-    codeLanguages?: CodeLanguages;
-    /**
-     * Enables `[[wikilink]]` autocomplete on the CodeMirror surfaces. Called with
-     * the target typed so far; return your index's matches, ordered. Off when
-     * omitted. Read once, at mount. See `WikiLinkSource`.
-     */
-    wikiLinkSource?: WikiLinkSource;
-    /**
-     * Enables `#tag` autocomplete on the CodeMirror surfaces. Called with the tag
-     * typed so far; return your index's matches, ordered. Off when omitted. Read
-     * once, at mount. See `TagSource`.
-     */
-    tagSource?: TagSource;
-    /**
-     * Resolves `![[ref]]` embeds (transclusion) for `preview` and `split`. Called
-     * with the raw reference; return a node to render in its place, or `null` to
-     * leave it as literal text. May be async. Off when omitted. See
-     * {@link EmbedSource}.
-     */
-    embedSource?: EmbedSource;
-    /**
-     * Called when `embedSource`, `wikiLinkSource`, or `tagSource` throws or
-     * returns a rejected promise. Purely for observation — logging, a toast — the
-     * resolver still falls back (literal `![[ref]]` text, or no completions)
-     * either way. A `null` return is a valid result, not an error, and does not
-     * fire this. Reactive; see {@link ResolveErrorInfo}.
-     */
-    onResolveError?: (error: unknown, info: ResolveErrorInfo) => void;
-    /**
-     * Formatting toolbar above the editing surface (`source`, `in-place`,
-     * `split`; never `preview`). Omit or `true` for the default bar, `false` to
-     * hide it, or an object to choose and order the buttons. See ADR-002 §2.
-     */
-    toolbar?: boolean | ToolbarConfig;
-    /**
-     * Replace individual toolbar glyphs, keyed by command id. Any id left out
-     * keeps its built-in inline-SVG icon — Stylo ships no icon dependency.
-     */
-    icons?: Partial<Record<ToolbarCommandId, ReactNode>>;
-    /** Render the source surface read-only. */
-    readOnly?: boolean;
-    /** Placeholder text shown when the document is empty (source surface). */
-    placeholder?: string;
-    /** Extra class on the root element, alongside the internal classes. */
-    className?: string;
-    /**
-     * Host content docked inside the editing surface (`source`, `in-place`,
-     * `split`'s source pane; never `preview`) — after the find/replace panel,
-     * before the document body. Unlike `toolbar.render`, which wraps content
-     * *before* the whole canvas, this reaches the seam between CodeMirror's own
-     * top panels and its scroller, so host chrome (e.g. a frontmatter card) can
-     * sit under find/replace instead of always above it. `view` is `null` until
-     * the surface has mounted. Read once, at mount.
-     */
-    canvasHeader?: (ctx: {
-        view: EditorView | null;
-    }) => ReactNode;
-}
-/**
- * Imperative handle exposed on a `ref` to `<Stylo>`. Every method is a no-op —
- * returning `null` / `false` where it has a return value — in `preview` mode or
- * before the editing surface has mounted, since there is no editor then.
- */
-export interface StyloHandle {
-    /** Move keyboard focus into the editing surface. */
-    focus(): void;
-    /**
-     * Put the caret at the start of the first ATX heading (`#` … `######`) whose
-     * text matches `text` (trimmed, case-insensitive) and scroll it to the top of
-     * the viewport. Returns `true` when a heading matched.
-     */
-    scrollToHeading(text: string): boolean;
-    /**
-     * Replace the current selection — or insert at the caret when the selection is
-     * empty — with `md`. No effect on a `readOnly` surface.
-     */
-    insertAtCursor(md: string): void;
-    /**
-     * The underlying CodeMirror `EditorView`, or `null` in `preview` mode or
-     * before mount. An escape hatch: not covered by semver.
-     */
-    getView(): EditorView | null;
-}
+ * Re-export barrel over `types/`, split by domain: `core` (`StyloProps`,
+ * `StyloHandle`, and the top-level display/mode types), `toolbar` (toolbar
+ * config), `sources` (wikilink/tag/embed resolver types), and `inplace`
+ * (in-place canvas config). Kept so nothing importing from `./types` today
+ * has to change.
+ */
+export type { StyloMode, FrontmatterDisplay, CodeLanguages, TaskToggleInfo, StyloProps, StyloHandle, } from "./types/core";
+export type { ToolbarCommandId, ToolbarCustomItem, ToolbarItem, ToolbarConfig, } from "./types/toolbar";
+export type { WikiLinkCompletion, WikiLinkSource, TagCompletion, TagSource } from "./types/sources";
+export type { EmbedSource, ResolveErrorInfo } from "./types/sources";
+export type { InPlaceDecorationToggles, TableEditing, RevealMode, SelectionUI, MenuGroupId, ContextMenuConfig, InPlaceConfig, } from "./types/inplace";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,UAAU,EACV,WAAW,GACZ,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACnG,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACpE,YAAY,EACV,wBAAwB,EACxB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAA"}