@sealpixel/plugin-filter 1.0.0-rc.0

package/README.md

@@ -0,0 +1,3 @@
+# @sealpixel/plugin-filter
+
+Colour filter presets (grayscale, sepia, vintage, cool, warm) and custom colour matrices. Part of the Sealpixel image editor.

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import type { OperationBase } from '@sealpixel/core';
+import { type FilterOptions } from './options.js';
+import { type ColorMatrix } from './presets.js';
+export { FILTER_DEFAULT_OPTIONS, type FilterOptions, FilterOptionsSchema, type FilterPresetOption, presetLabelKey, presetMatrix, presetName, } from './options.js';
+export { type ColorMatrix, ColorMatrixSchema, FILTER_PRESETS } from './presets.js';
+export interface FilterDoc {
+    /** Preset name, `'custom'` when `matrix` was given directly, or null. */
+    preset: string | null;
+    matrix: ColorMatrix | null;
+    /** 0..1 blend between identity and the matrix. */
+    strength: number;
+}
+export interface FilterSetOp extends OperationBase<'filter.set'> {
+    /** A preset name from `FILTER_PRESETS`, or `'custom'` with `matrix`, or null to clear. */
+    preset: string | null;
+    matrix?: ColorMatrix | undefined;
+    strength?: number | undefined;
+}
+declare module '@sealpixel/core' {
+    interface OperationRegistry {
+        'filter.set': FilterSetOp;
+    }
+    interface DocumentRegistry {
+        filter: FilterDoc;
+    }
+}
+export declare const filterSet: import("@sealpixel/core").OperationDef<FilterDoc, FilterSetOp>;
+export declare const filterPlugin: import("@sealpixel/plugin-sdk").ConfigurablePlugin<"filter", FilterDoc, FilterOptions>;
+/** The matrix behind a configured preset, for tools that build ops. */
+export declare function matrixForPreset(options: FilterOptions, name: string): ColorMatrix | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAGL,KAAK,aAAa,EAInB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,WAAW,EAAqC,MAAM,cAAc,CAAC;AAEnF,OAAO,EACL,sBAAsB,EACtB,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,cAAc,EACd,YAAY,EACZ,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnF,MAAM,WAAW,SAAS;IACxB,yEAAyE;IACzE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAY,SAAQ,aAAa,CAAC,YAAY,CAAC;IAC9D,0FAA0F;IAC1F,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,OAAO,QAAQ,iBAAiB,CAAC;IAC/B,UAAU,iBAAiB;QACzB,YAAY,EAAE,WAAW,CAAC;KAC3B;IACD,UAAU,gBAAgB;QACxB,MAAM,EAAE,SAAS,CAAC;KACnB;CACF;AAED,eAAO,MAAM,SAAS,gEA6BpB,CAAC;AAKH,eAAO,MAAM,YAAY,wFA6CvB,CAAC;AAEH,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAGxF"}

package/dist/index.js

