@pixerate/editor 0.146.0 → 0.148.0

package/dist/color/index.js

@@ -0,0 +1,115 @@
+import {
+  DEFAULT_SCHEME_SURFACES,
+  HARMONY_KINDS,
+  NAMED_COLORS,
+  PICKER_HUE_BACKGROUND,
+  checkDualColorContrast,
+  checkPaletteColors,
+  colorHarmony,
+  contrastLevel,
+  contrastRatio,
+  createColorToolProvider,
+  deltaEOK,
+  deriveDualColor,
+  displayP3ToLinearSrgb,
+  dualColorsToCss,
+  dualPickerView,
+  formatColor,
+  formatDualColor,
+  formatHex,
+  hslToRgb,
+  hsvToRgb,
+  hueToWheel,
+  inSrgbGamut,
+  isColor,
+  isDualColor,
+  isSameInBothSchemes,
+  linearSrgbToDisplayP3,
+  linearToSrgb,
+  mixColors,
+  normalizeColor,
+  normalizeDualColor,
+  oklabToOklch,
+  oklabToRgb,
+  oklchToOklab,
+  parseColor,
+  parseDualColor,
+  pickerAlphaBackground,
+  pickerAreaBackground,
+  pickerKeyStep,
+  pickerStateFromAlpha,
+  pickerStateFromArea,
+  pickerStateFromColor,
+  pickerStateFromHue,
+  pickerStateToHex,
+  pushRecentColor,
+  readableTextColor,
+  relativeLuminance,
+  resolveColor,
+  rgbToHsl,
+  rgbToHsv,
+  rgbToOklab,
+  setDualColorSide,
+  simulateColorVision,
+  srgbToLinear,
+  toSrgbGamut,
+  wheelToHue
+} from "../chunk-AA34BA7G.js";
+import "../chunk-6ONMQ6WF.js";
+export {
+  DEFAULT_SCHEME_SURFACES,
+  HARMONY_KINDS,
+  NAMED_COLORS,
+  PICKER_HUE_BACKGROUND,
+  checkDualColorContrast,
+  checkPaletteColors,
+  colorHarmony,
+  contrastLevel,
+  contrastRatio,
+  createColorToolProvider,
+  deltaEOK,
+  deriveDualColor,
+  displayP3ToLinearSrgb,
+  dualColorsToCss,
+  dualPickerView,
+  formatColor,
+  formatDualColor,
+  formatHex,
+  hslToRgb,
+  hsvToRgb,
+  hueToWheel,
+  inSrgbGamut,
+  isColor,
+  isDualColor,
+  isSameInBothSchemes,
+  linearSrgbToDisplayP3,
+  linearToSrgb,
+  mixColors,
+  normalizeColor,
+  normalizeDualColor,
+  oklabToOklch,
+  oklabToRgb,
+  oklchToOklab,
+  parseColor,
+  parseDualColor,
+  pickerAlphaBackground,
+  pickerAreaBackground,
+  pickerKeyStep,
+  pickerStateFromAlpha,
+  pickerStateFromArea,
+  pickerStateFromColor,
+  pickerStateFromHue,
+  pickerStateToHex,
+  pushRecentColor,
+  readableTextColor,
+  relativeLuminance,
+  resolveColor,
+  rgbToHsl,
+  rgbToHsv,
+  rgbToOklab,
+  setDualColorSide,
+  simulateColorVision,
+  srgbToLinear,
+  toSrgbGamut,
+  wheelToHue
+};

package/dist/color/mix.d.cts

@@ -0,0 +1,11 @@
+/**
+ * Colour mixing in OKLab (default), OKLCH, sRGB or linear sRGB with premultiplied alpha.
+ */
+export interface MixColorsOptions {
+    space?: 'oklab' | 'oklch' | 'srgb' | 'srgb-linear';
+}
+/**
+ * Mixes two colours at position t (0 = from, 1 = to) with premultiplied alpha.
+ * Returns null if either colour cannot be parsed.
+ */
+export declare function mixColors(from: unknown, to: unknown, t: number, options?: MixColorsOptions): string | null;

