@pixerate/editor 0.24.0 → 0.26.0

package/dist/persistence/index.d.ts

@@ -1,3 +1,5 @@
+import { S as StorageAdapter } from '../storage-BpFfspHm.js';
+export { I as IdbFactoryLike, a as IndexedDbAdapterOptions, b as InjectedStorageError, L as LocalStorageAdapterOptions, M as MemoryStorage, O as OpfsAdapterOptions, c as OpfsDirectoryLike, d as OpfsFileLike, e as StorageAdapterOptions, f as StorageFailureMode, g as StorageOperation, h as StorageUnavailableError, W as WebStorageLike, i as createIndexedDbAdapter, j as createLocalStorageAdapter, k as createMemoryStorage, l as createOpfsAdapter, m as isIndexedDbAvailable, n as isLocalStorageAvailable, o as isOpfsAvailable, w as withStorageFailures } from '../storage-BpFfspHm.js';
 export { J as JsonObject, L as LoadDocumentOptions, a as LoadDocumentResult, b as LoadReport, c as LoadSectionsOptions, d as LoadSectionsResult, M as MigrateOptions, e as MigrateResult, f as MigrationStep, R as ReadOnlyReason, S as SectionProblem, g as SectionSpec, h as SectionSpecs, i as createLoadReport, j as hasLoadProblems, l as loadDocument, k as loadSections, m as migrateDocument } from '../migrate-iTlm3a8h.js';
 
 /**
@@ -63,125 +65,6 @@ declare function exponentialBackoff(failures: number, base?: number, max?: numbe
  */
 declare function createRecoveryPolicy(options?: RecoveryPolicyOptions): RecoveryPolicy;
 