@@ -0,0 +1,82 @@
+import { defineOperation, definePlugin } from '@sealpixel/plugin-sdk';
+import { z } from 'zod';
+import { FILTER_DEFAULT_OPTIONS, FILTER_OPTIONS_DESCRIBE, FilterOptionsSchema, presetMatrix, presetName, } from './options.js';
+import { ColorMatrixSchema, FILTER_PRESETS } from './presets.js';
+export { FILTER_DEFAULT_OPTIONS, FilterOptionsSchema, presetLabelKey, presetMatrix, presetName, } from './options.js';
+export { ColorMatrixSchema, FILTER_PRESETS } from './presets.js';
+export const filterSet = defineOperation({
+    type: 'filter.set',
+    schema: z
+        .object({
+        type: z.literal('filter.set'),
+        id: z.string().min(1),
+        at: z.number().optional(),
+        preset: z.string().nullable(),
+        matrix: ColorMatrixSchema.optional(),
+        strength: z.number().min(0).max(1).optional(),
+    })
+        .strict()
+        .refine((op) => (op.preset === null || op.preset === 'custom' ? true : op.preset in FILTER_PRESETS), 'unknown preset')
+        .refine((op) => op.preset !== 'custom' || op.matrix !== undefined, 'custom preset needs a matrix'),
+    reduce: (slice, op) => {
+        if (op.preset === null)
+            return { preset: null, matrix: null, strength: op.strength ?? slice.strength };
+        const matrix = op.preset === 'custom'
+            ? op.matrix
+            : FILTER_PRESETS[op.preset];
+        return { preset: op.preset, matrix, strength: op.strength ?? slice.strength };
+    },
+});
+const sameMatrix = (a, b) => a.every((row, i) => row.every((v, j) => Math.abs(v - b[i][j]) < 1e-9));
+export const filterPlugin = definePlugin({
+    id: 'filter',
+    version: 1,
+    operations: [filterSet],
+    initialDocument: { preset: null, matrix: null, strength: 1 },
+    stage: { name: 'color', order: 110 },
+    toPlan: (doc) => doc.matrix === null || doc.strength === 0
+        ? null
+        : { matrix: doc.matrix, strength: doc.strength },
+    kernel: { kind: 'core' },
+    options: {
+        schema: FilterOptionsSchema,
+        defaults: FILTER_DEFAULT_OPTIONS,
+        describe: FILTER_OPTIONS_DESCRIBE,
+    },
+    initialOps: ({ options }) => {
+        if (options.defaultPreset === null)
+            return [];
+        const preset = options.presets.find((p) => presetName(p) === options.defaultPreset);
+        if (!preset)
+            return [];
+        const op = typeof preset === 'string'
+            ? { type: 'filter.set', preset, strength: options.defaultStrength }
+            : {
+                type: 'filter.set',
+                preset: 'custom',
+                matrix: preset.matrix,
+                strength: options.defaultStrength,
+            };
+        return [op];
+    },
+    validate: (op, { options }) => {
+        if (op.type !== 'filter.set' || !options.enforce)
+            return null;
+        const o = op;
+        if (o.preset === null)
+            return null;
+        if (o.preset === 'custom') {
+            const ok = options.presets.some((p) => typeof p !== 'string' && o.matrix !== undefined && sameMatrix(p.matrix, o.matrix));
+            return ok ? null : 'custom matrix is not one of the configured presets';
+        }
+        return options.presets.some((p) => presetName(p) === o.preset)
+            ? null
+            : `preset "${o.preset}" is not offered by this editor`;
+    },
+});
+/** The matrix behind a configured preset, for tools that build ops. */
+export function matrixForPreset(options, name) {
+    const p = options.presets.find((x) => presetName(x) === name);
+    return p ? presetMatrix(p) : null;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/options.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { type ColorMatrix } from './presets.js';
+/** A preset the tool offers. Built-in names refer to `FILTER_PRESETS`; custom ones carry their matrix. */
+export type FilterPresetOption = string | {
+    name: string;
+    label?: string | undefined;
+    matrix: ColorMatrix;
+};
+export interface FilterOptions {
+    /**
+     * Presets in display order. Built-in names or `{ name, label, matrix }` for
+     * a custom matrix. A custom preset is written to the edit log as
+     * `preset: 'custom'` with its matrix, so the server needs no options to
+     * render it.
+     */
+    presets: FilterPresetOption[];
+    /** Applied when the editor loads a source without a filter op. `null` = none. */
+    defaultPreset: string | null;
+    /** Initial blend strength for a newly chosen preset, 0..1. */
+    defaultStrength: number;
+    /** Show a blend strength slider (off by default; defaultStrength applies). */
+    strength: boolean;
+    /** Bounds of the strength slider. */
+    strengthRange: {
+        min: number;
+        max: number;
+        step: number;
+    };
+    /** Render a live thumbnail per preset instead of a text button. */
+    thumbnails: boolean;
+    /** Reject edit logs that pick a preset outside `presets` (client and server). Off, options only shape the UI. */
+    enforce: boolean;
+}
+export declare const FilterOptionsSchema: z.ZodObject<{
+    presets: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        matrix: z.ZodTuple<[z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>], null>;
+    }, z.core.$strict>]>>;
+    defaultPreset: z.ZodNullable<z.ZodString>;
+    defaultStrength: z.ZodNumber;
+    strength: z.ZodBoolean;
+    strengthRange: z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+        step: z.ZodNumber;
+    }, z.core.$strict>;
+    thumbnails: z.ZodBoolean;
+    enforce: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const FILTER_DEFAULT_OPTIONS: FilterOptions;
+export declare const FILTER_OPTIONS_DESCRIBE: Record<keyof FilterOptions, string>;
+export declare function presetName(p: FilterPresetOption): string;
+/** The matrix a preset option resolves to. */
+export declare function presetMatrix(p: FilterPresetOption): ColorMatrix;
+export declare function presetLabelKey(p: FilterPresetOption): {
+    key: string;
+    literal?: string;
+};
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,WAAW,EAAqC,MAAM,cAAc,CAAC;AAEnF,0GAA0G;AAC1G,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,iFAAiF;IACjF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,iHAAiH;IACjH,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;kBAsC7B,CAAC;AAEJ,eAAO,MAAM,sBAAsB,EAAE,aAQpC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,aAAa,EAAE,MAAM,CAWvE,CAAC;AAEF,wBAAgB,UAAU,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAExD;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAE/D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,kBAAkB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAGvF"}