package/dist/color/mix.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Colour mixing in OKLab (default), OKLCH, sRGB or linear sRGB with premultiplied alpha.
+ */
+export interface MixColorsOptions {
+    space?: 'oklab' | 'oklch' | 'srgb' | 'srgb-linear';
+}
+/**
+ * Mixes two colours at position t (0 = from, 1 = to) with premultiplied alpha.
+ * Returns null if either colour cannot be parsed.
+ */
+export declare function mixColors(from: unknown, to: unknown, t: number, options?: MixColorsOptions): string | null;

package/dist/color/named.d.cts

@@ -0,0 +1,5 @@
+/**
+ * The 148 standard CSS named colours (CSS Color 4 / SVG 1.1) mapped to lowercase `#rrggbb`,
+ * plus `transparent` as `#00000000`.
+ */
+export declare const NAMED_COLORS: Readonly<Record<string, string>>;

package/dist/color/named.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The 148 standard CSS named colours (CSS Color 4 / SVG 1.1) mapped to lowercase `#rrggbb`,
+ * plus `transparent` as `#00000000`.
+ */
+export declare const NAMED_COLORS: Readonly<Record<string, string>>;

package/dist/color/parse.d.cts

@@ -0,0 +1,11 @@
+/**
+ * CSS colour parsing for hex, rgb, hsl, oklab, oklch, Display P3 and CSS named colours.
+ */
+import type { Rgba } from './types.cjs';
+/**
+ * Parses any supported CSS colour string or token object into an unclamped Rgba structure.
+ * Returns null for unrecognised syntax or invalid values without throwing.
+ */
+export declare function parseColor(input: unknown): Rgba | null;
+/** Returns true when the input can be parsed as a valid colour. */
+export declare function isColor(input: unknown): boolean;

package/dist/color/parse.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CSS colour parsing for hex, rgb, hsl, oklab, oklch, Display P3 and CSS named colours.
+ */
+import type { Rgba } from './types.js';
+/**
+ * Parses any supported CSS colour string or token object into an unclamped Rgba structure.
+ * Returns null for unrecognised syntax or invalid values without throwing.
+ */
+export declare function parseColor(input: unknown): Rgba | null;
+/** Returns true when the input can be parsed as a valid colour. */
+export declare function isColor(input: unknown): boolean;

package/dist/color/picker.d.cts

@@ -0,0 +1,52 @@
+/**
+ * Pure, headless colour picker state and interaction model.
+ * DOM-free: shared across React and Svelte bindings.
+ */
+import { type ColorValue, type ColorScheme } from './dual.cjs';
+export interface ColorPickerState {
+    /** Hue angle: 0 <= h < 360 */
+    h: number;
+    /** Saturation: 0 <= s <= 1 */
+    s: number;
+    /** Value / brightness: 0 <= v <= 1 */
+    v: number;
+    /** Alpha: 0 <= alpha <= 1 */
+    alpha: number;
+}
+/**
+ * Derives picker state from any CSS colour string or existing state.
+ * Preserves hue and saturation from `previous` when the new colour is achromatic
+ * (grey or black), preventing sudden hue jumps when dragging near 0.
+ */
+export declare function pickerStateFromColor(input: unknown, previous?: ColorPickerState): ColorPickerState | null;
+/** Formats current picker state as a hex string (#rrggbb or #rrggbbaa). */
+export declare function pickerStateToHex(state: ColorPickerState, forceAlpha?: boolean): string;
+/** Updates saturation (x) and value (y) from normalized coordinates (0..1). */
+export declare function pickerStateFromArea(state: ColorPickerState, x: number, y: number): ColorPickerState;
+/** Updates hue from a normalized position t (0..1 -> 0..360°). */
+export declare function pickerStateFromHue(state: ColorPickerState, t: number): ColorPickerState;
+/** Updates alpha from a normalized position t (0..1). */
+export declare function pickerStateFromAlpha(state: ColorPickerState, t: number): ColorPickerState;
+/**
+ * Handles keyboard interaction for the 2D area, hue slider, and alpha slider.
+ * Arrow keys step by 1% (or 1° for hue), with Shift multiplying by 10.
+ * Home/End jump to min/max.
+ * Returns null if the key is not handled.
+ */
+export declare function pickerKeyStep(state: ColorPickerState, target: 'area' | 'hue' | 'alpha', key: string, shift: boolean): ColorPickerState | null;
+/** CSS background for the 2D area (white-to-transparent horizontal and transparent-to-black vertical over pure hue). */
+export declare function pickerAreaBackground(state: ColorPickerState): string;
+/** CSS background for the alpha strip gradient (transparent to opaque colour). */
+export declare function pickerAlphaBackground(state: ColorPickerState): string;
+/** CSS background gradient through all hues across the 360° spectrum. */
+export declare const PICKER_HUE_BACKGROUND: string;
+/**
+ * Computes the view information for editing a dual colour in a picker for the given scheme.
+ * Returns the colour for the active scheme, whether both halves are identical ('linked'),
+ * and the other scheme's colour.
+ */
+export declare function dualPickerView(value: ColorValue, scheme: ColorScheme): {
+    color: string;
+    linked: boolean;
+    other: string;
+};