-/**
- * Key/value storage adapters for autosave and crash recovery. Every adapter is
- * async, stores strings, feature-detects its backend (an unavailable backend
- * rejects every call with `StorageUnavailableError` instead of throwing at
- * construction, so SSR and old browsers are safe) and accepts an injectable
- * failure mode for tests.
- */
-type StorageOperation = "get" | "set" | "remove";
-/**
- * Injected failure: return `true` (or an `Error`) to make that operation fail.
- * Example: `failure: (op) => op === "set"` simulates a full disk.
- */
-type StorageFailureMode = (operation: StorageOperation, key: string) => boolean | Error | undefined | void;
-interface StorageAdapter {
-    /** Short backend name, e.g. `"memory"`, `"localStorage"`, `"indexedDB"`, `"opfs"`. */
-    readonly kind: string;
-    /** Whether the backend was found. When `false`, every call rejects. */
-    readonly available: boolean;
-    get(key: string): Promise<string | null>;
-    set(key: string, value: string): Promise<void>;
-    remove(key: string): Promise<void>;
-}
-interface StorageAdapterOptions {
-    failure?: StorageFailureMode;
-}
-declare class StorageUnavailableError extends Error {
-    constructor(kind: string);
-}
-declare class InjectedStorageError extends Error {
-    constructor(operation: StorageOperation, key: string);
-}
-/** Wraps an adapter so `failure` can make any of its operations fail. */
-declare function withStorageFailures(inner: StorageAdapter, failure: StorageFailureMode): StorageAdapter;
-interface MemoryStorage extends StorageAdapter {
-    /** The underlying map (inspect it in tests). */
-    readonly entries: Map<string, string>;
-}
-/** In-memory storage (tests, SSR, or a session-only fallback). */
-declare function createMemoryStorage(options?: StorageAdapterOptions & {
-    initial?: Record<string, string>;
-}): MemoryStorage;
-/** Minimal `Storage` surface used by the localStorage adapter. */
-interface WebStorageLike {
-    getItem(key: string): string | null;
-    setItem(key: string, value: string): void;
-    removeItem(key: string): void;
-}
-interface LocalStorageAdapterOptions extends StorageAdapterOptions {
-    /** Storage to use (default `globalThis.localStorage`, e.g. pass `sessionStorage`). */
-    storage?: WebStorageLike;
-}
-/** Whether `localStorage` can be used (it throws when site data is blocked). */
-declare function isLocalStorageAvailable(): boolean;
-/**
- * `localStorage` adapter; every key is prefixed with `prefix`. Writes are
- * synchronous under the hood, so they complete even inside `pagehide`.
- * A full quota rejects the `set` (`QuotaExceededError`).
- */
-declare function createLocalStorageAdapter(prefix?: string, options?: LocalStorageAdapterOptions): StorageAdapter;
-/** Minimal `IDBFactory` surface (the real `indexedDB`, or a fake in tests). */
-interface IdbFactoryLike {
-    open(name: string, version?: number): any;
-}
-interface IndexedDbAdapterOptions extends StorageAdapterOptions {
-    /** Object store name (default `"kv"`). */
-    store?: string;
-    /** Factory to use (default `globalThis.indexedDB`). */
-    indexedDB?: IdbFactoryLike;
-}
-/** Whether `indexedDB` exists in this environment. */
-declare function isIndexedDbAvailable(): boolean;
-/**
- * IndexedDB adapter: one database `name` with a single key/value object store.
- * A `set` resolves when its transaction completes (not merely when the request
- * succeeds), so a resolved write is durable.
- */
-declare function createIndexedDbAdapter(name?: string, options?: IndexedDbAdapterOptions): StorageAdapter;
-/** Minimal `FileSystemDirectoryHandle` surface used by the OPFS adapter. */
-interface OpfsDirectoryLike {
-    getDirectoryHandle(name: string, options?: {
-        create?: boolean;
-    }): Promise<OpfsDirectoryLike>;
-    getFileHandle(name: string, options?: {
-        create?: boolean;
-    }): Promise<OpfsFileLike>;
-    removeEntry(name: string): Promise<void>;
-}
-interface OpfsFileLike {
-    getFile(): Promise<{
-        text(): Promise<string>;
-    }>;
-    createWritable?(): Promise<{
-        write(data: string): Promise<void>;
-        close(): Promise<void>;
-    }>;
-    /** Rename in place (Chromium, Safari). Used for temp-file + rename writes. */
-    move?(name: string): Promise<void>;
-}
-interface OpfsAdapterOptions extends StorageAdapterOptions {
-    /** Root directory (default `navigator.storage.getDirectory()`). */
-    root?: () => Promise<OpfsDirectoryLike>;
-    /** Force the write-then-pointer-swap strategy even when `move` exists. */
-    disableRename?: boolean;
-}
-/** Whether the Origin Private File System exists (`navigator.storage.getDirectory`). */
-declare function isOpfsAvailable(): boolean;
-/**
- * Origin Private File System adapter. Values are files in `dir` (created on
- * demand), named after the URI-encoded key.
- *
- * Writes never leave a half-written value behind: where file handles support
- * `move`, the value is written to `<file>.tmp` and renamed over `<file>`;
- * otherwise it alternates between two slots (`<file>.a` / `<file>.b`) and then
- * swaps a pointer file (`<file>.ptr`), so a crash mid-write keeps the previous
- * value. Main-thread writes need `createWritable` (missing in some Safari
- * versions); without it, `set` rejects with `StorageUnavailableError`.
- */
-declare function createOpfsAdapter(dir?: string, options?: OpfsAdapterOptions): StorageAdapter;
-
 type AutosaveStatus = "idle" | "dirty" | "saving" | "saved" | "error";
 interface AutosaveStatusInfo {
     status: AutosaveStatus;
@@ -344,4 +227,4 @@ interface RevisionTracker {
  */
 declare function createRevisionTracker(options?: RevisionTrackerOptions): RevisionTracker;
 
-export { type AutosaveController, type AutosaveControllerOptions, type AutosaveRecovery, type AutosaveStatus, type AutosaveStatusInfo, type DirtyFlagSource, type IdbFactoryLike, type IndexedDbAdapterOptions, InjectedStorageError, type LocalStorageAdapterOptions, type MemoryStorage, type OpfsAdapterOptions, type OpfsDirectoryLike, type OpfsFileLike, type RecoveryAction, type RecoveryMeta, type RecoveryPolicy, type RecoveryPolicyOptions, type RecoveryTickOptions, type RevisionChangeSource, type RevisionTracker, type RevisionTrackerOptions, type StorageAdapter, type StorageAdapterOptions, type StorageFailureMode, type StorageOperation, StorageUnavailableError, type WebStorageLike, createAutosaveController, createIndexedDbAdapter, createLocalStorageAdapter, createMemoryStorage, createOpfsAdapter, createRecoveryPolicy, createRevisionTracker, exponentialBackoff, formatRecoveryMessage, isIndexedDbAvailable, isLocalStorageAvailable, isOpfsAvailable, recoveryMetaKey, withStorageFailures };
+export { type AutosaveController, type AutosaveControllerOptions, type AutosaveRecovery, type AutosaveStatus, type AutosaveStatusInfo, type DirtyFlagSource, type RecoveryAction, type RecoveryMeta, type RecoveryPolicy, type RecoveryPolicyOptions, type RecoveryTickOptions, type RevisionChangeSource, type RevisionTracker, type RevisionTrackerOptions, StorageAdapter, createAutosaveController, createRecoveryPolicy, createRevisionTracker, exponentialBackoff, formatRecoveryMessage, recoveryMetaKey };

package/dist/registry-CED5C0lA.d.cts

@@ -0,0 +1,204 @@
+/** Paragraph styles format whole blocks; character styles format runs of text. */
+type StyleKind = "paragraph" | "character";
+/** Character formatting of a style (CSS values). */
+interface CharacterFormat {
+    fontFamily?: string;
+    /** CSS length, e.g. `"1.5em"` or `"18px"`. */
+    fontSize?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strike?: boolean;
+    color?: string;
+    backgroundColor?: string;
+    letterSpacing?: string;
+    textTransform?: "none" | "uppercase" | "lowercase" | "capitalize";
+    smallCaps?: boolean;
+}
+/** Paragraph formatting of a style (CSS values). */
+interface ParagraphFormat {
+    textAlign?: "left" | "center" | "right" | "justify";
+    lineHeight?: string;
+    spaceBefore?: string;
+    spaceAfter?: string;
+    indentLeft?: string;
+    indentRight?: string;
+    indentFirstLine?: string;
+    /** CSS border shorthand, e.g. `"3px solid currentColor"`. */
+    borderLeft?: string;
+    paddingLeft?: string;
+    backgroundColor?: string;
+}
+/** The block node a paragraph style uses (`heading` with `level` for Heading N). */
+interface StyleBlock {
+    type: string;
+    attrs?: Record<string, any>;
+}
+interface StyleDefinition {
+    /** Stable id (`Heading1`): letters, digits, `_` and `-`, starting with a letter. */
+    id: string;
+    /** Display name (`Heading 1`). */
+    name: string;
+    kind: StyleKind;
+    /** Style this one inherits from; what it sets wins over its base. */
+    basedOn?: string | null;
+    /** Style of the paragraph after this one when Enter is pressed at its end (paragraph styles). */
+    next?: string | null;
+    /** Linked style: a paragraph style's character style, or a character style's paragraph style. */
+    linked?: string | null;
+    paragraph?: ParagraphFormat;
+    character?: CharacterFormat;
+    /** Block node of a paragraph style. Inherited along `basedOn`; `paragraph` by default. */
+    block?: StyleBlock | null;
+    /** Gallery order (lower first). */
+    priority?: number;
+    /** Shown in the styles gallery. */
+    quick?: boolean;
+    hidden?: boolean;
+    /** Built in (cannot be removed). */
+    builtin?: boolean;
+}
+/** A style with its `basedOn` chain and the defaults merged. */
+interface ResolvedStyle {
+    id: string;
+    paragraph: ParagraphFormat;
+    character: CharacterFormat;
+    block: StyleBlock;
+    /** Id of the style after Enter at the end of a paragraph. */
+    next: string;
+}
+interface StyleDefaults {
+    paragraph?: ParagraphFormat;
+    character?: CharacterFormat;
+}
+interface StyleRegistryOptions {
+    /** Styles added to (or replacing) the built-in ones. */
+    styles?: readonly StyleDefinition[];
+    /** Include the built-in styles. Default `true`. */
+    builtins?: boolean;
+    /** Document defaults, applied below every style. */
+    defaults?: StyleDefaults;
+}
+interface StyleRegistrySnapshot {
+    styles: readonly StyleDefinition[];
+    defaults: StyleDefaults;
+    /** Increases on every change. */
+    version: number;
+}
+/** Serializable registry content (`registry.toJSON()`). */
+interface StyleRegistryJSON {
+    styles: StyleDefinition[];
+    defaults: StyleDefaults;
+}
+interface StyleCSSOptions {
+    /** Selector the rules are scoped to. Default `.ProseMirror`. */
+    scope?: string;
+    /**
+     * Element selector of blocks that use a style without naming it
+     * (`data-style` absent), e.g. `h2` for Heading 2. Return `null` for none.
+     */
+    tagFor?: (block: StyleBlock) => string | null;
+}
+declare const NORMAL_STYLE_ID = "Normal";
+/** Whether `id` is a valid style id. */
+declare function isValidStyleId(id: unknown): id is string;
+/** The built-in styles: Normal, Title, Subtitle, Heading 1–6, Quote, Code, List Paragraph and character styles. */
+declare const DEFAULT_STYLES: readonly StyleDefinition[];
+/**
+ * Style definitions with `basedOn` inheritance, next-style and linked
+ * character/paragraph styles, resolved in cascade order: document defaults →
+ * style chain (base first) → direct formatting. Chains are cycle-safe.
+ *
+ * `subscribe` calls the listener immediately and on every change (Svelte
+ * store contract); `getSnapshot` is stable between changes.
+ */
+declare class StyleRegistry {
+    private styles;
+    private defaults;
+    private version;
+    private snapshot;
+    private listeners;
+    constructor(options?: StyleRegistryOptions);
+    get(id: string | null | undefined): StyleDefinition | undefined;
+    /** Finds a style by id or display name (case-insensitive). */
+    find(nameOrId: string): StyleDefinition | undefined;
+    /** All styles (optionally of one kind) in gallery order. */
+    list(kind?: StyleKind): StyleDefinition[];
+    /** Styles shown in the gallery (`quick`, not hidden), paragraph styles by default. */
+    gallery(kind?: StyleKind): StyleDefinition[];
+    /** The `basedOn` chain from the root style down to `id` (cycle-safe, bounded). */
+    chain(id: string): StyleDefinition[];
+    /**
+     * Resolves a paragraph style: defaults, then each style of the chain (base
+     * first). Unknown ids resolve to the defaults in a `paragraph` block.
+     */
+    resolve(id: string): ResolvedStyle;
+    /** Character formatting a paragraph style's chain sets (without defaults). */
+    private paragraphCharacter;
+    /**
+     * Character formatting of a character style's chain. A style linked to a
+     * paragraph style takes that style's character formatting first.
+     */
+    resolveCharacterStyle(id: string): CharacterFormat;
+    /**
+     * Character formatting of text: defaults → paragraph style chain →
+     * character style chain → direct formatting.
+     */
+    resolveText(input: {
+        paragraphStyle?: string | null;
+        characterStyle?: string | null;
+        direct?: CharacterFormat;
+    }): CharacterFormat;
+    /** The style after Enter at the end of a paragraph of `id` (itself when unset or unknown). */
+    nextStyleId(id: string): string;
+    /** The linked character style of a paragraph style, if any. */
+    linkedCharacterStyle(id: string): StyleDefinition | undefined;
+    /**
+     * The style a block uses when it names none: Normal for paragraphs,
+     * Heading N for headings of level N, Code for code blocks (the built-in
+     * style whose own `block` matches).
+     */
+    defaultStyleFor(type: string, attrs?: Record<string, any>): string | null;
+    /** The style of a block: its `styleId` when known, otherwise the block's default style. */
+    styleOfBlock(type: string, attrs?: Record<string, any>): string | null;
+    getSnapshot: () => StyleRegistrySnapshot;
+    subscribe: (listener: (snapshot: StyleRegistrySnapshot) => void) => (() => void);
+    toJSON(): StyleRegistryJSON;
+    /** Adds or replaces a style. Throws on an invalid id. */
+    upsert(style: StyleDefinition): StyleDefinition;
+    /** Merges `patch` into a style (formats are merged key by key). Returns `undefined` for unknown ids. */
+    update(id: string, patch: Partial<Omit<StyleDefinition, "id">>): StyleDefinition | undefined;
+    /**
+     * Removes a style and returns it. Built-in styles cannot be removed. Styles
+     * based on it are rebased onto its own base, and `next`/`linked`
+     * references to it are dropped.
+     */
+    remove(id: string): StyleDefinition | undefined;
+    /** Replaces the document defaults. */
+    setDefaults(defaults: StyleDefaults): void;
+    /** An unused id derived from a display name (`My Style` → `MyStyle`, then `MyStyle1`, …). */
+    newId(name: string): string;
+    /** CSS declarations (`property: value`) of a resolved paragraph or character style. */
+    cssDeclarations(id: string): Record<string, string>;
+    /**
+     * Declarations for previewing a style in a menu or gallery: font family,
+     * weight, style, color, decoration, case and letter spacing (no sizes,
+     * margins or borders).
+     */
+    previewDeclarations(id: string): Record<string, string>;
+    /**
+     * A stylesheet for the styles: `[data-style="Id"]` rules for paragraph
+     * styles (plus the plain element of blocks that use their default style,
+     * e.g. `h2:not([data-style])`), `[data-char-style="Id"]` for character
+     * styles and the defaults on the scope element.
+     */
+    toCSS(options?: StyleCSSOptions): string;
+    private put;
+    private changed;
+}
+/** A CSS value, or `undefined` when it is unsafe or empty. */
+declare function safeCSSValue(value: unknown): string | undefined;
+/** Creates a style registry with the built-in styles (unless `builtins: false`) and `styles`. */
+declare function createStyleRegistry(options?: StyleRegistryOptions | StyleRegistryJSON): StyleRegistry;
+
+export { type CharacterFormat as C, DEFAULT_STYLES as D, NORMAL_STYLE_ID as N, type ParagraphFormat as P, type ResolvedStyle as R, type StyleBlock as S, type StyleCSSOptions as a, type StyleDefaults as b, type StyleDefinition as c, type StyleKind as d, StyleRegistry as e, type StyleRegistryJSON as f, type StyleRegistryOptions as g, type StyleRegistrySnapshot as h, createStyleRegistry as i, isValidStyleId as j, safeCSSValue as s };

package/dist/registry-CED5C0lA.d.ts

@@ -0,0 +1,204 @@
+/** Paragraph styles format whole blocks; character styles format runs of text. */
+type StyleKind = "paragraph" | "character";
+/** Character formatting of a style (CSS values). */
+interface CharacterFormat {
+    fontFamily?: string;
+    /** CSS length, e.g. `"1.5em"` or `"18px"`. */
+    fontSize?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strike?: boolean;
+    color?: string;
+    backgroundColor?: string;
+    letterSpacing?: string;
+    textTransform?: "none" | "uppercase" | "lowercase" | "capitalize";
+    smallCaps?: boolean;
+}
+/** Paragraph formatting of a style (CSS values). */
+interface ParagraphFormat {
+    textAlign?: "left" | "center" | "right" | "justify";
+    lineHeight?: string;
+    spaceBefore?: string;
+    spaceAfter?: string;
+    indentLeft?: string;
+    indentRight?: string;
+    indentFirstLine?: string;
+    /** CSS border shorthand, e.g. `"3px solid currentColor"`. */
+    borderLeft?: string;
+    paddingLeft?: string;
+    backgroundColor?: string;
+}
+/** The block node a paragraph style uses (`heading` with `level` for Heading N). */
+interface StyleBlock {
+    type: string;
+    attrs?: Record<string, any>;
+}
+interface StyleDefinition {
+    /** Stable id (`Heading1`): letters, digits, `_` and `-`, starting with a letter. */
+    id: string;
+    /** Display name (`Heading 1`). */
+    name: string;
+    kind: StyleKind;
+    /** Style this one inherits from; what it sets wins over its base. */
+    basedOn?: string | null;
+    /** Style of the paragraph after this one when Enter is pressed at its end (paragraph styles). */
+    next?: string | null;
+    /** Linked style: a paragraph style's character style, or a character style's paragraph style. */
+    linked?: string | null;
+    paragraph?: ParagraphFormat;
+    character?: CharacterFormat;
+    /** Block node of a paragraph style. Inherited along `basedOn`; `paragraph` by default. */
+    block?: StyleBlock | null;
+    /** Gallery order (lower first). */
+    priority?: number;
+    /** Shown in the styles gallery. */
+    quick?: boolean;
+    hidden?: boolean;
+    /** Built in (cannot be removed). */
+    builtin?: boolean;
+}
+/** A style with its `basedOn` chain and the defaults merged. */
+interface ResolvedStyle {
+    id: string;
+    paragraph: ParagraphFormat;
+    character: CharacterFormat;
+    block: StyleBlock;
+    /** Id of the style after Enter at the end of a paragraph. */
+    next: string;
+}
+interface StyleDefaults {
+    paragraph?: ParagraphFormat;
+    character?: CharacterFormat;
+}
+interface StyleRegistryOptions {
+    /** Styles added to (or replacing) the built-in ones. */
+    styles?: readonly StyleDefinition[];
+    /** Include the built-in styles. Default `true`. */
+    builtins?: boolean;
+    /** Document defaults, applied below every style. */
+    defaults?: StyleDefaults;
+}
+interface StyleRegistrySnapshot {
+    styles: readonly StyleDefinition[];
+    defaults: StyleDefaults;
+    /** Increases on every change. */
+    version: number;
+}
+/** Serializable registry content (`registry.toJSON()`). */
+interface StyleRegistryJSON {
+    styles: StyleDefinition[];
+    defaults: StyleDefaults;
+}
+interface StyleCSSOptions {
+    /** Selector the rules are scoped to. Default `.ProseMirror`. */
+    scope?: string;
+    /**
+     * Element selector of blocks that use a style without naming it
+     * (`data-style` absent), e.g. `h2` for Heading 2. Return `null` for none.
+     */
+    tagFor?: (block: StyleBlock) => string | null;
+}
+declare const NORMAL_STYLE_ID = "Normal";
+/** Whether `id` is a valid style id. */
+declare function isValidStyleId(id: unknown): id is string;
+/** The built-in styles: Normal, Title, Subtitle, Heading 1–6, Quote, Code, List Paragraph and character styles. */
+declare const DEFAULT_STYLES: readonly StyleDefinition[];
+/**
+ * Style definitions with `basedOn` inheritance, next-style and linked
+ * character/paragraph styles, resolved in cascade order: document defaults →
+ * style chain (base first) → direct formatting. Chains are cycle-safe.
+ *
+ * `subscribe` calls the listener immediately and on every change (Svelte
+ * store contract); `getSnapshot` is stable between changes.
+ */
+declare class StyleRegistry {
+    private styles;
+    private defaults;
+    private version;
+    private snapshot;
+    private listeners;
+    constructor(options?: StyleRegistryOptions);
+    get(id: string | null | undefined): StyleDefinition | undefined;
+    /** Finds a style by id or display name (case-insensitive). */
+    find(nameOrId: string): StyleDefinition | undefined;
+    /** All styles (optionally of one kind) in gallery order. */
+    list(kind?: StyleKind): StyleDefinition[];
+    /** Styles shown in the gallery (`quick`, not hidden), paragraph styles by default. */
+    gallery(kind?: StyleKind): StyleDefinition[];
+    /** The `basedOn` chain from the root style down to `id` (cycle-safe, bounded). */
+    chain(id: string): StyleDefinition[];
+    /**
+     * Resolves a paragraph style: defaults, then each style of the chain (base
+     * first). Unknown ids resolve to the defaults in a `paragraph` block.
+     */
+    resolve(id: string): ResolvedStyle;
+    /** Character formatting a paragraph style's chain sets (without defaults). */
+    private paragraphCharacter;
+    /**
+     * Character formatting of a character style's chain. A style linked to a
+     * paragraph style takes that style's character formatting first.
+     */
+    resolveCharacterStyle(id: string): CharacterFormat;
+    /**
+     * Character formatting of text: defaults → paragraph style chain →
+     * character style chain → direct formatting.
+     */
+    resolveText(input: {
+        paragraphStyle?: string | null;
+        characterStyle?: string | null;
+        direct?: CharacterFormat;
+    }): CharacterFormat;
+    /** The style after Enter at the end of a paragraph of `id` (itself when unset or unknown). */
+    nextStyleId(id: string): string;
+    /** The linked character style of a paragraph style, if any. */
+    linkedCharacterStyle(id: string): StyleDefinition | undefined;
+    /**
+     * The style a block uses when it names none: Normal for paragraphs,
+     * Heading N for headings of level N, Code for code blocks (the built-in
+     * style whose own `block` matches).
+     */
+    defaultStyleFor(type: string, attrs?: Record<string, any>): string | null;
+    /** The style of a block: its `styleId` when known, otherwise the block's default style. */
+    styleOfBlock(type: string, attrs?: Record<string, any>): string | null;
+    getSnapshot: () => StyleRegistrySnapshot;
+    subscribe: (listener: (snapshot: StyleRegistrySnapshot) => void) => (() => void);
+    toJSON(): StyleRegistryJSON;
+    /** Adds or replaces a style. Throws on an invalid id. */
+    upsert(style: StyleDefinition): StyleDefinition;
+    /** Merges `patch` into a style (formats are merged key by key). Returns `undefined` for unknown ids. */
+    update(id: string, patch: Partial<Omit<StyleDefinition, "id">>): StyleDefinition | undefined;
+    /**
+     * Removes a style and returns it. Built-in styles cannot be removed. Styles
+     * based on it are rebased onto its own base, and `next`/`linked`
+     * references to it are dropped.
+     */
+    remove(id: string): StyleDefinition | undefined;
+    /** Replaces the document defaults. */
+    setDefaults(defaults: StyleDefaults): void;
+    /** An unused id derived from a display name (`My Style` → `MyStyle`, then `MyStyle1`, …). */
+    newId(name: string): string;
+    /** CSS declarations (`property: value`) of a resolved paragraph or character style. */
+    cssDeclarations(id: string): Record<string, string>;
+    /**
+     * Declarations for previewing a style in a menu or gallery: font family,
+     * weight, style, color, decoration, case and letter spacing (no sizes,
+     * margins or borders).
+     */
+    previewDeclarations(id: string): Record<string, string>;
+    /**
+     * A stylesheet for the styles: `[data-style="Id"]` rules for paragraph
+     * styles (plus the plain element of blocks that use their default style,
+     * e.g. `h2:not([data-style])`), `[data-char-style="Id"]` for character
+     * styles and the defaults on the scope element.
+     */
+    toCSS(options?: StyleCSSOptions): string;
+    private put;
+    private changed;
+}
+/** A CSS value, or `undefined` when it is unsafe or empty. */
+declare function safeCSSValue(value: unknown): string | undefined;
+/** Creates a style registry with the built-in styles (unless `builtins: false`) and `styles`. */
+declare function createStyleRegistry(options?: StyleRegistryOptions | StyleRegistryJSON): StyleRegistry;
+
+export { type CharacterFormat as C, DEFAULT_STYLES as D, NORMAL_STYLE_ID as N, type ParagraphFormat as P, type ResolvedStyle as R, type StyleBlock as S, type StyleCSSOptions as a, type StyleDefaults as b, type StyleDefinition as c, type StyleKind as d, StyleRegistry as e, type StyleRegistryJSON as f, type StyleRegistryOptions as g, type StyleRegistrySnapshot as h, createStyleRegistry as i, isValidStyleId as j, safeCSSValue as s };

package/dist/{registry-GJI4gToU.d.cts → registry-CEgwXED1.d.cts}

@@ -35,6 +35,11 @@ interface ImportContext {
      * exports) can import nested files with the same adapters.
      */
     registry?: ImportAdapterRegistry;
+    /**
+     * Per-import options for this adapter: `ImportFileOptions.adapterOptions[adapter.id]`.
+     * Adapters document what they accept (e.g. the PDF adapter's `{ structure: false }`).
+     */
+    options?: unknown;
 }
 interface ImportAdapter<TResult = unknown> {
     /** Unique id, e.g. `markdown`, `html`, `csv`. */
@@ -65,6 +70,11 @@ interface ImportFileOptions {
     fileName?: string;
     /** Overrides the input's own `type`. */
     mimeType?: string;
+    /**
+     * Options for individual adapters, keyed by adapter id; the matching entry
+     * reaches the adapter as `context.options`. Example: `{ pdf: { structure: false } }`.
+     */
+    adapterOptions?: Record<string, unknown>;
 }
 interface ImportOutcome<TResult = unknown> {
     adapterId: string;
@@ -96,6 +106,7 @@ declare function createImportContext(input: ImportInput, details: {
     mimeType?: string;
     target: ImportTarget;
     registry?: ImportAdapterRegistry;
+    options?: unknown;
 }): ImportContext;
 /**
  * A set of import adapters with type matching. Use the default registry via
@@ -136,4 +147,4 @@ declare class ImportAdapterRegistry {
     importFile<TResult = unknown>(input: ImportInput, options?: ImportFileOptions): Promise<ImportOutcome<TResult>>;
 }
 
-export { type FileLike as F, ImportAdapterRegistry as I, type RegisterImportAdapterOptions as R, type ImportOutcome as a, type FindImportAdapterQuery as b, type ImportAdapter as c, type ImportContext as d, ImportError as e, type ImportErrorCode as f, type ImportFileOptions as g, type ImportInput as h, type ImportTarget as i, createImportContext as j };
+export { type FileLike as F, ImportAdapterRegistry as I, type RegisterImportAdapterOptions as R, type ImportOutcome as a, type ImportAdapter as b, type FindImportAdapterQuery as c, type ImportContext as d, ImportError as e, type ImportErrorCode as f, type ImportFileOptions as g, type ImportInput as h, type ImportTarget as i, createImportContext as j };

package/dist/{registry-GJI4gToU.d.ts → registry-CEgwXED1.d.ts}

@@ -35,6 +35,11 @@ interface ImportContext {
      * exports) can import nested files with the same adapters.
      */
     registry?: ImportAdapterRegistry;
+    /**
+     * Per-import options for this adapter: `ImportFileOptions.adapterOptions[adapter.id]`.
+     * Adapters document what they accept (e.g. the PDF adapter's `{ structure: false }`).
+     */
+    options?: unknown;
 }
 interface ImportAdapter<TResult = unknown> {
     /** Unique id, e.g. `markdown`, `html`, `csv`. */
@@ -65,6 +70,11 @@ interface ImportFileOptions {
     fileName?: string;
     /** Overrides the input's own `type`. */
     mimeType?: string;
+    /**
+     * Options for individual adapters, keyed by adapter id; the matching entry
+     * reaches the adapter as `context.options`. Example: `{ pdf: { structure: false } }`.
+     */
+    adapterOptions?: Record<string, unknown>;
 }
 interface ImportOutcome<TResult = unknown> {
     adapterId: string;
@@ -96,6 +106,7 @@ declare function createImportContext(input: ImportInput, details: {
     mimeType?: string;
     target: ImportTarget;
     registry?: ImportAdapterRegistry;
+    options?: unknown;
 }): ImportContext;
 /**
  * A set of import adapters with type matching. Use the default registry via
@@ -136,4 +147,4 @@ declare class ImportAdapterRegistry {
     importFile<TResult = unknown>(input: ImportInput, options?: ImportFileOptions): Promise<ImportOutcome<TResult>>;
 }
 
-export { type FileLike as F, ImportAdapterRegistry as I, type RegisterImportAdapterOptions as R, type ImportOutcome as a, type FindImportAdapterQuery as b, type ImportAdapter as c, type ImportContext as d, ImportError as e, type ImportErrorCode as f, type ImportFileOptions as g, type ImportInput as h, type ImportTarget as i, createImportContext as j };
+export { type FileLike as F, ImportAdapterRegistry as I, type RegisterImportAdapterOptions as R, type ImportOutcome as a, type ImportAdapter as b, type FindImportAdapterQuery as c, type ImportContext as d, ImportError as e, type ImportErrorCode as f, type ImportFileOptions as g, type ImportInput as h, type ImportTarget as i, createImportContext as j };

package/dist/{registry-D32LpIc4.d.cts → registry-D0GADKc7.d.cts}

@@ -351,4 +351,4 @@ declare function createCommandRegistry<TContext = any>(options?: CommandRegistry
 /** Identity helper that types a command spec. */
 declare function defineCommand<TContext = any, TParams = any, TResult = unknown>(spec: CommandSpec<TContext, TParams, TResult>): CommandSpec<TContext, TParams, TResult>;
 
-export { formatShortcut as A, isEditableEventTarget as B, CommandRegistry as C, keyToCode as D, type EffectiveChord as E, normalizeChord as F, parseChord as G, shortcutCode as H, toShortcutBindings as I, type KeyboardEventLike as K, type Platform as P, type ShortcutBinding as S, type CommandResult as a, type CommandEntry as b, type CommandSpec as c, type Chord as d, type CommandErrorCode as e, type CommandHistoryTarget as f, type CommandListOptions as g, type CommandParamsSchema as h, CommandRegistryError as i, type CommandRegistryOptions as j, PLATFORMS as k, type ShortcutConflict as l, type ShortcutInput as m, ShortcutMap as n, type ShortcutMapOptions as o, type ShortcutMatch as p, type ShortcutResolveOptions as q, chordToString as r, codeFromKey as s, codeToKeyText as t, createCommandRegistry as u, defineCommand as v, detectPlatform as w, effectiveChord as x, effectiveChordKey as y, eventCode as z };
+export { formatShortcut as A, isEditableEventTarget as B, type CommandSpec as C, keyToCode as D, type EffectiveChord as E, normalizeChord as F, parseChord as G, shortcutCode as H, toShortcutBindings as I, type KeyboardEventLike as K, type Platform as P, type ShortcutBinding as S, CommandRegistry as a, type CommandResult as b, type CommandEntry as c, type Chord as d, type CommandErrorCode as e, type CommandHistoryTarget as f, type CommandListOptions as g, type CommandParamsSchema as h, CommandRegistryError as i, type CommandRegistryOptions as j, PLATFORMS as k, type ShortcutConflict as l, type ShortcutInput as m, ShortcutMap as n, type ShortcutMapOptions as o, type ShortcutMatch as p, type ShortcutResolveOptions as q, chordToString as r, codeFromKey as s, codeToKeyText as t, createCommandRegistry as u, defineCommand as v, detectPlatform as w, effectiveChord as x, effectiveChordKey as y, eventCode as z };

package/dist/{registry-evKTP4ls.d.ts → registry-DhVUZioj.d.ts}

@@ -351,4 +351,4 @@ declare function createCommandRegistry<TContext = any>(options?: CommandRegistry
 /** Identity helper that types a command spec. */
 declare function defineCommand<TContext = any, TParams = any, TResult = unknown>(spec: CommandSpec<TContext, TParams, TResult>): CommandSpec<TContext, TParams, TResult>;
 
-export { formatShortcut as A, isEditableEventTarget as B, CommandRegistry as C, keyToCode as D, type EffectiveChord as E, normalizeChord as F, parseChord as G, shortcutCode as H, toShortcutBindings as I, type KeyboardEventLike as K, type Platform as P, type ShortcutBinding as S, type CommandResult as a, type CommandEntry as b, type CommandSpec as c, type Chord as d, type CommandErrorCode as e, type CommandHistoryTarget as f, type CommandListOptions as g, type CommandParamsSchema as h, CommandRegistryError as i, type CommandRegistryOptions as j, PLATFORMS as k, type ShortcutConflict as l, type ShortcutInput as m, ShortcutMap as n, type ShortcutMapOptions as o, type ShortcutMatch as p, type ShortcutResolveOptions as q, chordToString as r, codeFromKey as s, codeToKeyText as t, createCommandRegistry as u, defineCommand as v, detectPlatform as w, effectiveChord as x, effectiveChordKey as y, eventCode as z };
+export { formatShortcut as A, isEditableEventTarget as B, type CommandSpec as C, keyToCode as D, type EffectiveChord as E, normalizeChord as F, parseChord as G, shortcutCode as H, toShortcutBindings as I, type KeyboardEventLike as K, type Platform as P, type ShortcutBinding as S, CommandRegistry as a, type CommandResult as b, type CommandEntry as c, type Chord as d, type CommandErrorCode as e, type CommandHistoryTarget as f, type CommandListOptions as g, type CommandParamsSchema as h, CommandRegistryError as i, type CommandRegistryOptions as j, PLATFORMS as k, type ShortcutConflict as l, type ShortcutInput as m, ShortcutMap as n, type ShortcutMapOptions as o, type ShortcutMatch as p, type ShortcutResolveOptions as q, chordToString as r, codeFromKey as s, codeToKeyText as t, createCommandRegistry as u, defineCommand as v, detectPlatform as w, effectiveChord as x, effectiveChordKey as y, eventCode as z };