@pixerate/editor 0.123.0 → 0.124.0

package/dist/chunk-VFAKN46Z.js

@@ -0,0 +1,215 @@
+import {
+  isEffectError
+} from "./chunk-TGKT5QAB.js";
+
+// src/effects/types.ts
+var EFFECT_KINDS = ["shader", "vector", "motion"];
+var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive"];
+
+// src/effects/tools.ts
+var ANNOTATIONS = {
+  read: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  write: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+  writeIdempotent: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  destructive: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false }
+};
+var NO_PROVIDER = "No effects provider is registered with this editor, so there are no effects to search, describe or apply. The host app must register one (setEffectsProvider); effects already in the document are kept and shown as placeholders.";
+var object = (properties, required = []) => ({
+  type: "object",
+  properties,
+  ...required.length ? { required } : {},
+  additionalProperties: false
+});
+var ENUM_LIMIT = 60;
+var summaryOut = (e) => ({
+  id: e.id,
+  name: e.name,
+  kind: e.kind,
+  category: e.category,
+  uses: e.uses,
+  ...e.description ? { description: e.description } : {},
+  transparent: e.transparent,
+  loop: e.loop,
+  ...e.duration !== void 0 ? { duration: e.duration } : {}
+});
+function createEffectToolProvider(host) {
+  let catalog = null;
+  const listeners = /* @__PURE__ */ new Set();
+  const notify = () => listeners.forEach((l) => l());
+  const catalogFor = (provider) => {
+    if (!provider) return null;
+    if (catalog?.provider !== provider) {
+      const entry = { provider, effects: null };
+      catalog = entry;
+      Promise.resolve().then(() => provider.list()).then((effects) => {
+        if (catalog === entry) {
+          entry.effects = effects;
+          notify();
+        }
+      }).catch(() => {
+      });
+    }
+    return catalog.effects;
+  };
+  const requireProvider = () => {
+    const p = host.provider();
+    if (!p) throw new Error(NO_PROVIDER);
+    return p;
+  };
+  const writable = () => {
+    const reason = host.readOnlyReason();
+    if (reason) throw new Error(reason);
+    return requireProvider();
+  };
+  const explain = async (run) => {
+    try {
+      return await run();
+    } catch (error) {
+      if (isEffectError(error)) throw new Error(error.message);
+      throw error;
+    }
+  };
+  const valuesSchema = (what, keyframes = false) => ({
+    type: "object",
+    description: `${what}: control name \u2192 value, as listed by describe_effect (its "controls" schema: types, ranges, units and defaults). Only the given controls change; colours are "#rrggbb".${keyframes ? " A number control may instead be keyframes { keys: [{ t: ms from the start, v, ease }] }." : ""} Unknown controls and out-of-range values are refused with the valid ones.`
+  });
+  const effectIdSchema = (uses) => {
+    const effects = catalogFor(host.provider())?.filter((e) => e.kind !== "motion" && e.uses.some((u) => uses.includes(u)));
+    const base = `An effect id from search_effects (use ${uses.map((u) => `"${u}"`).join(" or ")}).`;
+    return effects && effects.length && effects.length <= ENUM_LIMIT ? { type: "string", enum: effects.map((e) => e.id), description: `${base} One of: ${effects.map((e) => `${e.id} (${e.name})`).join(", ")}.` } : { type: "string", minLength: 1, description: base };
+  };
+  const context = { requireProvider: writable, valuesSchema, effectIdSchema, annotations: ANNOTATIONS };
+  const TARGET = { type: "string", minLength: 1, description: host.target.id };
+  const INSTANCE = { type: "string", minLength: 1, description: `The effect's id on the ${host.target.noun}, from list_applied_effects or apply_effect.` };
+  const INDEX = { type: "integer", minimum: 0, description: `Place in the ${host.target.noun}'s effect stack: 0 is applied first (default: the end, applied last).` };
+  const OPACITY = { type: "number", minimum: 0, maximum: 1, description: "How much of the effect shows over its input, 0\u20131 (default 1)." };
+  const ENABLED = { type: "boolean", description: "false turns the effect off but keeps it (default true)." };
+  const readTools = () => [
+    {
+      name: "search_effects",
+      title: "Search effects",
+      description: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion), category or use (${EFFECT_USES.join(", ")}). For this editor, apply_effect takes uses ${host.applyUses.join(" or ")}. Returns { provider, effects: [{ id, name, kind, category, uses, description, transparent, loop, duration (ms) }], total }. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,
+      inputSchema: object({
+        query: { type: "string", description: "Words to match (default: every effect)." },
+        kind: { type: "string", enum: [...EFFECT_KINDS], description: "shader (pixels), vector (animated SVG) or motion (animates vector art)." },
+        category: { type: "string", minLength: 1, description: `The provider's category, e.g. "gradient", "light", "transition".` },
+        use: { type: "string", enum: [...EFFECT_USES], description: "What the effect is for: filter changes a picture, transition blends two, generator draws a background, overlay draws over content, title draws a title, motion animates vector art, interactive reacts to input." },
+        limit: { type: "integer", minimum: 1, maximum: 200, description: "Most effects to return (default 20)." }
+      }),
+      annotations: { title: "Search effects", ...ANNOTATIONS.read },
+      handler: async (args) => {
+        const p = host.provider();
+        if (!p) return { available: false, reason: NO_PROVIDER, effects: [], total: 0 };
+        const found = await explain(async () => p.search(args.query ?? "", { kind: args.kind, category: args.category, use: args.use }));
+        const limit = args.limit ?? 20;
+        return { available: true, provider: { id: p.id, name: p.name, capabilities: p.capabilities }, effects: found.slice(0, limit).map(summaryOut), total: found.length };
+      }
+    },
+    {
+      name: "describe_effect",
+      title: "Describe an effect",
+      description: "Returns one effect's controls as a strict JSON Schema (each control described, with its type, range and units), its defaults, presets (named sets of values) and inputs, plus its summary. Use the control names and ranges for apply_effect and update_effect values. With no provider registered it returns available: false and the reason.",
+      inputSchema: object({ effect: { type: "string", minLength: 1, description: "An effect id from search_effects or list_applied_effects." } }, ["effect"]),
+      annotations: { title: "Describe an effect", ...ANNOTATIONS.read },
+      handler: async (args) => {
+        const p = host.provider();
+        if (!p) return { available: false, reason: NO_PROVIDER };
+        const d = await explain(async () => p.describe(args.effect));
+        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: d.kind !== "motion" && d.uses.some((u) => host.applyUses.includes(u)) };
+      }
+    },
+    {
+      name: "list_applied_effects",
+      title: "List applied effects",
+      description: `Lists the effects in the document: for each ${host.target.noun} that has any (or the one given), its effects in order with id, effect id, name, role, enabled, opacity and saved values. available is false for an effect the current provider does not have (or when none is registered): it is kept and drawn as a placeholder, and can still be removed. Works without a provider.`,
+      inputSchema: object({ target: { ...TARGET, description: `${host.target.id} Leave out to list every ${host.target.noun} with effects.` } }),
+      annotations: { title: "List applied effects", ...ANNOTATIONS.read },
+      handler: async (args) => {
+        const p = host.provider();
+        const known = new Set((p ? await explain(async () => p.list()) : []).map((e) => e.id));
+        const targets = host.list(args.target).map((t) => ({ ...t, effects: t.effects.map((e) => ({ ...e, available: known.has(e.effect) })) }));
+        return { provider: p ? { id: p.id, name: p.name } : null, ...p ? {} : { reason: NO_PROVIDER }, targets };
+      }
+    }
+  ];
+  const writeTools = () => [
+    {
+      name: "apply_effect",
+      title: "Apply an effect",
+      description: `Adds a provider effect to a ${host.target.noun}. ${host.applyDetails} values are checked against describe_effect's controls first; nothing changes if any is wrong. One undo step. Returns the effect with its new id (for update_effect and remove_effect) and the ${host.target.noun}'s effects. Refused when no provider is registered.`,
+      inputSchema: object(
+        {
+          target: TARGET,
+          effect: effectIdSchema(host.applyUses),
+          values: valuesSchema("Control values over the effect's defaults", true),
+          index: INDEX,
+          enabled: ENABLED,
+          opacity: OPACITY
+        },
+        ["target", "effect"]
+      ),
+      annotations: { title: "Apply an effect", ...ANNOTATIONS.write },
+      handler: async (args) => {
+        writable();
+        return explain(() => host.apply(args.target, args.effect, { values: args.values, index: args.index, enabled: args.enabled, opacity: args.opacity }));
+      }
+    },
+    {
+      name: "update_effect",
+      title: "Change an applied effect",
+      description: `Changes one applied effect on a ${host.target.noun}: its values (merged over the current ones; null resets a control to its default), enabled, opacity or place in the stack. Values are checked against describe_effect's controls first. One undo step. Returns the effect as it is now and the ${host.target.noun}'s effects. Refused when no provider is registered.`,
+      inputSchema: object(
+        {
+          target: TARGET,
+          effect: INSTANCE,
+          values: { ...valuesSchema("Control values to change", true), description: `${valuesSchema("Control values to change", true).description} null resets a control to its default.` },
+          enabled: ENABLED,
+          opacity: OPACITY,
+          index: { ...INDEX, description: `Move it to this place in the ${host.target.noun}'s stack (0 = applied first).` }
+        },
+        ["target", "effect"]
+      ),
+      annotations: { title: "Change an applied effect", ...ANNOTATIONS.writeIdempotent },
+      handler: async (args) => {
+        writable();
+        if (args.values === void 0 && args.enabled === void 0 && args.opacity === void 0 && args.index === void 0) throw new Error("Give at least one of values, enabled, opacity or index to change.");
+        return explain(() => host.update(args.target, args.effect, { values: args.values, enabled: args.enabled, opacity: args.opacity, index: args.index }));
+      }
+    },
+    {
+      name: "remove_effect",
+      title: "Remove an applied effect",
+      description: `Removes one applied effect from a ${host.target.noun} (an effect the provider no longer has included). One undo step. Returns what was removed and the ${host.target.noun}'s remaining effects. Refused when no provider is registered.`,
+      inputSchema: object({ target: TARGET, effect: INSTANCE }, ["target", "effect"]),
+      annotations: { title: "Remove an applied effect", ...ANNOTATIONS.destructive },
+      handler: async (args) => {
+        writable();
+        return explain(() => host.remove(args.target, args.effect));
+      }
+    }
+  ];
+  return {
+    id: host.id,
+    ...host.namespace ? { namespace: host.namespace } : {},
+    tools: () => {
+      const extra = host.extraTools?.(context) ?? [];
+      if (host.readOnlyReason()) return [...readTools(), ...extra.filter((t) => t.annotations?.readOnlyHint)];
+      return [...readTools(), ...writeTools(), ...extra];
+    },
+    subscribe: (l) => {
+      listeners.add(l);
+      const off = host.subscribe?.(l);
+      return () => {
+        listeners.delete(l);
+        off?.();
+      };
+    }
+  };
+}
+
+export {
+  EFFECT_KINDS,
+  EFFECT_USES,
+  createEffectToolProvider
+};
+//# sourceMappingURL=chunk-VFAKN46Z.js.map