package/dist/color/picker.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Pure, headless colour picker state and interaction model.
+ * DOM-free: shared across React and Svelte bindings.
+ */
+import { type ColorValue, type ColorScheme } from './dual.js';
+export interface ColorPickerState {
+    /** Hue angle: 0 <= h < 360 */
+    h: number;
+    /** Saturation: 0 <= s <= 1 */
+    s: number;
+    /** Value / brightness: 0 <= v <= 1 */
+    v: number;
+    /** Alpha: 0 <= alpha <= 1 */
+    alpha: number;
+}
+/**
+ * Derives picker state from any CSS colour string or existing state.
+ * Preserves hue and saturation from `previous` when the new colour is achromatic
+ * (grey or black), preventing sudden hue jumps when dragging near 0.
+ */
+export declare function pickerStateFromColor(input: unknown, previous?: ColorPickerState): ColorPickerState | null;
+/** Formats current picker state as a hex string (#rrggbb or #rrggbbaa). */
+export declare function pickerStateToHex(state: ColorPickerState, forceAlpha?: boolean): string;
+/** Updates saturation (x) and value (y) from normalized coordinates (0..1). */
+export declare function pickerStateFromArea(state: ColorPickerState, x: number, y: number): ColorPickerState;
+/** Updates hue from a normalized position t (0..1 -> 0..360°). */
+export declare function pickerStateFromHue(state: ColorPickerState, t: number): ColorPickerState;
+/** Updates alpha from a normalized position t (0..1). */
+export declare function pickerStateFromAlpha(state: ColorPickerState, t: number): ColorPickerState;
+/**
+ * Handles keyboard interaction for the 2D area, hue slider, and alpha slider.
+ * Arrow keys step by 1% (or 1° for hue), with Shift multiplying by 10.
+ * Home/End jump to min/max.
+ * Returns null if the key is not handled.
+ */
+export declare function pickerKeyStep(state: ColorPickerState, target: 'area' | 'hue' | 'alpha', key: string, shift: boolean): ColorPickerState | null;
+/** CSS background for the 2D area (white-to-transparent horizontal and transparent-to-black vertical over pure hue). */
+export declare function pickerAreaBackground(state: ColorPickerState): string;
+/** CSS background for the alpha strip gradient (transparent to opaque colour). */
+export declare function pickerAlphaBackground(state: ColorPickerState): string;
+/** CSS background gradient through all hues across the 360° spectrum. */
+export declare const PICKER_HUE_BACKGROUND: string;
+/**
+ * Computes the view information for editing a dual colour in a picker for the given scheme.
+ * Returns the colour for the active scheme, whether both halves are identical ('linked'),
+ * and the other scheme's colour.
+ */
+export declare function dualPickerView(value: ColorValue, scheme: ColorScheme): {
+    color: string;
+    linked: boolean;
+    other: string;
+};

package/dist/color/recent.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Recent colours history list manager.
+ */
+/**
+ * Normalises a colour and pushes it to the front of a recents list, removing duplicates
+ * and trimming to `max` items. Returns the original list unchanged if the colour cannot be read.
+ */
+export declare function pushRecentColor(list: readonly string[], color: string, max?: number): string[];

package/dist/color/recent.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Recent colours history list manager.
+ */
+/**
+ * Normalises a colour and pushes it to the front of a recents list, removing duplicates
+ * and trimming to `max` items. Returns the original list unchanged if the colour cannot be read.
+ */
+export declare function pushRecentColor(list: readonly string[], color: string, max?: number): string[];

package/dist/color/tools.d.cts