package/dist/options.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { ColorMatrixSchema, FILTER_PRESETS } from './presets.js';
+const builtin = Object.keys(FILTER_PRESETS);
+export const FilterOptionsSchema = z
+    .object({
+    presets: z
+        .array(z.union([
+        z.string().refine((n) => builtin.includes(n), {
+            message: `built-in preset must be one of ${builtin.join(', ')}`,
+        }),
+        z
+            .object({
+            name: z
+                .string()
+                .min(1)
+                .refine((n) => n !== 'custom' && !builtin.includes(n), 'custom preset name clashes with a built-in'),
+            label: z.string().min(1).optional(),
+            matrix: ColorMatrixSchema,
+        })
+            .strict(),
+    ]))
+        .min(1),
+    defaultPreset: z.string().nullable(),
+    defaultStrength: z.number().min(0).max(1),
+    strength: z.boolean(),
+    strengthRange: z
+        .object({ min: z.number().min(0), max: z.number().max(1), step: z.number().positive() })
+        .strict()
+        .refine((r) => r.min < r.max, 'min must be below max'),
+    thumbnails: z.boolean(),
+    enforce: z.boolean(),
+})
+    .strict()
+    .refine((o) => o.defaultPreset === null || o.presets.some((p) => presetName(p) === o.defaultPreset), 'defaultPreset must be one of presets');
+export const FILTER_DEFAULT_OPTIONS = {
+    presets: ['grayscale', 'sepia', 'vintage', 'cool', 'warm', 'invert'],
+    defaultPreset: null,
+    defaultStrength: 1,
+    strength: false,
+    strengthRange: { min: 0, max: 1, step: 0.01 },
+    thumbnails: true,
+    enforce: false,
+};
+export const FILTER_OPTIONS_DESCRIBE = {
+    presets: 'Presets in display order: built-in names or custom { name, label, matrix }.',
+    defaultPreset: 'Preset applied to a freshly loaded image, or null.',
+    defaultStrength: 'Blend strength a newly chosen preset starts with (0..1).',
+    strength: 'Show a blend strength slider. Off by default: the strength comes from defaultStrength.',
+    strengthRange: 'Bounds and step of the strength slider when shown; with enforce, the accepted range.',
+    thumbnails: 'Render a live thumbnail per preset instead of a text button. On by default.',
+    enforce: 'Reject logs whose preset is not in `presets`; custom presets must match a configured matrix.',
+};
+export function presetName(p) {
+    return typeof p === 'string' ? p : p.name;
+}
+/** The matrix a preset option resolves to. */
+export function presetMatrix(p) {
+    return typeof p === 'string' ? FILTER_PRESETS[p] : p.matrix;
+}
+export function presetLabelKey(p) {
+    if (typeof p === 'string')
+        return { key: `filter.${p}` };
+    return { key: `filter.${p.name}`, literal: p.label ?? p.name };
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AA6BnF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAE5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC,CAAC,KAAK,CAAC;QACN,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;YAC5C,OAAO,EAAE,kCAAkC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAChE,CAAC;QACF,CAAC;aACE,MAAM,CAAC;YACN,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAC7C,4CAA4C,CAC7C;YACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACnC,MAAM,EAAE,iBAAiB;SAC1B,CAAC;aACD,MAAM,EAAE;KACZ,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;IACT,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,aAAa,EAAE,CAAC;SACb,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;SACvF,MAAM,EAAE;SACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,EAAE,uBAAuB,CAAC;IACxD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC;KACD,MAAM,EAAE;KACR,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,EAC3F,sCAAsC,CACvC,CAAC;AAEJ,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,OAAO,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;IACpE,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,CAAC;IAClB,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;IAC7C,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,KAAK;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAwC;IAC1E,OAAO,EAAE,6EAA6E;IACtF,aAAa,EAAE,oDAAoD;IACnE,eAAe,EAAE,0DAA0D;IAC3E,QAAQ,EACN,wFAAwF;IAC1F,aAAa,EACX,sFAAsF;IACxF,UAAU,EAAE,6EAA6E;IACzF,OAAO,EACL,8FAA8F;CACjG,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,CAAqB;IAC9C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,CAAqB;IAChD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,cAAc,CAAC,CAAC,CAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAqB;IAClD,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC;IACzD,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjE,CAAC"}

package/dist/presets.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+/** 4x5 colour matrix: rows r, g, b, a; columns r, g, b, a, offset. */
+export type ColorMatrix = [
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ]
+];
+/** Built-in presets. Values are part of the wire contract: never edit, add new names. */
+export declare const FILTER_PRESETS: Readonly<Record<string, ColorMatrix>>;
+export declare const ColorMatrixSchema: z.ZodTuple<[z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>], null>;
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG;IACxB;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;IACxC;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;IACxC;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;IACxC;QAAC,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;QAAE,MAAM;KAAC;CACzC,CAAC;AAIF,yFAAyF;AACzF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAiBhE,CAAC;AAGF,eAAO,MAAM,iBAAiB,wWAAgC,CAAC"}

