@pixerate/editor 0.123.0 → 0.124.1

package/dist/effects/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/editor/editor/packages/core/dist/effects/index.cjs","../../src/effects/conformance.ts","../../src/effects/fake.ts","../../src/effects/ui.ts"],"names":["input"],"mappings":"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,MAAA;AAClF,MAAA;AACK,MAAA;AACX,MAAA;AACN,QAAA;AACsF,QAAA;AACzC,QAAA;AACvC,QAAA;AACP,MAAA;AACD,IAAA;AACD,EAAA;AACO,EAAA;AACR;AF6GqG;AACA;AGtd/B;AAC7D,EAAA;AACI,EAAA;AACD,EAAA;AACF,EAAA;AACF,EAAA;AACC,EAAA;AACK,EAAA;AACd;AAEY;AACoF;AAO+B;AACxB,EAAA;AACvE,EAAA;AACL,EAAA;AAC4B,EAAA;AACyD,IAAA;AACf,IAAA;AAChG,EAAA;AAC6C,EAAA;AACP,IAAA;AACA,IAAA;AACkD,IAAA;AACxF,EAAA;AACiF,EAAA;AAC1D,EAAA;AACoE,IAAA;AACF,IAAA;AACzF,EAAA;AAC+F,EAAA;AAC/D,IAAA;AAC2E,IAAA;AAC3G,EAAA;AACO,EAAA;AACR;AAGuH;AAEzE,EAAA;AAE9C;AAI4D;AAMkC;AACnD,EAAA;AACF,EAAA;AACC,IAAA;AACJ,MAAA;AACC,MAAA;AACoB,MAAA;AACsC,MAAA;AACA,MAAA;AAC/F,IAAA;AACD,EAAA;AACO,EAAA;AACR;AASuM;AACnK,EAAA;AACqB,EAAA;AACH,EAAA;AAC9B,EAAA;AACb,EAAA;AAE8D,IAAA;AAC7B,IAAA;AACR,IAAA;AAChB,IAAA;AACnB,EAAA;AACO,EAAA;AACR;AAEmF;AAC5B;AAE6G;AAC1F,EAAA;AAChB,EAAA;AACrD,EAAA;AACwC,IAAA;AACG,IAAA;AACiC,IAAA;AACkB,IAAA;AAChG,EAAA;AACgB,IAAA;AAClB,EAAA;AACD;AAG6H;AACxF,EAAA;AACX,EAAA;AACO,IAAA;AAChB,IAAA;AACgB,IAAA;AAChC,EAAA;AAC0E,EAAA;AAC3E;AHwbqG;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/editor/editor/packages/core/dist/effects/index.cjs","sourcesContent":[null,"/**\n * `checkEffectProvider`: a conformance check any provider can run in its own tests, so editors\n * can rely on the contract (strict control schemas, valid defaults, typed errors, renderers that\n * return the size they were asked for).\n */\n\nimport { isEffectError } from './errors.js';\nimport { createEffectPixels, effectValueErrors, isEffectPixels } from './helpers.js';\nimport { EFFECT_KINDS, EFFECT_USES, type EffectDescription, type EffectPixels, type EffectProvider, type EffectSummary } from './types.js';\n\nexport interface EffectConformanceIssue {\n\teffectId?: string;\n\tmessage: string;\n}\n\nexport interface EffectConformanceOptions {\n\t/** Effects to check in depth (default: every listed effect). */\n\tids?: readonly string[];\n\t/** Also create renderers and render one small frame of each pixel effect (default true). */\n\trender?: boolean;\n\t/** Renderer size for the render check (default 8). */\n\tsize?: number;\n}\n\nconst codeOf = (e: unknown) => (isEffectError(e) ? e.code : e instanceof Error ? `untyped ${e.name}: ${e.message}` : String(e));\n\nasync function rejectsWith(code: string, run: () => unknown): Promise<string | null> {\n\ttry {\n\t\tawait run();\n\t\treturn `did not fail (expected ${code})`;\n\t} catch (e) {\n\t\tconst got = codeOf(e);\n\t\treturn got === code ? null : `failed with ${got} (expected ${code})`;\n\t}\n}\n\nfunction checkSummary(e: EffectSummary, issues: EffectConformanceIssue[]) {\n\tconst at = (message: string) => issues.push({ effectId: e.id, message });\n\tif (!e.id || typeof e.id !== 'string') at('summary has no id');\n\tif (!e.name) at('summary has no name');\n\tif (!EFFECT_KINDS.includes(e.kind)) at(`kind \"${e.kind}\" is not one of ${EFFECT_KINDS.join(', ')}`);\n\tif (!e.category) at('summary has no category');\n\tif (!Array.isArray(e.uses) || !e.uses.length) at('summary has no uses');\n\tfor (const u of e.uses ?? []) if (!EFFECT_USES.includes(u)) at(`use \"${u}\" is not one of ${EFFECT_USES.join(', ')}`);\n\tif (typeof e.transparent !== 'boolean') at('transparent is not a boolean');\n\tif (typeof e.loop !== 'boolean') at('loop is not a boolean');\n\tif (e.duration !== undefined && !(e.duration > 0)) at('duration must be a positive number of ms when present');\n}\n\nfunction checkDescription(id: string, d: EffectDescription, issues: EffectConformanceIssue[]) {\n\tconst at = (message: string) => issues.push({ effectId: id, message });\n\tif (d.id !== id) at(`describe(\"${id}\") returned id \"${d.id}\"`);\n\tconst c = d.controls;\n\tif (!c || c.type !== 'object') at('controls is not an object schema');\n\tif (c?.additionalProperties !== false) at('controls must set additionalProperties: false');\n\tfor (const [name, schema] of Object.entries(c?.properties ?? {})) {\n\t\tif (!schema.description || !String(schema.description).trim()) at(`control \"${name}\" has no description`);\n\t\tif (!(name in (d.defaults ?? {}))) at(`control \"${name}\" has no default`);\n\t}\n\tfor (const name of Object.keys(d.defaults ?? {})) if (!(name in (c?.properties ?? {}))) at(`default \"${name}\" is not a control`);\n\tfor (const e of effectValueErrors(d, d.defaults)) at(`default ${e.path}: ${e.message}`);\n\tfor (const p of d.presets ?? []) for (const e of effectValueErrors(d, p.values)) at(`preset \"${p.name}\" ${e.path}: ${e.message}`);\n\tfor (const input of d.inputs ?? []) {\n\t\tif (!input.name || !input.description) at('every input needs a name and a description');\n\t\tif (input.kind !== 'image' && input.kind !== 'audio') at(`input \"${input.name}\" has kind \"${input.kind}\"`);\n\t}\n\tif (d.uses.includes('filter') && !d.inputs.some((i) => i.name === 'source')) at('a filter must read an input named \"source\"');\n\tif (d.uses.includes('transition') && !(d.inputs.some((i) => i.name === 'from') && d.inputs.some((i) => i.name === 'to'))) {\n\t\tat('a transition must read inputs named \"from\" and \"to\"');\n\t}\n}\n\nfunction grey(size: number): EffectPixels {\n\tconst p = createEffectPixels(size, size);\n\tp.data.fill(128);\n\treturn p;\n}\n\nasync function checkRender(provider: EffectProvider, d: EffectDescription, size: number, issues: EffectConformanceIssue[]) {\n\tconst at = (message: string) => issues.push({ effectId: d.id, message });\n\tconst inputs = Object.fromEntries(d.inputs.filter((i) => i.kind === 'image').map((i) => [i.name, grey(size)]));\n\tlet renderer;\n\ttry {\n\t\trenderer = await provider.createRenderer(d.id, { width: size, height: size });\n\t} catch (e) {\n\t\t// A vector effect may need the host's help to become pixels (a Worker has no DOM to lay out SVG).\n\t\tif (!(d.kind === 'vector' && codeOf(e) === 'unsupported')) at(`createRenderer failed: ${codeOf(e)}`);\n\t\treturn;\n\t}\n\ttry {\n\t\tconst out = await renderer.render({ time: 0, inputs });\n\t\tif (!isEffectPixels(out)) at('render did not return EffectPixels');\n\t\telse if (out.width !== size || out.height !== size || out.data.length !== size * size * 4) at(`render returned ${out.width}×${out.height}, not ${size}×${size}`);\n\t} catch (e) {\n\t\tat(`render failed: ${codeOf(e)}`);\n\t}\n\tconst bad = await rejectsWith('invalid_values', () => renderer.render({ time: 0, inputs, values: { __not_a_control__: 1 } }));\n\tif (bad) at(`render with an unknown control ${bad}`);\n\trenderer.dispose();\n\tconst after = await rejectsWith('disposed', () => renderer.render({ time: 0, inputs }));\n\tif (after) at(`render after dispose ${after}`);\n}\n\n/** Runs the contract checks against `provider` and returns every issue found (empty when it conforms). */\nexport async function checkEffectProvider(provider: EffectProvider, options: EffectConformanceOptions = {}): Promise<EffectConformanceIssue[]> {\n\tconst issues: EffectConformanceIssue[] = [];\n\tconst top = (message: string) => issues.push({ message });\n\tif (!provider.id) top('provider has no id');\n\tconst caps = provider.capabilities;\n\tfor (const k of ['supportsWorker', 'supportsFloat', 'supportsMask', 'supportsHostImages', 'supportsVector'] as const) {\n\t\tif (typeof caps?.[k] !== 'boolean') top(`capabilities.${k} is not a boolean`);\n\t}\n\tif (caps?.supportsVector && typeof provider.applyVectorEffect !== 'function') top('supportsVector is set but applyVectorEffect is missing');\n\n\tconst list = await provider.list();\n\tconst ids = new Set<string>();\n\tfor (const e of list) {\n\t\tif (ids.has(e.id)) top(`duplicate id \"${e.id}\"`);\n\t\tids.add(e.id);\n\t\tcheckSummary(e, issues);\n\t}\n\tconst all = await provider.search('');\n\tif (all.length !== list.length) top(`search(\"\") returned ${all.length} effects, list() ${list.length}`);\n\tconst firstUse = list[0]?.uses[0];\n\tif (firstUse) {\n\t\tconst filtered = await provider.search('', { use: firstUse });\n\t\tif (filtered.some((e) => !e.uses.includes(firstUse))) top(`search(\"\", { use: \"${firstUse}\" }) returned effects without that use`);\n\t}\n\tconst unknown = await rejectsWith('unknown_effect', () => provider.describe('__no_such_effect__'));\n\tif (unknown) top(`describe of an unknown id ${unknown}`);\n\tconst unknownRenderer = await rejectsWith('unknown_effect', () => provider.createRenderer('__no_such_effect__', { width: 4, height: 4 }));\n\tif (unknownRenderer) top(`createRenderer of an unknown id ${unknownRenderer}`);\n\n\tconst size = options.size ?? 8;\n\tfor (const id of options.ids ?? [...ids]) {\n\t\tlet d: EffectDescription;\n\t\ttry {\n\t\t\td = await provider.describe(id);\n\t\t} catch (e) {\n\t\t\tissues.push({ effectId: id, message: `describe failed: ${codeOf(e)}` });\n\t\t\tcontinue;\n\t\t}\n\t\tcheckDescription(id, d, issues);\n\t\tif (options.render !== false && d.kind !== 'motion') await checkRender(provider, d, size, issues);\n\t\tif ((d.kind === 'vector' || d.kind === 'motion') && caps.supportsVector && provider.applyVectorEffect) {\n\t\t\ttry {\n\t\t\t\tconst m = await provider.applyVectorEffect(id, '<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 10 10\"><rect id=\"r\" width=\"10\" height=\"10\"/></svg>');\n\t\t\t\tif (typeof m.svg !== 'string' || !m.svg.includes('<svg')) issues.push({ effectId: id, message: 'applyVectorEffect returned no SVG' });\n\t\t\t\tif (!(m.duration >= 0)) issues.push({ effectId: id, message: 'applyVectorEffect returned no duration' });\n\t\t\t} catch (e) {\n\t\t\t\t// The probe target is a bare <rect>; an effect that needs more (a path to follow, a fill colour) may refuse it.\n\t\t\t\tif (codeOf(e) !== 'unsupported') issues.push({ effectId: id, message: `applyVectorEffect failed: ${codeOf(e)}` });\n\t\t\t}\n\t\t\tconst bad = await rejectsWith('invalid_values', () => provider.applyVectorEffect!(id, '<svg xmlns=\"http://www.w3.org/2000/svg\"/>', { __not_a_control__: 1 }));\n\t\t\tif (bad) issues.push({ effectId: id, message: `applyVectorEffect with an unknown control ${bad}` });\n\t\t}\n\t}\n\treturn issues;\n}\n","/**\n * `createFakeEffectProvider`: a small, deterministic, CPU-only provider implementing the whole\n * contract. Tests and the demo use it; it is also a reference for real providers.\n *\n * Effects (ids prefixed `fake.`):\n * - `invert` (filter), `tint` (filter)\n * - `gradient` (generator, loops)\n * - `bar` (title / overlay: a lower-third bar that slides in, transparent)\n * - `crossfade` (transition)\n * - `fade-in` (motion, vector only)\n */\n\nimport { EffectDisposedError, EffectUnsupportedError, UnknownEffectError } from './errors.js';\nimport { createEffectPixels, encodeEffectFloat, isEffectPixels, resolveEffectValues, searchEffectSummaries, srgbToLinear } from './helpers.js';\nimport type {\n\tEffectDescription,\n\tEffectImageSource,\n\tEffectPixels,\n\tEffectProvider,\n\tEffectProviderCapabilities,\n\tEffectRenderer,\n\tEffectRendererOptions,\n\tEffectRenderRequest,\n\tEffectSummary,\n\tEffectValues,\n\tEffectVectorMotion,\n\tEffectVectorTarget\n} from './types.js';\n\nconst HEX = '^#[0-9a-fA-F]{6}$';\nconst colour = (description: string) => ({ type: 'string' as const, pattern: HEX, description });\nconst amount = (description: string) => ({ type: 'number' as const, minimum: 0, maximum: 1, description });\n\nconst DESCRIPTIONS: readonly EffectDescription[] = [\n\t{\n\t\tid: 'fake.invert',\n\t\tname: 'Invert',\n\t\tkind: 'shader',\n\t\tcategory: 'image',\n\t\tuses: ['filter'],\n\t\tdescription: 'Inverts the colours of the source.',\n\t\ttags: ['negative', 'colour'],\n\t\ttransparent: false,\n\t\tloop: false,\n\t\tcontrols: {\n\t\t\ttype: 'object',\n\t\t\tadditionalProperties: false,\n\t\t\tproperties: { amount: amount('How far to invert, 0 (unchanged) to 1 (fully inverted). Default 1.') }\n\t\t},\n\t\tdefaults: { amount: 1 },\n\t\tpresets: [{ name: 'Half', values: { amount: 0.5 } }],\n\t\tinputs: [{ name: 'source', kind: 'image', description: 'The picture to invert.', required: true }]\n\t},\n\t{\n\t\tid: 'fake.tint',\n\t\tname: 'Tint',\n\t\tkind: 'shader',\n\t\tcategory: 'image',\n\t\tuses: ['filter'],\n\t\tdescription: 'Mixes the source towards a colour.',\n\t\ttags: ['colour', 'wash'],\n\t\ttransparent: false,\n\t\tloop: false,\n\t\tcontrols: {\n\t\t\ttype: 'object',\n\t\t\tadditionalProperties: false,\n\t\t\tproperties: {\n\t\t\t\tcolor: colour('Tint colour as #rrggbb. Default #ff8800.'),\n\t\t\t\tamount: amount('How far to mix towards the colour, 0–1. Default 0.5.')\n\t\t\t}\n\t\t},\n\t\tdefaults: { color: '#ff8800', amount: 0.5 },\n\t\tpresets: [\n\t\t\t{ name: 'Sepia', values: { color: '#704214', amount: 0.4 } },\n\t\t\t{ name: 'Cool', values: { color: '#2060ff', amount: 0.25 } }\n\t\t],\n\t\tinputs: [{ name: 'source', kind: 'image', description: 'The picture to tint.', required: true }]\n\t},\n\t{\n\t\tid: 'fake.gradient',\n\t\tname: 'Gradient',\n\t\tkind: 'shader',\n\t\tcategory: 'gradient',\n\t\tuses: ['generator'],\n\t\tdescription: 'A linear gradient between two colours that can turn over time.',\n\t\ttags: ['background'],\n\t\ttransparent: false,\n\t\tloop: true,\n\t\tduration: 4000,\n\t\tcontrols: {\n\t\t\ttype: 'object',\n\t\t\tadditionalProperties: false,\n\t\t\tproperties: {\n\t\t\t\tfrom: colour('Start colour as #rrggbb. Default #1e3a8a.'),\n\t\t\t\tto: colour('End colour as #rrggbb. Default #f472b6.'),\n\t\t\t\tangle: { type: 'number', minimum: 0, maximum: 360, description: 'Direction in degrees, 0 = left to right, 90 = top to bottom. Default 90.' },\n\t\t\t\tspin: { type: 'number', minimum: -360, maximum: 360, description: 'Turn per loop (4 s) in degrees. Default 0.' }\n\t\t\t}\n\t\t},\n\t\tdefaults: { from: '#1e3a8a', to: '#f472b6', angle: 90, spin: 0 },\n\t\tpresets: [{ name: 'Sunset', values: { from: '#f97316', to: '#7c3aed' } }],\n\t\tinputs: []\n\t},\n\t{\n\t\tid: 'fake.bar',\n\t\tname: 'Lower-third bar',\n\t\tkind: 'shader',\n\t\tcategory: 'broadcast',\n\t\tuses: ['title', 'overlay'],\n\t\tdescription: 'A coloured bar that slides in from the left in the lower third. Transparent elsewhere.',\n\t\ttags: ['lower third', 'title'],\n\t\ttransparent: true,\n\t\tloop: false,\n\t\tduration: 2000,\n\t\tcontrols: {\n\t\t\ttype: 'object',\n\t\t\tadditionalProperties: false,\n\t\t\tproperties: {\n\t\t\t\tcolor: colour('Bar colour as #rrggbb. Default #0ea5e9.'),\n\t\t\t\theight: { type: 'number', minimum: 0.02, maximum: 0.5, description: 'Bar height as a fraction of the picture height. Default 0.12.' },\n\t\t\t\tslide: { type: 'number', minimum: 0, maximum: 5000, description: 'Slide-in time (ms). Default 500.' }\n\t\t\t}\n\t\t},\n\t\tdefaults: { color: '#0ea5e9', height: 0.12, slide: 500 },\n\t\tpresets: [],\n\t\tinputs: []\n\t},\n\t{\n\t\tid: 'fake.crossfade',\n\t\tname: 'Crossfade',\n\t\tkind: 'shader',\n\t\tcategory: 'transition',\n\t\tuses: ['transition'],\n\t\tdescription: 'Dissolves from one picture to the next.',\n\t\ttags: ['dissolve', 'mix'],\n\t\ttransparent: false,\n\t\tloop: false,\n\t\tduration: 1000,\n\t\tcontrols: {\n\t\t\ttype: 'object',\n\t\t\tadditionalProperties: false,\n\t\t\tproperties: { curve: { type: 'string', enum: ['linear', 'smooth'], description: 'Mix curve: linear, or smooth (ease in and out). Default smooth.' } }\n\t\t},\n\t\tdefaults: { curve: 'smooth' },\n\t\tpresets: [],\n\t\tinputs: [\n\t\t\t{ name: 'from', kind: 'image', description: 'The outgoing picture.', required: true },\n\t\t\t{ name: 'to', kind: 'image', description: 'The incoming picture.', required: true }\n\t\t]\n\t},\n\t{\n\t\tid: 'fake.fade-in',\n\t\tname: 'Fade in',\n\t\tkind: 'motion',\n\t\tcategory: 'morph',\n\t\tuses: ['motion'],\n\t\tdescription: 'Fades vector elements in from transparent, one after another.',\n\t\ttags: ['appear', 'entrance'],\n\t\ttransparent: true,\n\t\tloop: false,\n\t\tduration: 600,\n\t\tcontrols: {\n\t\t\ttype: 'object',\n\t\t\tadditionalProperties: false,\n\t\t\tproperties: {\n\t\t\t\tms: { type: 'number', minimum: 0, maximum: 10000, description: 'Fade time per element (ms). Default 600.' },\n\t\t\t\tstagger: { type: 'number', minimum: 0, maximum: 5000, description: 'Delay between elements (ms). Default 0.' }\n\t\t\t}\n\t\t},\n\t\tdefaults: { ms: 600, stagger: 0 },\n\t\tpresets: [{ name: 'Cascade', values: { ms: 400, stagger: 120 } }],\n\t\tinputs: []\n\t}\n];\n\nconst summaryOf = ({ controls: _c, defaults: _d, presets: _p, inputs: _i, ...summary }: EffectDescription): EffectSummary => summary;\n\nconst hexToRgb = (hex: string): [number, number, number] => [1, 3, 5].map((i) => parseInt(hex.slice(i, i + 2), 16)) as [number, number, number];\nconst smooth = (t: number) => t * t * (3 - 2 * t);\nconst clamp01 = (v: number) => (v < 0 ? 0 : v > 1 ? 1 : v);\n\nfunction input(request: EffectRenderRequest, name: string, id: string, width: number, height: number): EffectPixels {\n\tconst src: EffectImageSource | undefined = request.inputs?.[name];\n\tif (!src) throw new EffectUnsupportedError(`Effect \"${id}\" needs an input named \"${name}\".`, id);\n\tif (!isEffectPixels(src)) throw new EffectUnsupportedError(`The fake provider only takes EffectPixels inputs (\"${name}\").`, id);\n\tif (src.width !== width || src.height !== height) {\n\t\tthrow new EffectUnsupportedError(`Input \"${name}\" is ${src.width}×${src.height}; the renderer is ${width}×${height}.`, id);\n\t}\n\treturn src;\n}\n\n/** Per-pixel colour work in 8-bit sRGB; float output (when asked) is derived from it. */\nfunction renderPixels(d: EffectDescription, v: Record<string, EffectValues[string]>, request: EffectRenderRequest, width: number, height: number): EffectPixels {\n\tconst out = createEffectPixels(width, height);\n\tconst o = out.data;\n\tswitch (d.id) {\n\t\tcase 'fake.invert': {\n\t\t\tconst s = input(request, 'source', d.id, width, height).data;\n\t\t\tconst k = v.amount as number;\n\t\t\tfor (let i = 0; i < o.length; i += 4) {\n\t\t\t\tfor (let c = 0; c < 3; c++) o[i + c] = s[i + c] + (255 - 2 * s[i + c]) * k;\n\t\t\t\to[i + 3] = s[i + 3];\n\t\t\t}\n\t\t\tbreak;\n\t\t}\n\t\tcase 'fake.tint': {\n\t\t\tconst s = input(request, 'source', d.id, width, height).data;\n\t\t\tconst rgb = hexToRgb(v.color as string);\n\t\t\tconst k = v.amount as number;\n\t\t\tfor (let i = 0; i < o.length; i += 4) {\n\t\t\t\tfor (let c = 0; c < 3; c++) o[i + c] = s[i + c] + (rgb[c] - s[i + c]) * k;\n\t\t\t\to[i + 3] = s[i + 3];\n\t\t\t}\n\t\t\tbreak;\n\t\t}\n\t\tcase 'fake.gradient': {\n\t\t\tconst a = hexToRgb(v.from as string);\n\t\t\tconst b = hexToRgb(v.to as string);\n\t\t\tconst turn = ((request.time % (d.duration ?? 4000)) / (d.duration ?? 4000)) * (v.spin as number);\n\t\t\tconst rad = (((v.angle as number) + turn) * Math.PI) / 180;\n\t\t\tconst dx = Math.cos(rad);\n\t\t\tconst dy = Math.sin(rad);\n\t\t\tconst half = (Math.abs(dx) * width + Math.abs(dy) * height) / 2 || 1;\n\t\t\tfor (let y = 0, i = 0; y < height; y++) {\n\t\t\t\tfor (let x = 0; x < width; x++, i += 4) {\n\t\t\t\t\tconst t = clamp01(((x + 0.5 - width / 2) * dx + (y + 0.5 - height / 2) * dy) / (2 * half) + 0.5);\n\t\t\t\t\tfor (let c = 0; c < 3; c++) o[i + c] = a[c] + (b[c] - a[c]) * t;\n\t\t\t\t\to[i + 3] = 255;\n\t\t\t\t}\n\t\t\t}\n\t\t\tbreak;\n\t\t}\n\t\tcase 'fake.bar': {\n\t\t\tconst rgb = hexToRgb(v.color as string);\n\t\t\tconst slide = v.slide as number;\n\t\t\tconst shown = slide > 0 ? smooth(clamp01(request.time / slide)) : 1;\n\t\t\tconst top = Math.round(height * (0.75 - (v.height as number) / 2));\n\t\t\tconst bottom = Math.round(height * (0.75 + (v.height as number) / 2));\n\t\t\tconst right = Math.round(width * 0.7 * shown);\n\t\t\tfor (let y = Math.max(0, top); y < Math.min(height, bottom); y++) {\n\t\t\t\tfor (let x = 0; x < right; x++) {\n\t\t\t\t\tconst i = (y * width + x) * 4;\n\t\t\t\t\to[i] = rgb[0];\n\t\t\t\t\to[i + 1] = rgb[1];\n\t\t\t\t\to[i + 2] = rgb[2];\n\t\t\t\t\to[i + 3] = 255;\n\t\t\t\t}\n\t\t\t}\n\t\t\tbreak;\n\t\t}\n\t\tcase 'fake.crossfade': {\n\t\t\tconst from = input(request, 'from', d.id, width, height).data;\n\t\t\tconst to = input(request, 'to', d.id, width, height).data;\n\t\t\tconst p = clamp01(request.progress ?? request.time / (d.duration ?? 1000));\n\t\t\tconst k = v.curve === 'smooth' ? smooth(p) : p;\n\t\t\tfor (let i = 0; i < o.length; i++) o[i] = from[i] + (to[i] - from[i]) * k;\n\t\t\tbreak;\n\t\t}\n\t\tdefault:\n\t\t\tthrow new EffectUnsupportedError(`\"${d.id}\" is a ${d.kind} effect; use applyVectorEffect.`, d.id);\n\t}\n\treturn out;\n}\n\nfunction toFloat(p: EffectPixels): EffectPixels {\n\tconst f = new Float32Array(p.data.length);\n\tfor (let i = 0; i < f.length; i += 4) {\n\t\tf[i] = srgbToLinear(p.data[i] / 255);\n\t\tf[i + 1] = srgbToLinear(p.data[i + 1] / 255);\n\t\tf[i + 2] = srgbToLinear(p.data[i + 2] / 255);\n\t\tf[i + 3] = p.data[i + 3] / 255;\n\t}\n\treturn encodeEffectFloat({ ...p, float: f });\n}\n\nfunction maskResult(out: EffectPixels, mask: EffectImageSource, source: EffectPixels | undefined, id: string): void {\n\tif (!isEffectPixels(mask) || mask.width !== out.width || mask.height !== out.height) {\n\t\tthrow new EffectUnsupportedError('The mask must be EffectPixels the size of the renderer.', id);\n\t}\n\tconst o = out.data;\n\tfor (let i = 0; i < o.length; i += 4) {\n\t\tconst k = mask.data[i + 3] / 255;\n\t\tif (source) for (let c = 0; c < 4; c++) o[i + c] = source.data[i + c] + (o[i + c] - source.data[i + c]) * k;\n\t\telse o[i + 3] *= k;\n\t}\n}\n\nexport interface FakeEffectProviderOptions {\n\t/** Overrides of the capability flags, to test how editors degrade. */\n\tcapabilities?: Partial<EffectProviderCapabilities>;\n\t/** Called on every render (tests count frames with it). */\n\tonRender?: (effectId: string, request: EffectRenderRequest) => void;\n}\n\n/** A deterministic CPU effects provider with six effects (see the module comment). */\nexport function createFakeEffectProvider(options: FakeEffectProviderOptions = {}): EffectProvider {\n\tconst capabilities: EffectProviderCapabilities = {\n\t\tsupportsWorker: false,\n\t\tsupportsFloat: true,\n\t\tsupportsMask: true,\n\t\tsupportsHostImages: false,\n\t\tsupportsVector: true,\n\t\tmaxSize: 8192,\n\t\t...options.capabilities\n\t};\n\tconst byId = new Map(DESCRIPTIONS.map((d) => [d.id, d]));\n\tconst get = (id: string) => {\n\t\tconst d = byId.get(id);\n\t\tif (!d) throw new UnknownEffectError(id, 'the fake provider');\n\t\treturn d;\n\t};\n\tconst summaries = DESCRIPTIONS.map(summaryOf);\n\n\tconst provider: EffectProvider = {\n\t\tid: 'fake',\n\t\tname: 'Fake effects',\n\t\tversion: '1',\n\t\tcapabilities,\n\t\tlist: (o) => searchEffectSummaries(summaries, '', o),\n\t\tsearch: (q, o) => searchEffectSummaries(summaries, q, o),\n\t\tdescribe: (id) => structuredClone(get(id)),\n\t\tcreateRenderer(id: string, ro: EffectRendererOptions): EffectRenderer {\n\t\t\tconst d = get(id);\n\t\t\tif (d.kind === 'motion') throw new EffectUnsupportedError(`\"${id}\" is a motion effect; use applyVectorEffect.`, id);\n\t\t\tconst { width, height } = ro;\n\t\t\tconst depth = ro.depth ?? 8;\n\t\t\tif (!(width > 0 && height > 0) || width > capabilities.maxSize! || height > capabilities.maxSize!) {\n\t\t\t\tthrow new EffectUnsupportedError(`Renderer size ${width}×${height} is outside 1–${capabilities.maxSize}.`, id);\n\t\t\t}\n\t\t\tlet disposed = false;\n\t\t\treturn {\n\t\t\t\teffectId: id,\n\t\t\t\twidth,\n\t\t\t\theight,\n\t\t\t\tdepth,\n\t\t\t\tasync render(request) {\n\t\t\t\t\tif (disposed) throw new EffectDisposedError(id);\n\t\t\t\t\tif (!Number.isFinite(request.time) || request.time < 0) {\n\t\t\t\t\t\tthrow new EffectUnsupportedError(`time must be a finite number of ms ≥ 0, got ${request.time}.`, id);\n\t\t\t\t\t}\n\t\t\t\t\tconst values = resolveEffectValues(d, request.values);\n\t\t\t\t\toptions.onRender?.(id, request);\n\t\t\t\t\tconst out = renderPixels(d, values, request, width, height);\n\t\t\t\t\tif (request.mask) {\n\t\t\t\t\t\tif (!capabilities.supportsMask) throw new EffectUnsupportedError('This provider does not take masks.', id);\n\t\t\t\t\t\tconst source = d.uses.includes('filter') ? (request.inputs?.source as EffectPixels) : undefined;\n\t\t\t\t\t\tmaskResult(out, request.mask, source, id);\n\t\t\t\t\t}\n\t\t\t\t\treturn depth > 8 && capabilities.supportsFloat ? toFloat(out) : out;\n\t\t\t\t},\n\t\t\t\tdispose() {\n\t\t\t\t\tdisposed = true;\n\t\t\t\t}\n\t\t\t};\n\t\t},\n\t\tapplyVectorEffect(id: string, target: EffectVectorTarget, values?: EffectValues): EffectVectorMotion {\n\t\t\tconst d = get(id);\n\t\t\tif (d.kind !== 'motion' && d.kind !== 'vector') throw new EffectUnsupportedError(`\"${id}\" is a ${d.kind} effect, not a vector one.`, id);\n\t\t\tconst v = resolveEffectValues(d, values);\n\t\t\tconst svg = typeof target === 'string' ? target : target.svg;\n\t\t\tconst ids = typeof target === 'string' || !target.nodeIds ? [...svg.matchAll(/\\sid=\"([^\"]+)\"/g)].map((m) => m[1]) : [...target.nodeIds];\n\t\t\tconst ms = v.ms as number;\n\t\t\tconst stagger = v.stagger as number;\n\t\t\treturn {\n\t\t\t\tsvg,\n\t\t\t\tanimate: ids.map((elementId, i) => ({ id: elementId, delay: i * stagger, ms, attrs: { opacity: [0, 1] as const } })),\n\t\t\t\tduration: ms + Math.max(0, ids.length - 1) * stagger,\n\t\t\t\tloop: false\n\t\t\t};\n\t\t}\n\t};\n\treturn provider;\n}\n","/**\n * Framework-free helpers for effects UIs (the React and Svelte effects browser and parameter\n * panel): control schemas as parameter fields, preview thumbnails from a provider's renderer,\n * and labels.\n */\n\nimport type { JsonSchema } from '../tools/schema.js';\nimport type { ParameterField, ParameterValue } from '../parameters/types.js';\nimport { createEffectPixels } from './helpers.js';\nimport type { EffectDescription, EffectPixels, EffectProvider, EffectSummary, EffectUse, EffectValue } from './types.js';\n\n/** Names for the uses, for filters and badges. */\nexport const EFFECT_USE_LABELS: Readonly<Record<EffectUse, string>> = {\n\tfilter: 'Filter',\n\ttransition: 'Transition',\n\tgenerator: 'Generator',\n\toverlay: 'Overlay',\n\ttitle: 'Title',\n\tmotion: 'Motion',\n\tinteractive: 'Interactive'\n};\n\nconst HEX = /^#[0-9a-f]{6}([0-9a-f]{2})?$/i;\nconst typeOf = (s: JsonSchema) => (Array.isArray(s.type) ? s.type.find((t) => t !== 'null') : s.type);\n\n/**\n * One control as a parameter field: numbers and integers (sliders when bounded), switches,\n * choices (`enum`), colours (strings whose default is `#rrggbb`), vectors (2–4 numbers) and text.\n * `null` for a control no field can edit (objects, long lists).\n */\nexport function effectControlField(name: string, schema: JsonSchema, fallback: EffectValue | undefined): ParameterField | null {\n\tconst base = { id: name, ...(schema.title ? { label: schema.title } : {}), ...(schema.description ? { description: schema.description } : {}) };\n\tconst def = (schema.default ?? fallback) as EffectValue | undefined;\n\tconst type = typeOf(schema);\n\tif (Array.isArray(schema.enum) && schema.enum.length) {\n\t\tconst options = schema.enum.filter((v): v is string | number => typeof v === 'string' || typeof v === 'number');\n\t\treturn { ...base, type: 'choice', options, default: (typeof def === 'string' || typeof def === 'number' ? def : options[0]) as string | number, control: options.length <= 4 ? 'segmented' : 'select' };\n\t}\n\tif (type === 'number' || type === 'integer') {\n\t\tconst min = schema.minimum ?? schema.exclusiveMinimum;\n\t\tconst max = schema.maximum ?? schema.exclusiveMaximum;\n\t\treturn { ...base, type: type === 'integer' ? 'int' : 'number', default: typeof def === 'number' ? def : (min ?? 0), ...(min !== undefined ? { min } : {}), ...(max !== undefined ? { max } : {}), ...(schema.multipleOf ? { step: schema.multipleOf } : {}) };\n\t}\n\tif (type === 'boolean') return { ...base, type: 'boolean', default: def === true };\n\tif (type === 'string') {\n\t\tif (typeof def === 'string' && HEX.test(def)) return { ...base, type: 'color', alpha: def.length === 9, default: def };\n\t\treturn { ...base, type: 'text', default: typeof def === 'string' ? def : '', ...(schema.maxLength ? { maxLength: schema.maxLength } : {}) };\n\t}\n\tif (type === 'array' && Array.isArray(def) && def.length >= 2 && def.length <= 4 && def.every((n) => typeof n === 'number')) {\n\t\tconst items = schema.items ?? {};\n\t\treturn { ...base, type: 'vector', size: def.length as 2 | 3 | 4, default: [...def], ...(items.minimum !== undefined ? { min: items.minimum } : {}), ...(items.maximum !== undefined ? { max: items.maximum } : {}) };\n\t}\n\treturn null;\n}\n\n/** An effect's controls as parameter fields, in schema order (controls no field can edit are left out). */\nexport function effectParameterFields(description: Pick<EffectDescription, 'controls' | 'defaults'>): ParameterField[] {\n\treturn Object.entries(description.controls.properties)\n\t\t.map(([name, schema]) => effectControlField(name, schema, description.defaults[name]))\n\t\t.filter((f): f is ParameterField => !!f);\n}\n\n/** A saved value as a field shows it (`ParameterValue`), or the field's default. */\nexport const effectFieldValue = (field: ParameterField, value: unknown): ParameterValue =>\n\tvalue === undefined || value === null || (typeof value === 'object' && !Array.isArray(value)) ? field.default : (value as ParameterValue);\n\n/**\n * A colourful, deterministic picture for previews of filters and transitions (`variant` 0 and 1\n * differ, for a transition's two sides).\n */\nexport function effectSamplePicture(width: number, height: number, variant = 0): EffectPixels {\n\tconst p = createEffectPixels(width, height);\n\tfor (let y = 0, i = 0; y < height; y++) {\n\t\tfor (let x = 0; x < width; x++, i += 4) {\n\t\t\tconst u = x / Math.max(1, width - 1);\n\t\t\tconst v = y / Math.max(1, height - 1);\n\t\t\tconst check = (Math.floor(u * 4) + Math.floor(v * 4)) % 2;\n\t\t\tif (variant === 0) p.data.set([Math.round(40 + 200 * u), Math.round(80 + 120 * v), Math.round(200 - 120 * u) + check * 30, 255], i);\n\t\t\telse p.data.set([Math.round(230 - 60 * v), Math.round(190 - 100 * u), 60 + check * 40, 255], i);\n\t\t}\n\t}\n\treturn p;\n}\n\n/**\n * A small preview of an effect from the provider's own renderer: filters run on a sample picture,\n * transitions go half way between two, generators and overlays draw at `time` (default half\n * their length, or 1 s). Thumbnails render one at a time (each renderer is disposed before the\n * next is made) and are kept per provider. Rejects like the provider does (motion effects have\n * no pixels).\n */\nexport function renderEffectThumbnail(provider: EffectProvider, effect: EffectSummary | EffectDescription, size: { width: number; height: number } = { width: 96, height: 54 }): Promise<EffectPixels> {\n\tlet cache = thumbnails.get(provider);\n\tif (!cache) thumbnails.set(provider, (cache = new Map()));\n\tconst key = `${effect.id}@${size.width}x${size.height}`;\n\tlet out = cache.get(key);\n\tif (!out) {\n\t\t// One at a time: a browser full of previews would otherwise open a graphics context each.\n\t\tout = thumbnailQueue.then(() => renderThumbnail(provider, effect, size));\n\t\tthumbnailQueue = out.catch(() => undefined);\n\t\tout.catch(() => cache!.delete(key));\n\t\tcache.set(key, out);\n\t}\n\treturn out;\n}\n\nconst thumbnails = new WeakMap<EffectProvider, Map<string, Promise<EffectPixels>>>();\nlet thumbnailQueue: Promise<unknown> = Promise.resolve();\n\nasync function renderThumbnail(provider: EffectProvider, effect: EffectSummary | EffectDescription, size: { width: number; height: number }): Promise<EffectPixels> {\n\tconst d = 'inputs' in effect ? effect : await provider.describe(effect.id);\n\tconst renderer = await provider.createRenderer(d.id, size);\n\ttry {\n\t\tconst time = d.duration ? d.duration / 2 : 1000;\n\t\tconst inputs: Record<string, EffectPixels> = {};\n\t\tfor (const input of d.inputs) if (input.kind === 'image') inputs[input.name] = effectSamplePicture(size.width, size.height, input.name === 'to' ? 1 : 0);\n\t\treturn await renderer.render({ time, inputs, ...(d.uses.includes('transition') ? { progress: 0.5 } : {}) });\n\t} finally {\n\t\trenderer.dispose();\n\t}\n}\n\n/** Effects grouped by category, categories in first-seen order. */\nexport function groupEffectsByCategory<T extends EffectSummary>(effects: readonly T[]): { category: string; effects: T[] }[] {\n\tconst groups = new Map<string, T[]>();\n\tfor (const e of effects) {\n\t\tconst g = groups.get(e.category);\n\t\tif (g) g.push(e);\n\t\telse groups.set(e.category, [e]);\n\t}\n\treturn [...groups].map(([category, list]) => ({ category, effects: list }));\n}\n"]}

package/dist/effects/index.d.cts

@@ -0,0 +1,163 @@
+import { E as EffectProvider, b as EffectProviderCapabilities, c as EffectRenderRequest, a as EffectUse, d as EffectValue, e as EffectDescription, f as EffectPixels, g as EffectSummary } from '../helpers-777mC6dc.cjs';
+export { h as EFFECT_KINDS, i as EFFECT_USES, j as EffectControlSchema, k as EffectImageSource, l as EffectInputSpec, m as EffectKind, n as EffectPreset, o as EffectRenderer, p as EffectRendererOptions, q as EffectSearchOptions, r as EffectSvgAnimation, s as EffectValues, t as EffectVectorMotion, u as EffectVectorTarget, v as EffectsSlot, w as applyEffectMask, x as createEffectPixels, y as effectValueErrors, z as encodeEffectFloat, A as isEffectPixels, B as linearToSrgb, C as resolveEffectValues, D as searchEffectSummaries, F as srgbToLinear } from '../helpers-777mC6dc.cjs';
+import { S as SchemaValidationError, J as JsonSchema } from '../schema-Di0CS6Pe.cjs';
+export { A as AppliedEffectInfo, E as EffectChangeResult, a as EffectTargetEffects, b as EffectToolContext, c as EffectToolHost, d as createEffectToolProvider } from '../tools-DHKGHiSK.cjs';
+import { P as ParameterField, a as ParameterValue } from '../types-DMcf_z4J.cjs';
+import '../flair-D7BxyBwL.cjs';
+import '../behavior-Ymbld6jL.cjs';
+import '../easing-lM0Xo9Ni.cjs';
+import '../evaluate-2S3vSPLy.cjs';
+import '../types-CznabG7m.cjs';
+import '../gradient-KDfCvhuj.cjs';
+import '../types-CwMPoRMU.cjs';
+import '../registry-BqA1AZt0.cjs';
+
+type EffectErrorCode = 'unknown_effect' | 'invalid_values' | 'unsupported' | 'disposed' | 'no_provider';
+declare const EFFECT_ERROR_CODES: readonly EffectErrorCode[];
+/**
+ * Base of every effects error. Check `code` (or use `isEffectError`) rather than `instanceof`
+ * across packages, since a provider may be bundled with its own copy of this class.
+ */
+declare class EffectError extends Error {
+    readonly code: EffectErrorCode;
+    readonly effectId?: string;
+    constructor(code: EffectErrorCode, message: string, effectId?: string);
+}
+/** No effect has this id. */
+declare class UnknownEffectError extends EffectError {
+    constructor(effectId: string, providerName?: string);
+}
+/** Control values do not match the effect's control schema (unknown control, wrong type, out of range). */
+declare class EffectControlError extends EffectError {
+    readonly details: readonly SchemaValidationError[];
+    constructor(effectId: string, details: readonly SchemaValidationError[]);
+}
+/** The provider cannot do this (a vector effect asked for pixels, a size above `maxSize`, a missing input...). */
+declare class EffectUnsupportedError extends EffectError {
+    constructor(message: string, effectId?: string);
+}
+/** The renderer was disposed. Create a new one. */
+declare class EffectDisposedError extends EffectError {
+    constructor(effectId: string);
+}
+/** No effects provider is registered with this editor. */
+declare class NoEffectsProviderError extends EffectError {
+    constructor();
+}
+/** True for any effects error, including one thrown by another copy of this module. */
+declare function isEffectError(error: unknown): error is EffectError;
+
+/**
+ * `checkEffectProvider`: a conformance check any provider can run in its own tests, so editors
+ * can rely on the contract (strict control schemas, valid defaults, typed errors, renderers that
+ * return the size they were asked for).
+ */
+
+interface EffectConformanceIssue {
+    effectId?: string;
+    message: string;
+}
+interface EffectConformanceOptions {
+    /** Effects to check in depth (default: every listed effect). */
+    ids?: readonly string[];
+    /** Also create renderers and render one small frame of each pixel effect (default true). */
+    render?: boolean;
+    /** Renderer size for the render check (default 8). */
+    size?: number;
+}
+/** Runs the contract checks against `provider` and returns every issue found (empty when it conforms). */
+declare function checkEffectProvider(provider: EffectProvider, options?: EffectConformanceOptions): Promise<EffectConformanceIssue[]>;
+
+/**
+ * `createFakeEffectProvider`: a small, deterministic, CPU-only provider implementing the whole
+ * contract. Tests and the demo use it; it is also a reference for real providers.
+ *
+ * Effects (ids prefixed `fake.`):
+ * - `invert` (filter), `tint` (filter)
+ * - `gradient` (generator, loops)
+ * - `bar` (title / overlay: a lower-third bar that slides in, transparent)
+ * - `crossfade` (transition)
+ * - `fade-in` (motion, vector only)
+ */
+
+interface FakeEffectProviderOptions {
+    /** Overrides of the capability flags, to test how editors degrade. */
+    capabilities?: Partial<EffectProviderCapabilities>;
+    /** Called on every render (tests count frames with it). */
+    onRender?: (effectId: string, request: EffectRenderRequest) => void;
+}
+/** A deterministic CPU effects provider with six effects (see the module comment). */
+declare function createFakeEffectProvider(options?: FakeEffectProviderOptions): EffectProvider;
+
+/**
+ * Framework-free helpers for effects UIs (the React and Svelte effects browser and parameter
+ * panel): control schemas as parameter fields, preview thumbnails from a provider's renderer,
+ * and labels.
+ */
+
+/** Names for the uses, for filters and badges. */
+declare const EFFECT_USE_LABELS: Readonly<Record<EffectUse, string>>;
+/**
+ * One control as a parameter field: numbers and integers (sliders when bounded), switches,
+ * choices (`enum`), colours (strings whose default is `#rrggbb`), vectors (2–4 numbers) and text.
+ * `null` for a control no field can edit (objects, long lists).
+ */
+declare function effectControlField(name: string, schema: JsonSchema, fallback: EffectValue | undefined): ParameterField | null;
+/** An effect's controls as parameter fields, in schema order (controls no field can edit are left out). */
+declare function effectParameterFields(description: Pick<EffectDescription, 'controls' | 'defaults'>): ParameterField[];
+/** A saved value as a field shows it (`ParameterValue`), or the field's default. */
+declare const effectFieldValue: (field: ParameterField, value: unknown) => ParameterValue;
+/**
+ * A colourful, deterministic picture for previews of filters and transitions (`variant` 0 and 1
+ * differ, for a transition's two sides).
+ */
+declare function effectSamplePicture(width: number, height: number, variant?: number): EffectPixels;
+/**
+ * A small preview of an effect from the provider's own renderer: filters run on a sample picture,
+ * transitions go half way between two, generators and overlays draw at `time` (default half
+ * their length, or 1 s). Thumbnails render one at a time (each renderer is disposed before the
+ * next is made) and are kept per provider. Rejects like the provider does (motion effects have
+ * no pixels).
+ */
+declare function renderEffectThumbnail(provider: EffectProvider, effect: EffectSummary | EffectDescription, size?: {
+    width: number;
+    height: number;
+}): Promise<EffectPixels>;
+/** Effects grouped by category, categories in first-seen order. */
+declare function groupEffectsByCategory<T extends EffectSummary>(effects: readonly T[]): {
+    category: string;
+    effects: T[];
+}[];
+
+/**
+ * `EffectRendererPool`: keeps a few live renderers, reused per effect, size and depth.
+ *
+ * GPU providers hold one graphics context per renderer, and browsers allow only about sixteen
+ * WebGL contexts at a time (the oldest is lost after that). So the pool keeps at most
+ * `maxRenderers` renderers. It disposes the least recently used one once its renders finish, and it
+ * runs one render at a time per renderer, as the contract requires.
+ */
+
+interface EffectRendererPoolOptions {
+    /** Most live renderers (default 4). */
+    maxRenderers?: number;
+}
+declare class EffectRendererPool {
+    private readonly entries;
+    private readonly maxRenderers;
+    constructor(options?: EffectRendererPoolOptions);
+    /** Live renderers now. */
+    get size(): number;
+    /** Renders `request` with the provider's renderer for this effect, size and depth (made on first use). */
+    render(provider: EffectProvider, id: string, size: {
+        width: number;
+        height: number;
+        depth?: 8 | 16 | 32;
+    }, request: EffectRenderRequest): Promise<EffectPixels>;
+    /** Disposes the least recently used renderers over the limit, after their queued renders. */
+    private evict;
+    /** Disposes every renderer (after its queued renders). */
+    clear(): void;
+}
+
+export { EFFECT_ERROR_CODES, EFFECT_USE_LABELS, type EffectConformanceIssue, type EffectConformanceOptions, EffectControlError, EffectDescription, EffectDisposedError, EffectError, type EffectErrorCode, EffectPixels, EffectProvider, EffectProviderCapabilities, EffectRenderRequest, EffectRendererPool, type EffectRendererPoolOptions, EffectSummary, EffectUnsupportedError, EffectUse, EffectValue, type FakeEffectProviderOptions, NoEffectsProviderError, UnknownEffectError, checkEffectProvider, createFakeEffectProvider, effectControlField, effectFieldValue, effectParameterFields, effectSamplePicture, groupEffectsByCategory, isEffectError, renderEffectThumbnail };

package/dist/effects/index.d.ts

@@ -0,0 +1,163 @@
+import { E as EffectProvider, b as EffectProviderCapabilities, c as EffectRenderRequest, a as EffectUse, d as EffectValue, e as EffectDescription, f as EffectPixels, g as EffectSummary } from '../helpers-DX2_7L5t.js';
+export { h as EFFECT_KINDS, i as EFFECT_USES, j as EffectControlSchema, k as EffectImageSource, l as EffectInputSpec, m as EffectKind, n as EffectPreset, o as EffectRenderer, p as EffectRendererOptions, q as EffectSearchOptions, r as EffectSvgAnimation, s as EffectValues, t as EffectVectorMotion, u as EffectVectorTarget, v as EffectsSlot, w as applyEffectMask, x as createEffectPixels, y as effectValueErrors, z as encodeEffectFloat, A as isEffectPixels, B as linearToSrgb, C as resolveEffectValues, D as searchEffectSummaries, F as srgbToLinear } from '../helpers-DX2_7L5t.js';
+import { S as SchemaValidationError, J as JsonSchema } from '../schema-Di0CS6Pe.js';
+export { A as AppliedEffectInfo, E as EffectChangeResult, a as EffectTargetEffects, b as EffectToolContext, c as EffectToolHost, d as createEffectToolProvider } from '../tools-C7JtLYzo.js';
+import { P as ParameterField, a as ParameterValue } from '../types-D3-J3TFf.js';
+import '../flair-CxB3fOcU.js';
+import '../behavior-Ymbld6jL.js';
+import '../easing-lM0Xo9Ni.js';
+import '../evaluate-CfmT6xA3.js';
+import '../types-BcX7sCsn.js';
+import '../gradient-KDfCvhuj.js';
+import '../types-CwMPoRMU.js';
+import '../registry-D-4fit9C.js';
+
+type EffectErrorCode = 'unknown_effect' | 'invalid_values' | 'unsupported' | 'disposed' | 'no_provider';
+declare const EFFECT_ERROR_CODES: readonly EffectErrorCode[];
+/**
+ * Base of every effects error. Check `code` (or use `isEffectError`) rather than `instanceof`
+ * across packages, since a provider may be bundled with its own copy of this class.
+ */
+declare class EffectError extends Error {
+    readonly code: EffectErrorCode;
+    readonly effectId?: string;
+    constructor(code: EffectErrorCode, message: string, effectId?: string);
+}
+/** No effect has this id. */
+declare class UnknownEffectError extends EffectError {
+    constructor(effectId: string, providerName?: string);
+}
+/** Control values do not match the effect's control schema (unknown control, wrong type, out of range). */
+declare class EffectControlError extends EffectError {
+    readonly details: readonly SchemaValidationError[];
+    constructor(effectId: string, details: readonly SchemaValidationError[]);
+}
+/** The provider cannot do this (a vector effect asked for pixels, a size above `maxSize`, a missing input...). */
+declare class EffectUnsupportedError extends EffectError {
+    constructor(message: string, effectId?: string);
+}
+/** The renderer was disposed. Create a new one. */
+declare class EffectDisposedError extends EffectError {
+    constructor(effectId: string);
+}
+/** No effects provider is registered with this editor. */
+declare class NoEffectsProviderError extends EffectError {
+    constructor();
+}
+/** True for any effects error, including one thrown by another copy of this module. */
+declare function isEffectError(error: unknown): error is EffectError;
+
+/**
+ * `checkEffectProvider`: a conformance check any provider can run in its own tests, so editors
+ * can rely on the contract (strict control schemas, valid defaults, typed errors, renderers that
+ * return the size they were asked for).
+ */
+
+interface EffectConformanceIssue {
+    effectId?: string;
+    message: string;
+}
+interface EffectConformanceOptions {
+    /** Effects to check in depth (default: every listed effect). */
+    ids?: readonly string[];
+    /** Also create renderers and render one small frame of each pixel effect (default true). */
+    render?: boolean;
+    /** Renderer size for the render check (default 8). */
+    size?: number;
+}
+/** Runs the contract checks against `provider` and returns every issue found (empty when it conforms). */
+declare function checkEffectProvider(provider: EffectProvider, options?: EffectConformanceOptions): Promise<EffectConformanceIssue[]>;
+
+/**
+ * `createFakeEffectProvider`: a small, deterministic, CPU-only provider implementing the whole
+ * contract. Tests and the demo use it; it is also a reference for real providers.
+ *
+ * Effects (ids prefixed `fake.`):
+ * - `invert` (filter), `tint` (filter)
+ * - `gradient` (generator, loops)
+ * - `bar` (title / overlay: a lower-third bar that slides in, transparent)
+ * - `crossfade` (transition)
+ * - `fade-in` (motion, vector only)
+ */
+
+interface FakeEffectProviderOptions {
+    /** Overrides of the capability flags, to test how editors degrade. */
+    capabilities?: Partial<EffectProviderCapabilities>;
+    /** Called on every render (tests count frames with it). */
+    onRender?: (effectId: string, request: EffectRenderRequest) => void;
+}
+/** A deterministic CPU effects provider with six effects (see the module comment). */
+declare function createFakeEffectProvider(options?: FakeEffectProviderOptions): EffectProvider;
+
+/**
+ * Framework-free helpers for effects UIs (the React and Svelte effects browser and parameter
+ * panel): control schemas as parameter fields, preview thumbnails from a provider's renderer,
+ * and labels.
+ */
+
+/** Names for the uses, for filters and badges. */
+declare const EFFECT_USE_LABELS: Readonly<Record<EffectUse, string>>;
+/**
+ * One control as a parameter field: numbers and integers (sliders when bounded), switches,
+ * choices (`enum`), colours (strings whose default is `#rrggbb`), vectors (2–4 numbers) and text.
+ * `null` for a control no field can edit (objects, long lists).
+ */
+declare function effectControlField(name: string, schema: JsonSchema, fallback: EffectValue | undefined): ParameterField | null;
+/** An effect's controls as parameter fields, in schema order (controls no field can edit are left out). */
+declare function effectParameterFields(description: Pick<EffectDescription, 'controls' | 'defaults'>): ParameterField[];
+/** A saved value as a field shows it (`ParameterValue`), or the field's default. */
+declare const effectFieldValue: (field: ParameterField, value: unknown) => ParameterValue;
+/**
+ * A colourful, deterministic picture for previews of filters and transitions (`variant` 0 and 1
+ * differ, for a transition's two sides).
+ */
+declare function effectSamplePicture(width: number, height: number, variant?: number): EffectPixels;
+/**
+ * A small preview of an effect from the provider's own renderer: filters run on a sample picture,
+ * transitions go half way between two, generators and overlays draw at `time` (default half
+ * their length, or 1 s). Thumbnails render one at a time (each renderer is disposed before the
+ * next is made) and are kept per provider. Rejects like the provider does (motion effects have
+ * no pixels).
+ */
+declare function renderEffectThumbnail(provider: EffectProvider, effect: EffectSummary | EffectDescription, size?: {
+    width: number;
+    height: number;
+}): Promise<EffectPixels>;
+/** Effects grouped by category, categories in first-seen order. */
+declare function groupEffectsByCategory<T extends EffectSummary>(effects: readonly T[]): {
+    category: string;
+    effects: T[];
+}[];
+
+/**
+ * `EffectRendererPool`: keeps a few live renderers, reused per effect, size and depth.
+ *
+ * GPU providers hold one graphics context per renderer, and browsers allow only about sixteen
+ * WebGL contexts at a time (the oldest is lost after that). So the pool keeps at most
+ * `maxRenderers` renderers. It disposes the least recently used one once its renders finish, and it
+ * runs one render at a time per renderer, as the contract requires.
+ */
+
+interface EffectRendererPoolOptions {
+    /** Most live renderers (default 4). */
+    maxRenderers?: number;
+}
+declare class EffectRendererPool {
+    private readonly entries;
+    private readonly maxRenderers;
+    constructor(options?: EffectRendererPoolOptions);
+    /** Live renderers now. */
+    get size(): number;
+    /** Renders `request` with the provider's renderer for this effect, size and depth (made on first use). */
+    render(provider: EffectProvider, id: string, size: {
+        width: number;
+        height: number;
+        depth?: 8 | 16 | 32;
+    }, request: EffectRenderRequest): Promise<EffectPixels>;
+    /** Disposes the least recently used renderers over the limit, after their queued renders. */
+    private evict;
+    /** Disposes every renderer (after its queued renders). */
+    clear(): void;
+}
+
+export { EFFECT_ERROR_CODES, EFFECT_USE_LABELS, type EffectConformanceIssue, type EffectConformanceOptions, EffectControlError, EffectDescription, EffectDisposedError, EffectError, type EffectErrorCode, EffectPixels, EffectProvider, EffectProviderCapabilities, EffectRenderRequest, EffectRendererPool, type EffectRendererPoolOptions, EffectSummary, EffectUnsupportedError, EffectUse, EffectValue, type FakeEffectProviderOptions, NoEffectsProviderError, UnknownEffectError, checkEffectProvider, createFakeEffectProvider, effectControlField, effectFieldValue, effectParameterFields, effectSamplePicture, groupEffectsByCategory, isEffectError, renderEffectThumbnail };