@@ -0,0 +1,15 @@
+/**
+ * Agent tools for colour inspection, contrast verification, palette checking, harmonies, and mixing.
+ */
+import type { AgentToolProvider } from '../tools/registry.cjs';
+export interface ColorToolProviderOptions {
+    /** Provider id (unique per registry). Default 'color'. */
+    id?: string;
+    /** Tool-name prefix; defaults to provider id, '' for bare names. */
+    namespace?: string;
+}
+/**
+ * Creates an AgentToolProvider with colour inspection, contrast checks, palette checks,
+ * harmony suggestions, and colour mixing.
+ */
+export declare function createColorToolProvider(options?: ColorToolProviderOptions): AgentToolProvider;

package/dist/color/tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Agent tools for colour inspection, contrast verification, palette checking, harmonies, and mixing.
+ */
+import type { AgentToolProvider } from '../tools/registry.js';
+export interface ColorToolProviderOptions {
+    /** Provider id (unique per registry). Default 'color'. */
+    id?: string;
+    /** Tool-name prefix; defaults to provider id, '' for bare names. */
+    namespace?: string;
+}
+/**
+ * Creates an AgentToolProvider with colour inspection, contrast checks, palette checks,
+ * harmony suggestions, and colour mixing.
+ */
+export declare function createColorToolProvider(options?: ColorToolProviderOptions): AgentToolProvider;

package/dist/color/types.d.cts