package/dist/presets.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+const A = [0, 0, 0, 1, 0];
+/** Built-in presets. Values are part of the wire contract: never edit, add new names. */
+export const FILTER_PRESETS = {
+    grayscale: [
+        [0.2126, 0.7152, 0.0722, 0, 0],
+        [0.2126, 0.7152, 0.0722, 0, 0],
+        [0.2126, 0.7152, 0.0722, 0, 0],
+        A,
+    ],
+    sepia: [[0.393, 0.769, 0.189, 0, 0], [0.349, 0.686, 0.168, 0, 0], [0.272, 0.534, 0.131, 0, 0], A],
+    vintage: [
+        [0.62, 0.32, 0.06, 0, 0.03],
+        [0.22, 0.65, 0.13, 0, 0.02],
+        [0.16, 0.24, 0.5, 0, 0.05],
+        A,
+    ],
+    cool: [[0.9, 0, 0, 0, 0], [0, 1, 0, 0, 0], [0, 0, 1.1, 0, 0.02], A],
+    warm: [[1.1, 0, 0, 0, 0.02], [0, 1, 0, 0, 0], [0, 0, 0.9, 0, 0], A],
+    invert: [[-1, 0, 0, 0, 1], [0, -1, 0, 0, 1], [0, 0, -1, 0, 1], A],
+};
+const row = z.tuple([z.number(), z.number(), z.number(), z.number(), z.number()]);
+export const ColorMatrixSchema = z.tuple([row, row, row, row]);
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,MAAM,CAAC,GAA6C,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEpE,yFAAyF;AACzF,MAAM,CAAC,MAAM,cAAc,GAA0C;IACnE,SAAS,EAAE;QACT,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;KACF;IACD,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACjG,OAAO,EAAE;QACP,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC;QAC3B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC;QAC3B,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC;QAC1B,CAAC;KACF;IACD,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACnE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAClF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@sealpixel/plugin-filter",
+  "version": "1.0.0-rc.0",
+  "description": "Colour filter presets (grayscale, sepia, vintage, cool, warm) and custom colour matrices.",
+  "license": "BUSL-1.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/9feet/sealpixel.git",
+    "directory": "packages/plugins/filter"
+  },
+  "homepage": "https://docs.sealpixel.dev",
+  "bugs": "https://github.com/9feet/sealpixel/issues",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "sealpixel-plugin"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@sealpixel/plugin-sdk": "workspace:*"
+  },
+  "peerDependencies": {
+    "@sealpixel/core": "workspace:*",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@sealpixel/config": "workspace:*",
+    "@sealpixel/core": "workspace:*",
+    "@sealpixel/plugin-finetune": "workspace:*",
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^4.0.0",
+    "zod": "^4.0.0"
+  }
+}