package/dist/chunk-VFAKN46Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/effects/types.ts","../src/effects/tools.ts"],"sourcesContent":["/**\n * The effects contract: how an editor finds, describes and renders effects that live in another\n * package. This library ships no effects of its own here, only the shapes a provider fills in;\n * a host passes a provider to an editor (`setEffectsProvider`) and the editor degrades to its\n * old behaviour without one.\n *\n * Every time is in milliseconds. Pixels are straight-alpha RGBA rows, top to bottom.\n */\n\nimport type { JsonSchema } from '../tools/schema.js';\nimport type { FlairSvgAnimation } from '../animation-editor/flair.js';\n\n/** How an effect is drawn: a pixel shader, an animated vector picture, or motion applied to someone else's vector art. */\nexport type EffectKind = 'shader' | 'vector' | 'motion';\n\n/**\n * What an effect is for. An effect may have several uses.\n *\n * - `filter`: changes an input picture (`inputs.source`).\n * - `transition`: blends `inputs.from` into `inputs.to`; `progress` runs 0 → 1.\n * - `generator`: draws a picture from nothing (a background, a texture).\n * - `overlay`: draws something meant to sit over other content, usually with transparency.\n * - `title`: draws type or a graphic meant as a title.\n * - `motion`: animates vector art (`applyVectorEffect`).\n * - `interactive`: reacts to pointer, scroll or audio input at run time.\n */\nexport type EffectUse = 'filter' | 'transition' | 'generator' | 'overlay' | 'title' | 'motion' | 'interactive';\n\nexport const EFFECT_KINDS: readonly EffectKind[] = ['shader', 'vector', 'motion'];\nexport const EFFECT_USES: readonly EffectUse[] = ['filter', 'transition', 'generator', 'overlay', 'title', 'motion', 'interactive'];\n\n/** One entry of a provider's catalog. */\nexport interface EffectSummary {\n\t/** Stable id, saved in documents. Never reused for a different effect. */\n\tid: string;\n\tname: string;\n\tkind: EffectKind;\n\t/** The provider's own grouping (e.g. `gradient`, `light`, `transition`). */\n\tcategory: string;\n\tuses: readonly EffectUse[];\n\tdescription?: string;\n\ttags?: readonly string[];\n\t/** True when the effect's output has transparent pixels (it can sit over other content). */\n\ttransparent: boolean;\n\t/** True when the effect loops; its `duration` is then one cycle. */\n\tloop: boolean;\n\t/** Length of one play (ms). Absent for effects that do not change over time. */\n\tduration?: number;\n}\n\nexport interface EffectSearchOptions {\n\tkind?: EffectKind;\n\tcategory?: string;\n\tuse?: EffectUse;\n\t/** Most results to return. */\n\tlimit?: number;\n}\n\n/** One control value: a number, a `#rrggbb` colour or other string, a switch, or a vector of numbers. */\nexport type EffectValue = number | string | boolean | readonly number[];\nexport type EffectValues = Readonly<Record<string, EffectValue>>;\n\n/**\n * The controls of an effect as a strict JSON Schema: `type: 'object'`, `additionalProperties:\n * false`, and a `description` on every property (with units and range). `checkEffectProvider`\n * checks this.\n */\nexport type EffectControlSchema = JsonSchema & {\n\ttype: 'object';\n\tproperties: { readonly [control: string]: JsonSchema };\n\tadditionalProperties: false;\n};\n\nexport interface EffectPreset {\n\tname: string;\n\t/** Values to apply over the defaults. */\n\tvalues: EffectValues;\n}\n\n/**\n * A named input the effect reads. Filters read `source`, transitions `from` and `to`; a mask is\n * passed separately (`EffectRenderRequest.mask`), not as an input.\n */\nexport interface EffectInputSpec {\n\tname: string;\n\tkind: 'image' | 'audio';\n\tdescription: string;\n\trequired: boolean;\n}\n\n/** Everything an editor needs to show an effect's controls and render it. */\nexport interface EffectDescription extends EffectSummary {\n\tcontrols: EffectControlSchema;\n\t/** A value for every control. */\n\tdefaults: EffectValues;\n\tpresets: readonly EffectPreset[];\n\tinputs: readonly EffectInputSpec[];\n}\n\n/**\n * Pixels in and out of a renderer, shaped like `ImageData`.\n *\n * `data` is 8-bit sRGB with straight alpha and is always present. `float`, when present, is the\n * same picture as 32-bit floats in **linear light** (sRGB primaries), straight alpha, where colour\n * may exceed 1. Renderers created with `depth` 16 or 32 return `float` when the provider\n * `supportsFloat`; `data` is then its clamped sRGB encoding.\n */\nexport interface EffectPixels {\n\twidth: number;\n\theight: number;\n\tdata: Uint8ClampedArray;\n\tfloat?: Float32Array;\n}\n\n/**\n * An input picture. Always accepted as `EffectPixels`; a provider whose capabilities include\n * `supportsHostImages` also takes the host's own image objects, which saves a read back.\n */\nexport type EffectImageSource = EffectPixels | ImageBitmap | OffscreenCanvas | VideoFrame;\n\nexport interface EffectRendererOptions {\n\t/** Output size in pixels. */\n\twidth: number;\n\theight: number;\n\t/** Bits per channel of the target (default 8). 16 and 32 ask for `float` output. */\n\tdepth?: 8 | 16 | 32;\n}\n\nexport interface EffectRenderRequest {\n\t/** Effect time (ms), from the start of the effect. */\n\ttime: number;\n\t/** Control values; missing controls take their defaults. Invalid values reject with `EffectControlError`. */\n\tvalues?: EffectValues;\n\t/** Pictures for the effect's named inputs (see `EffectDescription.inputs`). */\n\tinputs?: Readonly<Record<string, EffectImageSource>>;\n\t/** Coverage (alpha channel, 0 = untouched) limiting where the effect applies. Only with `supportsMask`. */\n\tmask?: EffectImageSource;\n\t/** Transitions: how far from `from` to `to`, 0–1. Defaults to `time / duration`. */\n\tprogress?: number;\n}\n\n/** A live renderer for one effect at one size. Not safe for concurrent `render` calls. */\nexport interface EffectRenderer {\n\treadonly effectId: string;\n\treadonly width: number;\n\treadonly height: number;\n\treadonly depth: 8 | 16 | 32;\n\trender(request: EffectRenderRequest): Promise<EffectPixels>;\n\t/** Frees GPU or worker resources. Rendering afterwards rejects. */\n\tdispose(): void;\n}\n\n/** One change of an animated SVG (the shape of Flair's `SvgAnimation`). */\nexport type EffectSvgAnimation = FlairSvgAnimation;\n\n/** An animated SVG: markup plus changes to its elements (the shape of Flair's `SvgMotion`). */\nexport interface EffectVectorMotion {\n\tsvg: string;\n\tanimate?: readonly EffectSvgAnimation[];\n\t/** Length of one play (ms). */\n\tduration: number;\n\tloop: boolean;\n\t/** Ms held on the last frame before looping. */\n\thold?: number;\n}\n\n/** What a vector or motion effect is applied to: SVG markup, optionally with the ids of the elements to animate (default: all). */\nexport type EffectVectorTarget = string | { svg: string; nodeIds?: readonly string[] };\n\n/** What a provider can do, so editors can degrade cleanly. */\nexport interface EffectProviderCapabilities {\n\t/** Renders off the main thread. */\n\tsupportsWorker: boolean;\n\t/** Returns `float` pixels for depth 16 and 32 renderers. */\n\tsupportsFloat: boolean;\n\t/** Honours `EffectRenderRequest.mask`; otherwise the editor masks the result itself. */\n\tsupportsMask: boolean;\n\t/** Takes `ImageBitmap`, `OffscreenCanvas` or `VideoFrame` inputs, not only `EffectPixels`. */\n\tsupportsHostImages: boolean;\n\t/** Implements `applyVectorEffect`. */\n\tsupportsVector: boolean;\n\t/** Largest width or height a renderer accepts (px). */\n\tmaxSize?: number;\n}\n\ntype MaybePromise<T> = T | Promise<T>;\n\n/**\n * A source of effects. Implementations live outside this library (for example Flair's\n * `flairEffects()`); `createFakeEffectProvider` is a small reference implementation.\n *\n * Unknown ids reject or throw `UnknownEffectError`, invalid values `EffectControlError`, and an\n * operation the provider cannot do `EffectUnsupportedError`.\n */\nexport interface EffectProvider {\n\t/** Stable id of the provider, saved next to effect ids (e.g. `flair`). */\n\treadonly id: string;\n\treadonly name: string;\n\treadonly version?: string;\n\treadonly capabilities: EffectProviderCapabilities;\n\tlist(options?: EffectSearchOptions): MaybePromise<readonly EffectSummary[]>;\n\t/** Effects matching every word of `query` (in name, id, category, tags or description), best first. */\n\tsearch(query: string, options?: EffectSearchOptions): MaybePromise<readonly EffectSummary[]>;\n\tdescribe(id: string): MaybePromise<EffectDescription>;\n\t/** A pixel renderer. A `vector` effect may refuse with `EffectUnsupportedError` where it cannot lay out SVG (a Worker). */\n\tcreateRenderer(id: string, options: EffectRendererOptions): MaybePromise<EffectRenderer>;\n\t/**\n\t * Vector and motion effects as an animated SVG. Present when `capabilities.supportsVector`. A\n\t * `motion` effect animates the target's elements (`nodeIds`, else each top-level element with an\n\t * id); a `vector` effect brings its own picture and ignores the target. Refuse a target the\n\t * effect cannot use with `EffectUnsupportedError`.\n\t */\n\tapplyVectorEffect?(id: string, target: EffectVectorTarget, values?: EffectValues): MaybePromise<EffectVectorMotion>;\n}\n","/**\n * The agent tools for provider effects, shared by every editor that takes an `EffectProvider`:\n * `search_effects`, `describe_effect`, `list_applied_effects`, `apply_effect`, `update_effect` and\n * `remove_effect`. An editor supplies an `EffectToolHost` (what its targets are and how to change\n * them as one undo step each) and may add tools of its own (`extraTools`).\n *\n * Without a provider the read tools say so (and `list_applied_effects` still lists what a\n * document holds), and the write tools refuse with the reason. On a read-only surface the write\n * tools are hidden.\n */\n\nimport type { AgentTool, AgentToolProvider } from '../tools/registry.js';\nimport type { JsonSchema } from '../tools/schema.js';\nimport { isEffectError } from './errors.js';\nimport { EFFECT_KINDS, EFFECT_USES, type EffectDescription, type EffectProvider, type EffectSummary, type EffectUse } from './types.js';\n\n/** One effect applied to a target, as the tools report it. */\nexport interface AppliedEffectInfo {\n\t/** Its id on the target: what `update_effect` and `remove_effect` take. */\n\tid: string;\n\teffect: string;\n\tname?: string;\n\tprovider?: string;\n\t/** What it is on the target (e.g. `clip effect`, `effect clip`, `transition`, `smart filter`, `effect layer`). */\n\trole: string;\n\tenabled: boolean;\n\t/** 0–1, or keyframes, where the role has an opacity. */\n\topacity?: unknown;\n\t/** Its saved control values (numbers may be keyframes where the editor allows them). */\n\tvalues: Record<string, unknown>;\n\t/** Its place in the target's stack (0 = applied first), for stacked roles. */\n\tindex?: number;\n}\n\nexport interface EffectTargetEffects {\n\ttarget: string;\n\t/** A label for the target (a clip or layer name). */\n\tname?: string;\n\teffects: AppliedEffectInfo[];\n}\n\nexport interface EffectChangeResult {\n\ttarget: string;\n\t/** What was added, changed or removed. */\n\teffect: AppliedEffectInfo;\n\t/** The target's effects afterwards. */\n\teffects: AppliedEffectInfo[];\n\t/** Other things the change made (a new clip or layer id, ...). */\n\t[extra: string]: unknown;\n}\n\n/** What an editor gives the shared effect tools. */\nexport interface EffectToolHost {\n\t/** Provider id (unique per registry). */\n\tid: string;\n\t/** Always prefix tool names with `<namespace>__`. */\n\tnamespace?: string;\n\t/** Words for the editor's targets, e.g. `{ noun: 'clip', id: 'A clip id from get_video_project (e.g. \"c1\").' }`. */\n\ttarget: { noun: string; id: string };\n\t/** The uses `apply_effect` takes on a target (others go through `extraTools`). */\n\tapplyUses: readonly EffectUse[];\n\t/** Text added to `apply_effect`'s description: where the effect goes and how it is drawn. */\n\tapplyDetails: string;\n\t/** The current provider, or `null`. */\n\tprovider(): EffectProvider | null;\n\t/** Why edits are refused now (read-only), or `null`. */\n\treadOnlyReason(): string | null;\n\t/** Every target with effects, or one target (throws for an unknown id, naming valid ones). */\n\tlist(target?: string): EffectTargetEffects[];\n\tapply(target: string, effect: string, args: { values?: Record<string, unknown>; index?: number; enabled?: boolean; opacity?: number }): Promise<EffectChangeResult>;\n\tupdate(target: string, instance: string, changes: { values?: Record<string, unknown>; index?: number; enabled?: boolean; opacity?: number }): Promise<EffectChangeResult>;\n\tremove(target: string, instance: string): Promise<EffectChangeResult>;\n\t/** Editor-specific effect tools (transitions, effect clips, effect layers, keyframes). */\n\textraTools?: (context: EffectToolContext) => AgentTool[];\n\t/** Lets the tool list follow the provider and read-only changes. */\n\tsubscribe?: (notify: () => void) => () => void;\n}\n\n/** Shared pieces for `extraTools`. */\nexport interface EffectToolContext {\n\t/** The provider, or a thrown error saying none is registered. */\n\trequireProvider(): EffectProvider;\n\t/** The schema of a `values` argument. */\n\tvaluesSchema(what: string, keyframes?: boolean): JsonSchema;\n\t/** The schema of an `effect` argument for effects with one of `uses`. */\n\teffectIdSchema(uses: readonly EffectUse[]): JsonSchema;\n\treadonly annotations: typeof ANNOTATIONS;\n}\n\nconst ANNOTATIONS = {\n\tread: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n\twrite: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },\n\twriteIdempotent: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n\tdestructive: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false }\n} as const;\n\nconst NO_PROVIDER = 'No effects provider is registered with this editor, so there are no effects to search, describe or apply. The host app must register one (setEffectsProvider); effects already in the document are kept and shown as placeholders.';\n\nconst object = (properties: Record<string, JsonSchema>, required: string[] = []): JsonSchema & { type: 'object' } => ({\n\ttype: 'object',\n\tproperties,\n\t...(required.length ? { required } : {}),\n\tadditionalProperties: false\n});\n\n/** The catalog fetched once per provider, so tool schemas can list effect ids. */\ninterface Catalog {\n\tprovider: EffectProvider;\n\teffects: readonly EffectSummary[] | null;\n}\n\n/** Most effect ids listed in an `effect` argument's enum; larger catalogs are searched instead. */\nconst ENUM_LIMIT = 60;\n\nconst summaryOut = (e: EffectSummary) => ({\n\tid: e.id,\n\tname: e.name,\n\tkind: e.kind,\n\tcategory: e.category,\n\tuses: e.uses,\n\t...(e.description ? { description: e.description } : {}),\n\ttransparent: e.transparent,\n\tloop: e.loop,\n\t...(e.duration !== undefined ? { duration: e.duration } : {})\n});\n\n/** The agent tools for provider effects in one editor (see the module comment). */\nexport function createEffectToolProvider(host: EffectToolHost): AgentToolProvider {\n\tlet catalog: Catalog | null = null;\n\tconst listeners = new Set<() => void>();\n\tconst notify = () => listeners.forEach((l) => l());\n\n\t/** Fetches the catalog of a new provider in the background; the tool list changes when it lands. */\n\tconst catalogFor = (provider: EffectProvider | null): readonly EffectSummary[] | null => {\n\t\tif (!provider) return null;\n\t\tif (catalog?.provider !== provider) {\n\t\t\tconst entry: Catalog = { provider, effects: null };\n\t\t\tcatalog = entry;\n\t\t\tPromise.resolve()\n\t\t\t\t.then(() => provider.list())\n\t\t\t\t.then((effects) => {\n\t\t\t\t\tif (catalog === entry) {\n\t\t\t\t\t\tentry.effects = effects;\n\t\t\t\t\t\tnotify();\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t\t.catch(() => {});\n\t\t}\n\t\treturn catalog.effects;\n\t};\n\n\tconst requireProvider = (): EffectProvider => {\n\t\tconst p = host.provider();\n\t\tif (!p) throw new Error(NO_PROVIDER);\n\t\treturn p;\n\t};\n\tconst writable = () => {\n\t\tconst reason = host.readOnlyReason();\n\t\tif (reason) throw new Error(reason);\n\t\treturn requireProvider();\n\t};\n\t/** Turns provider errors into messages a model can act on. */\n\tconst explain = async <T>(run: () => Promise<T>): Promise<T> => {\n\t\ttry {\n\t\t\treturn await run();\n\t\t} catch (error) {\n\t\t\tif (isEffectError(error)) throw new Error(error.message);\n\t\t\tthrow error;\n\t\t}\n\t};\n\n\tconst valuesSchema = (what: string, keyframes = false): JsonSchema => ({\n\t\ttype: 'object',\n\t\tdescription: `${what}: control name → value, as listed by describe_effect (its \"controls\" schema: types, ranges, units and defaults). Only the given controls change; colours are \"#rrggbb\".${keyframes ? ' A number control may instead be keyframes { keys: [{ t: ms from the start, v, ease }] }.' : ''} Unknown controls and out-of-range values are refused with the valid ones.`\n\t});\n\tconst effectIdSchema = (uses: readonly EffectUse[]): JsonSchema => {\n\t\tconst effects = catalogFor(host.provider())?.filter((e) => e.kind !== 'motion' && e.uses.some((u) => uses.includes(u)));\n\t\tconst base = `An effect id from search_effects (use ${uses.map((u) => `\"${u}\"`).join(' or ')}).`;\n\t\treturn effects && effects.length && effects.length <= ENUM_LIMIT\n\t\t\t? { type: 'string', enum: effects.map((e) => e.id), description: `${base} One of: ${effects.map((e) => `${e.id} (${e.name})`).join(', ')}.` }\n\t\t\t: { type: 'string', minLength: 1, description: base };\n\t};\n\tconst context: EffectToolContext = { requireProvider: writable, valuesSchema, effectIdSchema, annotations: ANNOTATIONS };\n\n\tconst TARGET = { type: 'string', minLength: 1, description: host.target.id } as const;\n\tconst INSTANCE = { type: 'string', minLength: 1, description: `The effect's id on the ${host.target.noun}, from list_applied_effects or apply_effect.` } as const;\n\tconst INDEX = { type: 'integer', minimum: 0, description: `Place in the ${host.target.noun}'s effect stack: 0 is applied first (default: the end, applied last).` } as const;\n\tconst OPACITY = { type: 'number', minimum: 0, maximum: 1, description: 'How much of the effect shows over its input, 0–1 (default 1).' } as const;\n\tconst ENABLED = { type: 'boolean', description: 'false turns the effect off but keeps it (default true).' } as const;\n\n\tconst readTools = (): AgentTool[] => [\n\t\t{\n\t\t\tname: 'search_effects',\n\t\t\ttitle: 'Search effects',\n\t\t\tdescription: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion), category or use (${EFFECT_USES.join(', ')}). For this editor, apply_effect takes uses ${host.applyUses.join(' or ')}. Returns { provider, effects: [{ id, name, kind, category, uses, description, transparent, loop, duration (ms) }], total }. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,\n\t\t\tinputSchema: object({\n\t\t\t\tquery: { type: 'string', description: 'Words to match (default: every effect).' },\n\t\t\t\tkind: { type: 'string', enum: [...EFFECT_KINDS], description: 'shader (pixels), vector (animated SVG) or motion (animates vector art).' },\n\t\t\t\tcategory: { type: 'string', minLength: 1, description: 'The provider\\'s category, e.g. \"gradient\", \"light\", \"transition\".' },\n\t\t\t\tuse: { type: 'string', enum: [...EFFECT_USES], description: 'What the effect is for: filter changes a picture, transition blends two, generator draws a background, overlay draws over content, title draws a title, motion animates vector art, interactive reacts to input.' },\n\t\t\t\tlimit: { type: 'integer', minimum: 1, maximum: 200, description: 'Most effects to return (default 20).' }\n\t\t\t}),\n\t\t\tannotations: { title: 'Search effects', ...ANNOTATIONS.read },\n\t\t\thandler: async (args) => {\n\t\t\t\tconst p = host.provider();\n\t\t\t\tif (!p) return { available: false, reason: NO_PROVIDER, effects: [], total: 0 };\n\t\t\t\tconst found = await explain(async () => p.search((args.query as string | undefined) ?? '', { kind: args.kind, category: args.category, use: args.use }));\n\t\t\t\tconst limit = (args.limit as number | undefined) ?? 20;\n\t\t\t\treturn { available: true, provider: { id: p.id, name: p.name, capabilities: p.capabilities }, effects: found.slice(0, limit).map(summaryOut), total: found.length };\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: 'describe_effect',\n\t\t\ttitle: 'Describe an effect',\n\t\t\tdescription: 'Returns one effect\\'s controls as a strict JSON Schema (each control described, with its type, range and units), its defaults, presets (named sets of values) and inputs, plus its summary. Use the control names and ranges for apply_effect and update_effect values. With no provider registered it returns available: false and the reason.',\n\t\t\tinputSchema: object({ effect: { type: 'string', minLength: 1, description: 'An effect id from search_effects or list_applied_effects.' } }, ['effect']),\n\t\t\tannotations: { title: 'Describe an effect', ...ANNOTATIONS.read },\n\t\t\thandler: async (args) => {\n\t\t\t\tconst p = host.provider();\n\t\t\t\tif (!p) return { available: false, reason: NO_PROVIDER };\n\t\t\t\tconst d: EffectDescription = await explain(async () => p.describe(args.effect as string));\n\t\t\t\treturn { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: d.kind !== 'motion' && d.uses.some((u) => host.applyUses.includes(u)) };\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: 'list_applied_effects',\n\t\t\ttitle: 'List applied effects',\n\t\t\tdescription: `Lists the effects in the document: for each ${host.target.noun} that has any (or the one given), its effects in order with id, effect id, name, role, enabled, opacity and saved values. available is false for an effect the current provider does not have (or when none is registered): it is kept and drawn as a placeholder, and can still be removed. Works without a provider.`,\n\t\t\tinputSchema: object({ target: { ...TARGET, description: `${host.target.id} Leave out to list every ${host.target.noun} with effects.` } }),\n\t\t\tannotations: { title: 'List applied effects', ...ANNOTATIONS.read },\n\t\t\thandler: async (args) => {\n\t\t\t\tconst p = host.provider();\n\t\t\t\tconst known = new Set((p ? await explain(async () => p.list()) : []).map((e) => e.id));\n\t\t\t\tconst targets = host.list(args.target as string | undefined).map((t) => ({ ...t, effects: t.effects.map((e) => ({ ...e, available: known.has(e.effect) })) }));\n\t\t\t\treturn { provider: p ? { id: p.id, name: p.name } : null, ...(p ? {} : { reason: NO_PROVIDER }), targets };\n\t\t\t}\n\t\t}\n\t];\n\n\tconst writeTools = (): AgentTool[] => [\n\t\t{\n\t\t\tname: 'apply_effect',\n\t\t\ttitle: 'Apply an effect',\n\t\t\tdescription: `Adds a provider effect to a ${host.target.noun}. ${host.applyDetails} values are checked against describe_effect's controls first; nothing changes if any is wrong. One undo step. Returns the effect with its new id (for update_effect and remove_effect) and the ${host.target.noun}'s effects. Refused when no provider is registered.`,\n\t\t\tinputSchema: object(\n\t\t\t\t{\n\t\t\t\t\ttarget: TARGET,\n\t\t\t\t\teffect: effectIdSchema(host.applyUses),\n\t\t\t\t\tvalues: valuesSchema('Control values over the effect\\'s defaults', true),\n\t\t\t\t\tindex: INDEX,\n\t\t\t\t\tenabled: ENABLED,\n\t\t\t\t\topacity: OPACITY\n\t\t\t\t},\n\t\t\t\t['target', 'effect']\n\t\t\t),\n\t\t\tannotations: { title: 'Apply an effect', ...ANNOTATIONS.write },\n\t\t\thandler: async (args) => {\n\t\t\t\twritable();\n\t\t\t\treturn explain(() => host.apply(args.target as string, args.effect as string, { values: args.values, index: args.index, enabled: args.enabled, opacity: args.opacity }));\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: 'update_effect',\n\t\t\ttitle: 'Change an applied effect',\n\t\t\tdescription: `Changes one applied effect on a ${host.target.noun}: its values (merged over the current ones; null resets a control to its default), enabled, opacity or place in the stack. Values are checked against describe_effect's controls first. One undo step. Returns the effect as it is now and the ${host.target.noun}'s effects. Refused when no provider is registered.`,\n\t\t\tinputSchema: object(\n\t\t\t\t{\n\t\t\t\t\ttarget: TARGET,\n\t\t\t\t\teffect: INSTANCE,\n\t\t\t\t\tvalues: { ...valuesSchema('Control values to change', true), description: `${valuesSchema('Control values to change', true).description} null resets a control to its default.` },\n\t\t\t\t\tenabled: ENABLED,\n\t\t\t\t\topacity: OPACITY,\n\t\t\t\t\tindex: { ...INDEX, description: `Move it to this place in the ${host.target.noun}'s stack (0 = applied first).` }\n\t\t\t\t},\n\t\t\t\t['target', 'effect']\n\t\t\t),\n\t\t\tannotations: { title: 'Change an applied effect', ...ANNOTATIONS.writeIdempotent },\n\t\t\thandler: async (args) => {\n\t\t\t\twritable();\n\t\t\t\tif (args.values === undefined && args.enabled === undefined && args.opacity === undefined && args.index === undefined) throw new Error('Give at least one of values, enabled, opacity or index to change.');\n\t\t\t\treturn explain(() => host.update(args.target as string, args.effect as string, { values: args.values, enabled: args.enabled, opacity: args.opacity, index: args.index }));\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: 'remove_effect',\n\t\t\ttitle: 'Remove an applied effect',\n\t\t\tdescription: `Removes one applied effect from a ${host.target.noun} (an effect the provider no longer has included). One undo step. Returns what was removed and the ${host.target.noun}'s remaining effects. Refused when no provider is registered.`,\n\t\t\tinputSchema: object({ target: TARGET, effect: INSTANCE }, ['target', 'effect']),\n\t\t\tannotations: { title: 'Remove an applied effect', ...ANNOTATIONS.destructive },\n\t\t\thandler: async (args) => {\n\t\t\t\twritable();\n\t\t\t\treturn explain(() => host.remove(args.target as string, args.effect as string));\n\t\t\t}\n\t\t}\n\t];\n\n\treturn {\n\t\tid: host.id,\n\t\t...(host.namespace ? { namespace: host.namespace } : {}),\n\t\ttools: () => {\n\t\t\tconst extra = host.extraTools?.(context) ?? [];\n\t\t\tif (host.readOnlyReason()) return [...readTools(), ...extra.filter((t) => t.annotations?.readOnlyHint)];\n\t\t\treturn [...readTools(), ...writeTools(), ...extra];\n\t\t},\n\t\tsubscribe: (l) => {\n\t\t\tlisteners.add(l);\n\t\t\tconst off = host.subscribe?.(l);\n\t\t\treturn () => {\n\t\t\t\tlisteners.delete(l);\n\t\t\t\toff?.();\n\t\t\t};\n\t\t}\n\t};\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-6ZBR4J62.js → chunk-WATAQ2Z2.js}

@@ -4661,6 +4661,15 @@ var fail4 = (message) => {
   throw new LayerOperationError(message);
 };
 var SMART_RENDER_MARGIN = MAX_EFFECT_REACH;
+var incompleteSurfaces = /* @__PURE__ */ new WeakSet();
+var isSmartSurfaceIncomplete = (surface) => incompleteSurfaces.has(surface);
+var surfaceIds = /* @__PURE__ */ new WeakMap();
+var nextSurfaceId = 0;
+var surfaceId = (s) => {
+  let id = surfaceIds.get(s);
+  if (id === void 0) surfaceIds.set(s, id = ++nextSurfaceId);
+  return id;
+};
 function newContentsId() {
   return newLayerId("so");
 }
@@ -4802,7 +4811,15 @@ function placeContents(layer, canvas, options = {}) {
 }
 function activeSmartFilters(stack) {
   if (!stack?.enabled) return [];
-  return stack.filters.filter((f) => f.kind !== "psd" && isActiveFilter(f) && f.opacity > 0);
+  return stack.filters.filter((f) => f.kind !== "psd" && f.kind !== "effect" && isActiveFilter(f) && f.opacity > 0);
+}
+function activeEffectSmartFilters(stack) {
+  if (!stack?.enabled) return [];
+  return stack.filters.filter((f) => f.kind === "effect" && f.enabled && f.opacity > 0);
+}
+function runnableSmartFilters(stack) {
+  if (!stack?.enabled) return [];
+  return stack.filters.filter((f) => f.opacity > 0 && (f.kind === "effect" ? f.enabled : f.kind !== "psd" && isActiveFilter(f)));
 }
 function filterMaskCoverage(mask, canvas) {
   if (!mask || mask.enabled === false || mask.source) return null;
@@ -4823,27 +4840,41 @@ function filterMaskCoverage(mask, canvas) {
   return v;
 }
 function applySmartFilters(placed, stack, canvas) {
-  const active = activeSmartFilters(stack);
+  const active = runnableSmartFilters(stack);
   if (!active.length || !(canvas.width > 0 && canvas.height > 0)) return placed;
   const W = canvas.width;
   const H = canvas.height;
-  const key = JSON.stringify([W, H, active.map((f) => ({ ...f, id: void 0 }))]);
+  const token = active.some((f) => f.kind === "effect") ? canvas.effects?.token ?? -1 : 0;
+  const key = JSON.stringify([W, H, token, active.map((f) => ({ ...f, id: void 0 }))]);
   let entry = filteredCache.get(placed);
+  let incomplete = false;
   if (!entry || entry.key !== key) {
     const base = readRegion(placed, { x: 0, y: 0, width: W, height: H });
     let acc = new Uint8ClampedArray(base);
-    for (const f of active) {
-      const out = new Uint8ClampedArray(acc);
-      runLayerFilters(out, W, H, [f]);
+    for (const [i, f] of active.entries()) {
+      let out2;
+      if (f.kind === "effect") {
+        if (incomplete) continue;
+        const inputKey = JSON.stringify([surfaceId(placed), W, H, active.slice(0, i + 1).map((x) => ({ ...x, id: void 0, blend: x === f ? void 0 : x.blend, opacity: x === f ? void 0 : x.opacity }))]);
+        const r = canvas.effects?.resolve(f, acc, W, H, inputKey);
+        if (!r?.result) {
+          if (r?.pending) incomplete = true;
+          continue;
+        }
+        out2 = new Uint8ClampedArray(r.result);
+      } else {
+        out2 = new Uint8ClampedArray(acc);
+        runLayerFilters(out2, W, H, [f]);
+      }
       if (f.blend === "normal") {
-        if (f.opacity >= 1) acc = out;
-        else lerpInto(acc, out, f.opacity, null);
+        if (f.opacity >= 1) acc = out2;
+        else lerpInto(acc, out2, f.opacity, null);
       } else {
-        blendTile(acc, out, f.blend, f.opacity, null);
+        blendTile(acc, out2, f.blend, f.opacity, null);
       }
     }
     entry = { key, base, filtered: acc };
-    filteredCache.set(placed, entry);
+    if (!incomplete) filteredCache.set(placed, entry);
   }
   const cov = filterMaskCoverage(stack.mask, canvas);
   let result = entry.filtered;
@@ -4851,7 +4882,9 @@ function applySmartFilters(placed, stack, canvas) {
     result = new Uint8ClampedArray(entry.base);
     lerpInto(result, entry.filtered, 1, cov);
   }
-  return surfaceFromPixels({ width: W, height: H, data: result }, 4, 0, 0);
+  const out = surfaceFromPixels({ width: W, height: H, data: result }, 4, 0, 0);
+  if (incomplete) incompleteSurfaces.add(out);
+  return out;
 }
 function lerpInto(dst, src, k, coverage) {
   for (let i = 0, p = 0; i < dst.length; i += 4, p++) {
@@ -4940,7 +4973,7 @@ function offsetSmartObject(layers, id, dx, dy, canvas) {
   const moveMask = (m2) => m2 && m2.linked !== false && !m2.source ? { ...m2, surface: translateSurface(m2.surface, mx, my) } : m2;
   if (layer.mask) next.mask = moveMask(layer.mask);
   if (layer.smartFilters?.mask) next.smartFilters = { ...layer.smartFilters, mask: moveMask(layer.smartFilters.mask) };
-  const spatial = activeSmartFilters(layer.smartFilters).some((f) => f.kind === "blur");
+  const spatial = activeSmartFilters(layer.smartFilters).some((f) => f.kind === "blur") || activeEffectSmartFilters(layer.smartFilters).length > 0;
   const b = contentBounds(layer.surface);
   const m = SMART_RENDER_MARGIN;
   const cut = b && (b.x <= -m || b.y <= -m || b.x + b.width >= canvas.width + m || b.y + b.height >= canvas.height + m);
@@ -5185,13 +5218,27 @@ function refitPlacement(layer, contents) {
 }
 function normalizeSmartFilter(raw, id = newLayerId("flt")) {
   if (raw.kind === "psd") fail4("Photoshop filters can only come from a PSD; add develop or blur.");
-  const base = normalizeFilter(raw, id);
+  const base = raw.kind === "effect" ? normalizeEffectSmartFilter(raw, id) : normalizeFilter(raw, id);
   const blend = raw.blend ?? "normal";
   if (!isBlendMode(blend) || blend === "pigment") fail4(`Unknown blend mode "${String(blend)}" for a smart filter.`);
   const opacity = raw.opacity ?? 1;
   if (!(typeof opacity === "number" && opacity >= 0 && opacity <= 1)) fail4("opacity must be a number from 0 to 1.");
   return { ...base, blend, opacity };
 }
+function normalizeEffectSmartFilter(raw, id) {
+  if (typeof raw.effect !== "string" || !raw.effect) fail4('An effect smart filter needs an "effect" id from search_effects.');
+  const values = raw.values ?? {};
+  if (typeof values !== "object" || values === null || Array.isArray(values)) fail4('"values" must be an object of control values.');
+  return {
+    id,
+    kind: "effect",
+    enabled: raw.enabled !== false,
+    effect: raw.effect,
+    ...typeof raw.provider === "string" ? { provider: raw.provider } : {},
+    ...typeof raw.name === "string" ? { name: raw.name } : {},
+    values: { ...values }
+  };
+}
 function withStack(layer, stack, canvas) {
   const next = { ...layer };
   if (stack && (stack.filters.length || stack.mask || !stack.enabled)) next.smartFilters = stack;
@@ -5422,6 +5469,7 @@ function serializeLayer(layer, ctx) {
       }
       if (layer.fillOpacity !== void 0 && layer.fillOpacity !== 1) out.fillOpacity = layer.fillOpacity;
       if (layer.filters?.length) out.filters = JSON.parse(JSON.stringify(layer.filters));
+      if (layer.generator) out.generator = JSON.parse(JSON.stringify(layer.generator));
       if (layer.source !== "document") {
         const deep = encodeDeepSurface(layer.surface);
         if (deep) out.deep = deep;
@@ -5812,6 +5860,8 @@ function deserializeLayer(raw, ctx) {
       if (typeof r.fillOpacity === "number" && r.fillOpacity !== 1) layer.fillOpacity = num2(r.fillOpacity, 0, 1, 1);
       const filters = readFilters(r.filters);
       if (filters) layer.filters = filters;
+      const generator = readEffectRef(r.generator);
+      if (generator) layer.generator = { ...generator, ...typeof r.generator.time === "number" && r.generator.time > 0 ? { time: r.generator.time } : {} };
       return layer;
     }
     case "adjustment": {
@@ -5898,6 +5948,15 @@ function readContents(id, ctx) {
   memo.set(id, c);
   return c;
 }
+var isEffectValue = (x) => typeof x === "string" || typeof x === "boolean" || typeof x === "number" && Number.isFinite(x) || Array.isArray(x) && x.every((n) => typeof n === "number" && Number.isFinite(n));
+function readEffectRef(raw) {
+  if (!raw || typeof raw !== "object" || typeof raw.effect !== "string" || !raw.effect) return void 0;
+  const values = {};
+  if (raw.values && typeof raw.values === "object") {
+    for (const [k, v] of Object.entries(raw.values)) if (isEffectValue(v)) values[k] = Array.isArray(v) ? [...v] : v;
+  }
+  return { effect: raw.effect, ...typeof raw.provider === "string" ? { provider: raw.provider } : {}, ...typeof raw.name === "string" ? { name: raw.name } : {}, values };
+}
 function readSmartFilters(raw, ctx, what) {
   if (!raw || typeof raw !== "object") return void 0;
   const r = raw;
@@ -5918,6 +5977,10 @@ function readSmartFilters(raw, ctx, what) {
     } else if (f.kind === "develop" || f.kind === "blur") {
       const base = plain[k++];
       if (base) filters.push({ ...base, blend, opacity });
+    } else if (f.kind === "effect") {
+      const ref = readEffectRef(f);
+      if (ref) filters.push({ id: typeof f.id === "string" ? f.id : newLayerId("flt"), kind: "effect", enabled: f.enabled !== false, ...ref, blend, opacity });
+      else ctx.problems.push(`${what}: an effect smart filter without an effect id was left out`);
     }
   }
   const stack = { enabled: r.enabled !== false, filters };
@@ -11594,6 +11657,7 @@ export {
   isValidWarp,
   geometryHomography,
   SMART_RENDER_MARGIN,
+  isSmartSurfaceIncomplete,
   newContentsId,
   contentsBox,
   placementGeometry,
@@ -11605,6 +11669,7 @@ export {
   documentContents,
   placeContents,
   activeSmartFilters,
+  activeEffectSmartFilters,
   filterMaskCoverage,
   applySmartFilters,
   renderSmartObject,
@@ -11671,4 +11736,4 @@ export {
   smartContentsFile,
   exportPsd
 };
-//# sourceMappingURL=chunk-6ZBR4J62.js.map
+//# sourceMappingURL=chunk-WATAQ2Z2.js.map