@@ -0,0 +1,41 @@
+/**
+ * Core colour types: channel values, spaces, formats and vision deficiency modes.
+ */
+/** sRGB, gamma-encoded. Channels are nominally 0–1 but may fall outside for wide-gamut input; alpha 0–1. */
+export interface Rgba {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/** OKLab: l 0–1; a and b roughly −0.4–0.4; alpha 0–1. Same shape as `OklabColor` in `animation/color.ts`. */
+export interface Oklab {
+    l: number;
+    a: number;
+    b: number;
+    alpha: number;
+}
+/** OKLCH: l 0–1, c ≥ 0 (≈0.4 max in practice), h in degrees 0–360 (NaN-free: use 0 when c is 0); alpha 0–1. */
+export interface Oklch {
+    l: number;
+    c: number;
+    h: number;
+    alpha: number;
+}
+/** h in degrees 0–360; s, l 0–1; alpha 0–1. */
+export interface Hsla {
+    h: number;
+    s: number;
+    l: number;
+    alpha: number;
+}
+/** h in degrees 0–360; s, v 0–1; alpha 0–1. */
+export interface Hsva {
+    h: number;
+    s: number;
+    v: number;
+    alpha: number;
+}
+export type ColorFormat = 'hex' | 'rgb' | 'hsl' | 'oklch' | 'oklab' | 'p3';
+export type ColorVision = 'normal' | 'protanopia' | 'deuteranopia' | 'tritanopia';
+export type ContrastLevel = 'AAA' | 'AA' | 'fail';

package/dist/color/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Core colour types: channel values, spaces, formats and vision deficiency modes.
+ */
+/** sRGB, gamma-encoded. Channels are nominally 0–1 but may fall outside for wide-gamut input; alpha 0–1. */
+export interface Rgba {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/** OKLab: l 0–1; a and b roughly −0.4–0.4; alpha 0–1. Same shape as `OklabColor` in `animation/color.ts`. */
+export interface Oklab {
+    l: number;
+    a: number;
+    b: number;
+    alpha: number;
+}
+/** OKLCH: l 0–1, c ≥ 0 (≈0.4 max in practice), h in degrees 0–360 (NaN-free: use 0 when c is 0); alpha 0–1. */
+export interface Oklch {
+    l: number;
+    c: number;
+    h: number;
+    alpha: number;
+}
+/** h in degrees 0–360; s, l 0–1; alpha 0–1. */
+export interface Hsla {
+    h: number;
+    s: number;
+    l: number;
+    alpha: number;
+}
+/** h in degrees 0–360; s, v 0–1; alpha 0–1. */
+export interface Hsva {
+    h: number;
+    s: number;
+    v: number;
+    alpha: number;
+}
+export type ColorFormat = 'hex' | 'rgb' | 'hsl' | 'oklch' | 'oklab' | 'p3';
+export type ColorVision = 'normal' | 'protanopia' | 'deuteranopia' | 'tritanopia';
+export type ContrastLevel = 'AAA' | 'AA' | 'fail';

package/dist/color/vision.d.cts

@@ -0,0 +1,36 @@
+import type { Rgba, ColorVision } from './types.cjs';
+/** Simulates how a colour appears under protanopia, deuteranopia or tritanopia. */
+export declare function simulateColorVision(c: Rgba, vision: ColorVision): Rgba;
+export interface PaletteColorPair {
+    a: number;
+    b: number;
+    colors: [string, string];
+    distance: number;
+}
+export interface PaletteColorCheck {
+    /** No problems found. */
+    ok: boolean;
+    /** Per vision: the closest pair of colours and their OKLab distance. */
+    closest: Partial<Record<ColorVision, PaletteColorPair>>;
+    /** Contrast ratio of each colour against the surface (null when unreadable). */
+    contrast: (number | null)[];
+    /** Problems, as sentences. */
+    issues: string[];
+    /** Colours that could not be read; they are skipped. */
+    skipped: string[];
+}
+export interface PaletteColorCheckOptions {
+    /** The background surface behind the marks (default '#ffffff'). */
+    surface?: string;
+    /** Smallest OKLab distance two colours may have (default 0.08). */
+    minDistance?: number;
+    /** Smallest contrast ratio against the surface (default 1.5). */
+    minContrast?: number;
+    /** Visions to check (default all four). */
+    visions?: readonly ColorVision[];
+}
+/**
+ * Checks that palette colours can be distinguished under normal vision and CVD modes,
+ * and stand out from the surface background.
+ */
+export declare function checkPaletteColors(colors: readonly string[], options?: PaletteColorCheckOptions): PaletteColorCheck;

package/dist/color/vision.d.ts

@@ -0,0 +1,36 @@
+import type { Rgba, ColorVision } from './types.js';
+/** Simulates how a colour appears under protanopia, deuteranopia or tritanopia. */
+export declare function simulateColorVision(c: Rgba, vision: ColorVision): Rgba;
+export interface PaletteColorPair {
+    a: number;
+    b: number;
+    colors: [string, string];
+    distance: number;
+}
+export interface PaletteColorCheck {
+    /** No problems found. */
+    ok: boolean;
+    /** Per vision: the closest pair of colours and their OKLab distance. */
+    closest: Partial<Record<ColorVision, PaletteColorPair>>;
+    /** Contrast ratio of each colour against the surface (null when unreadable). */
+    contrast: (number | null)[];
+    /** Problems, as sentences. */
+    issues: string[];
+    /** Colours that could not be read; they are skipped. */
+    skipped: string[];
+}
+export interface PaletteColorCheckOptions {
+    /** The background surface behind the marks (default '#ffffff'). */
+    surface?: string;
+    /** Smallest OKLab distance two colours may have (default 0.08). */
+    minDistance?: number;
+    /** Smallest contrast ratio against the surface (default 1.5). */
+    minContrast?: number;
+    /** Visions to check (default all four). */
+    visions?: readonly ColorVision[];
+}
+/**
+ * Checks that palette colours can be distinguished under normal vision and CVD modes,
+ * and stand out from the surface background.
+ */
+export declare function checkPaletteColors(colors: readonly string[], options?: PaletteColorCheckOptions): PaletteColorCheck;

package/dist/effects/authoring-session.d.cts

@@ -0,0 +1,25 @@
+/**
+ * Generic effect authoring session: controls values, keyframes, presets, timing, undo/redo
+ * and preview rendering for any effect provider.
+ */
+import { HistoryManager } from '../history/HistoryManager.cjs';
+import type { EffectAuthoringSession, EffectAuthoringSource } from './authoring.cjs';
+import type { EffectProvider } from './types.cjs';
+export interface GenericAuthoringOptions {
+    /** The provider whose `describe` and `createRenderer` the session uses. */
+    provider: EffectProvider;
+    /** Undo history to record into (default: a new HistoryManager). */
+    history?: HistoryManager;
+    /**
+     * Time source for playback: called with a frame callback, returns a cancel function.
+     * Default: requestAnimationFrame where it exists, else a 16 ms timer. Tests pass a manual one.
+     */
+    schedule?: (frame: (now: number) => void) => () => void;
+    /** Ms within which `setValue` calls on one control with no gesture merge (default 400). */
+    mergeWindowMs?: number;
+}
+/**
+ * Creates an effect authoring session with values, presets, keyframes, timing and undo
+ * over any provider. It has no source editing (`sourceLanguage: null`).
+ */
+export declare function createEffectAuthoringSession(source: EffectAuthoringSource, options: GenericAuthoringOptions): Promise<EffectAuthoringSession>;

package/dist/effects/authoring-session.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Generic effect authoring session: controls values, keyframes, presets, timing, undo/redo
+ * and preview rendering for any effect provider.
+ */
+import { HistoryManager } from '../history/HistoryManager.js';
+import type { EffectAuthoringSession, EffectAuthoringSource } from './authoring.js';
+import type { EffectProvider } from './types.js';
+export interface GenericAuthoringOptions {
+    /** The provider whose `describe` and `createRenderer` the session uses. */
+    provider: EffectProvider;
+    /** Undo history to record into (default: a new HistoryManager). */
+    history?: HistoryManager;
+    /**
+     * Time source for playback: called with a frame callback, returns a cancel function.
+     * Default: requestAnimationFrame where it exists, else a 16 ms timer. Tests pass a manual one.
+     */
+    schedule?: (frame: (now: number) => void) => () => void;
+    /** Ms within which `setValue` calls on one control with no gesture merge (default 400). */
+    mergeWindowMs?: number;
+}
+/**
+ * Creates an effect authoring session with values, presets, keyframes, timing and undo
+ * over any provider. It has no source editing (`sourceLanguage: null`).
+ */
+export declare function createEffectAuthoringSession(source: EffectAuthoringSource, options: GenericAuthoringOptions): Promise<EffectAuthoringSession>;

package/dist/effects/authoring-tools.d.cts

@@ -0,0 +1,31 @@
+/**
+ * Agent tools for authoring shaders and procedural effects: inspecting controls, setting values,
+ * applying presets, managing keyframes on animation tracks, playback timing, and previewing.
+ */
+import type { AgentToolProvider } from '../tools/registry.cjs';
+import type { EffectAuthoringSession } from './authoring.cjs';
+export interface EffectAuthoringToolHost {
+    /**
+     * The open authoring session, or null when nothing is open (tools then refuse with a message
+     * explaining how to open one).
+     */
+    session(): EffectAuthoringSession | null;
+    /** Optional: a PNG data URL of the preview, for the `effect_authoring_view` tool. */
+    capture?(): Promise<string>;
+    /** Lets the tool list follow session opens, closes, or changes. */
+    subscribe?: (notify: () => void) => () => void;
+}
+export interface EffectAuthoringToolOptions {
+    /** Provider id (unique per registry). Default: 'effect-authoring'. */
+    id?: string;
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id. */
+    namespace?: string;
+    /** Toolset title. */
+    title?: string;
+    /** Toolset description. */
+    description?: string;
+    /** Name of the agent skill documenting these tools. */
+    skill?: string;
+}
+/** Creates the agent tool provider for effect authoring. */
+export declare function createEffectAuthoringToolProvider(host: EffectAuthoringToolHost, options?: EffectAuthoringToolOptions): AgentToolProvider;

package/dist/effects/authoring-tools.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Agent tools for authoring shaders and procedural effects: inspecting controls, setting values,
+ * applying presets, managing keyframes on animation tracks, playback timing, and previewing.
+ */
+import type { AgentToolProvider } from '../tools/registry.js';
+import type { EffectAuthoringSession } from './authoring.js';
+export interface EffectAuthoringToolHost {
+    /**
+     * The open authoring session, or null when nothing is open (tools then refuse with a message
+     * explaining how to open one).
+     */
+    session(): EffectAuthoringSession | null;
+    /** Optional: a PNG data URL of the preview, for the `effect_authoring_view` tool. */
+    capture?(): Promise<string>;
+    /** Lets the tool list follow session opens, closes, or changes. */
+    subscribe?: (notify: () => void) => () => void;
+}
+export interface EffectAuthoringToolOptions {
+    /** Provider id (unique per registry). Default: 'effect-authoring'. */
+    id?: string;
+    /** Tool-name prefix (`<namespace>__<name>`); defaults to the provider id. */
+    namespace?: string;
+    /** Toolset title. */
+    title?: string;
+    /** Toolset description. */
+    description?: string;
+    /** Name of the agent skill documenting these tools. */
+    skill?: string;
+}
+/** Creates the agent tool provider for effect authoring. */
+export declare function createEffectAuthoringToolProvider(host: EffectAuthoringToolHost, options?: EffectAuthoringToolOptions): AgentToolProvider;