@pixerate/editor 0.267.0 → 0.268.0

package/dist/{chunk-DT4YQUGT.cjs → chunk-YXP6X3SY.cjs}

@@ -16,12 +16,20 @@ var _chunkPFHJS4HEcjs = require('./chunk-PFHJS4HE.cjs');
 
 
 
-var _chunkXVOP3CGQcjs = require('./chunk-XVOP3CGQ.cjs');
+
+
+
+
+
+
+
+
+var _chunkEU2ZZA6Lcjs = require('./chunk-EU2ZZA6L.cjs');
 
 // src/brushes/patch.ts
 var isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var copy = (v) => JSON.parse(JSON.stringify(v));
-var FACETS = _chunkXVOP3CGQcjs.BRUSH_JSON_SCHEMA.properties;
+var FACETS = _chunkEU2ZZA6Lcjs.BRUSH_JSON_SCHEMA.properties;
 var BRUSH_PATCH_PROPERTIES = (() => {
   const { id: _id, name: _name, ...rest } = FACETS;
   const { required: _r, ...tip } = rest.tip;
@@ -53,17 +61,17 @@ function changedBrushPaths(a, b, path = "") {
 // src/brushes/tools.ts
 var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
 var WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
-var FACETS2 = _chunkXVOP3CGQcjs.BRUSH_JSON_SCHEMA.properties;
+var FACETS2 = _chunkEU2ZZA6Lcjs.BRUSH_JSON_SCHEMA.properties;
 var ID = { type: "string", pattern: String(FACETS2.id.pattern), description: "Brush id from list_brush_presets (lowercase letters, digits and dashes)." };
 var FACET_PROPS = BRUSH_PATCH_PROPERTIES;
-var HOSTS = Object.keys(_chunkXVOP3CGQcjs.BRUSH_HOST_PROFILES);
+var HOSTS = Object.keys(_chunkEU2ZZA6Lcjs.BRUSH_HOST_PROFILES);
 var copy2 = (v) => JSON.parse(JSON.stringify(v));
 var merge = mergeBrushPatch;
 var changedPaths = changedBrushPaths;
 function summary(entry, profile, withCheck) {
   const b = entry.brush;
-  const engine = _chunkXVOP3CGQcjs.resolveEngine.call(void 0, b);
-  const check = withCheck ? _chunkXVOP3CGQcjs.checkBrush.call(void 0, b, profile) : null;
+  const engine = _chunkEU2ZZA6Lcjs.resolveEngine.call(void 0, b);
+  const check = withCheck ? _chunkEU2ZZA6Lcjs.checkBrush.call(void 0, b, profile) : null;
   return {
     id: b.id,
     name: b.name,
@@ -72,7 +80,7 @@ function summary(entry, profile, withCheck) {
     ...b.medium ? { medium: b.medium } : {},
     ...b.variety ? { variety: b.variety } : {},
     ...b.tool ? { tool: b.tool } : {},
-    category: _chunkXVOP3CGQcjs.resolveCategory.call(void 0, b, engine),
+    category: _chunkEU2ZZA6Lcjs.resolveCategory.call(void 0, b, engine),
     engine,
     tip: b.tip.shape,
     ...b.tip.size !== void 0 ? { size: b.tip.size } : {},
@@ -86,26 +94,33 @@ function summary(entry, profile, withCheck) {
 var refusal = (check, host) => `${host.name} can't use this brush: ${check.issues.filter((i) => i.severity === "error").map((i) => `${i.facet}: ${i.reason} ${i.fix}`).join(" ")} (check_brush lists every issue; nothing was saved.)`;
 var warnings = (check) => check.issues.filter((i) => i.severity === "warning");
 function createBrushLibraryTools(library, options = {}) {
-  const profile = _nullishCoalesce(options.profile, () => ( _chunkXVOP3CGQcjs.PAINT_PROFILE));
+  const profile = _nullishCoalesce(options.profile, () => ( _chunkEU2ZZA6Lcjs.PAINT_PROFILE));
   const hostOf = (id) => {
     if (id === void 0) return profile;
-    const p = _chunkXVOP3CGQcjs.BRUSH_HOST_PROFILES[id];
-    if (!p) throw new (0, _chunkXVOP3CGQcjs.BrushLibraryError)("invalid", `No host "${id}"; use one of: ${HOSTS.join(", ")}.`);
+    const p = _chunkEU2ZZA6Lcjs.BRUSH_HOST_PROFILES[id];
+    if (!p) throw new (0, _chunkEU2ZZA6Lcjs.BrushLibraryError)("invalid", `No host "${id}"; use one of: ${HOSTS.join(", ")}.`);
     return p;
   };
   const entry = async (id) => {
     const found = await library.get(id);
     if (found) return found;
     const ids = (await library.list()).map((e) => e.brush.id);
-    throw new (0, _chunkXVOP3CGQcjs.BrushLibraryError)("unknown_brush", `No brush "${id}". ${_chunkXVOP3CGQcjs.closest.call(void 0, id, ids)}list_brush_presets lists them.`);
+    throw new (0, _chunkEU2ZZA6Lcjs.BrushLibraryError)("unknown_brush", `No brush "${id}". ${_chunkEU2ZZA6Lcjs.closest.call(void 0, id, ids)}list_brush_presets lists them.`);
   };
   const checkFor = async (brush, p) => {
-    const check2 = _chunkXVOP3CGQcjs.checkBrush.call(void 0, brush, p);
-    const provider = _optionalChain([options, 'access', _9 => _9.stickers, 'optionalCall', _10 => _10()]);
-    if (!provider || brush.tip.shape !== "stamp") return check2;
+    const check2 = _chunkEU2ZZA6Lcjs.checkBrush.call(void 0, brush, p);
     const issues = [...check2.issues];
+    const refs = [...(_nullishCoalesce(brush.tip.stamps, () => ( []))).map((r) => ["tip.stamps", r]), ...brush.tip.grain ? [["tip.grain.source", brush.tip.grain.source]] : []];
+    for (const [facet, ref] of refs) {
+      const id = _chunkEU2ZZA6Lcjs.brushSourceIdOf.call(void 0, ref);
+      if (id === null || await library.getSource(id)) continue;
+      const ids = (await library.listSources()).map((x) => x.id);
+      issues.push({ facet, severity: "error", reason: `There is no image source "${id}" in the brush library. ${_chunkEU2ZZA6Lcjs.closest.call(void 0, id, ids)}`.trim(), fix: "Add it with add_brush_source, or use a ref list_brush_sources lists." });
+    }
+    const provider = _optionalChain([options, 'access', _9 => _9.stickers, 'optionalCall', _10 => _10()]);
+    if (!provider || brush.tip.shape !== "stamp") return { ok: !issues.some((i) => i.severity === "error"), issues };
     for (const ref of _nullishCoalesce(brush.tip.stamps, () => ( []))) {
-      if (ref.startsWith("editor:")) continue;
+      if (ref.startsWith("editor:") || _chunkEU2ZZA6Lcjs.isBrushSourceRef.call(void 0, ref)) continue;
       try {
         await _chunkPFHJS4HEcjs.describeStickerRef.call(void 0, provider, ref);
       } catch (e) {
@@ -118,12 +133,12 @@ function createBrushLibraryTools(library, options = {}) {
     const problems = [];
     let brush;
     try {
-      brush = _chunkXVOP3CGQcjs.normalizeBrushSpec.call(void 0, raw, problems);
+      brush = _chunkEU2ZZA6Lcjs.normalizeBrushSpec.call(void 0, raw, problems);
     } catch (e) {
-      throw new (0, _chunkXVOP3CGQcjs.BrushLibraryError)("invalid", e.message);
+      throw new (0, _chunkEU2ZZA6Lcjs.BrushLibraryError)("invalid", e.message);
     }
-    const check2 = _chunkXVOP3CGQcjs.withKeptIssues.call(void 0, await checkFor(brush, profile), original ? await checkFor(original, profile) : null);
-    if (!check2.ok) throw new (0, _chunkXVOP3CGQcjs.BrushLibraryError)("invalid", refusal(check2, profile));
+    const check2 = _chunkEU2ZZA6Lcjs.withKeptIssues.call(void 0, await checkFor(brush, profile), original ? await checkFor(original, profile) : null);
+    if (!check2.ok) throw new (0, _chunkEU2ZZA6Lcjs.BrushLibraryError)("invalid", refusal(check2, profile));
     const saved = await library.save(brush, { overwrite });
     return { ...saved, problems, check: check2 };
   };
@@ -134,10 +149,10 @@ function createBrushLibraryTools(library, options = {}) {
     inputSchema: {
       type: "object",
       properties: {
-        kind: { type: "string", enum: [..._chunkXVOP3CGQcjs.BRUSH_KINDS], description: "mark (lays a material) or tool (works on paint already down)." },
-        medium: { type: "string", enum: [..._chunkXVOP3CGQcjs.BRUSH_MEDIA], description: "Marks laying this medium." },
+        kind: { type: "string", enum: [..._chunkEU2ZZA6Lcjs.BRUSH_KINDS], description: "mark (lays a material) or tool (works on paint already down)." },
+        medium: { type: "string", enum: [..._chunkEU2ZZA6Lcjs.BRUSH_MEDIA], description: "Marks laying this medium." },
         variety: { type: "string", maxLength: 40, description: "This variety (oil, watercolor, pencil, highlighter\u2026)." },
-        tool: { type: "string", enum: [..._chunkXVOP3CGQcjs.BRUSH_TOOLS], description: "Tools that do this." },
+        tool: { type: "string", enum: [..._chunkEU2ZZA6Lcjs.BRUSH_TOOLS], description: "Tools that do this." },
         tag: { type: "string", maxLength: 40, description: "Brushes with this tag." },
         text: { type: "string", maxLength: 200, description: "Words in the id, name, description, variety or tags (each word must match the start of one)." },
         source: { type: "string", enum: ["all", "builtin", "user"], description: "all (default), builtin presets only, or user (saved) brushes only." },
@@ -164,8 +179,8 @@ function createBrushLibraryTools(library, options = {}) {
     annotations: { title: "Describe a brush", ...READ },
     handler: async ({ id }) => {
       const e = await entry(id);
-      const engine = _chunkXVOP3CGQcjs.resolveEngine.call(void 0, e.brush);
-      return { brush: e.brush, builtin: e.builtin, engine, category: _chunkXVOP3CGQcjs.resolveCategory.call(void 0, e.brush, engine), check: await checkFor(e.brush, profile) };
+      const engine = _chunkEU2ZZA6Lcjs.resolveEngine.call(void 0, e.brush);
+      return { brush: e.brush, builtin: e.builtin, engine, category: _chunkEU2ZZA6Lcjs.resolveCategory.call(void 0, e.brush, engine), check: await checkFor(e.brush, profile) };
     }
   };
   const check = {
@@ -183,20 +198,20 @@ function createBrushLibraryTools(library, options = {}) {
     },
     annotations: { title: "Check a brush for a host", ...READ },
     handler: async ({ id, brush, host }) => {
-      if (id === void 0 === (brush === void 0)) throw new (0, _chunkXVOP3CGQcjs.BrushLibraryError)("invalid", "Give either id (a library brush) or brush (a spec), not both or neither.");
+      if (id === void 0 === (brush === void 0)) throw new (0, _chunkEU2ZZA6Lcjs.BrushLibraryError)("invalid", "Give either id (a library brush) or brush (a spec), not both or neither.");
       const p = hostOf(host);
       let b;
       const problems = [];
       if (id !== void 0) b = (await entry(id)).brush;
       else {
         try {
-          b = _chunkXVOP3CGQcjs.normalizeBrushSpec.call(void 0, brush, problems);
+          b = _chunkEU2ZZA6Lcjs.normalizeBrushSpec.call(void 0, brush, problems);
         } catch (e) {
-          throw new (0, _chunkXVOP3CGQcjs.BrushLibraryError)("invalid", e.message);
+          throw new (0, _chunkEU2ZZA6Lcjs.BrushLibraryError)("invalid", e.message);
         }
       }
       const result = await checkFor(b, p);
-      return { host: p.id, ...result, ...problems.length ? { problems } : {}, ...!result.ok ? { degraded: _chunkXVOP3CGQcjs.degrade.call(void 0, b, p) } : {} };
+      return { host: p.id, ...result, ...problems.length ? { problems } : {}, ...!result.ok ? { degraded: _chunkEU2ZZA6Lcjs.degrade.call(void 0, b, p) } : {} };
     }
   };
   const exportTool = {
@@ -207,7 +222,34 @@ function createBrushLibraryTools(library, options = {}) {
     annotations: { title: "Export brushes", ...READ },
     handler: async ({ ids }) => ({ file: await library.exportFile(ids) })
   };
-  const tools = [list, describe, check, exportTool];
+  const listSources = {
+    name: "list_brush_sources",
+    title: "List brush image sources",
+    description: "Lists the image sources in the brush library: the images image tips and image grain are made from. Returns each source's id, ref (source:<id>, for tip.stamps of a stamp tip or tip.grain.source in create_brush / update_brush), name, width and height in px, licence and origin when it has them, and usedBy (the saved brushes that name it), plus total. Built-in grain patterns need no source. Changes nothing.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        text: { type: "string", maxLength: 200, description: "Words in the id, name or origin (each word must match the start of one)." },
+        offset: { type: "integer", minimum: 0, description: "Skip this many (default 0)." },
+        limit: { type: "integer", minimum: 1, maximum: 200, description: "At most this many (default 100)." }
+      },
+      additionalProperties: false
+    },
+    annotations: { title: "List brush image sources", ...READ },
+    handler: async ({ text, offset, limit }) => {
+      const brushes = (await library.list({ source: "user" })).map((e) => e.brush);
+      const wordsOf = (v) => v.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+      const want = typeof text === "string" ? wordsOf(text) : [];
+      const found = (await library.listSources()).filter((x) => {
+        const have = wordsOf([x.id, x.name, _nullishCoalesce(x.origin, () => ( ""))].join(" "));
+        return want.every((w) => have.some((h) => h.startsWith(w)));
+      });
+      const start = _nullishCoalesce(offset, () => ( 0));
+      const page = found.slice(start, start + (_nullishCoalesce(limit, () => ( 100))));
+      return { total: found.length, sources: page.map((x) => ({ ..._chunkEU2ZZA6Lcjs.summarizeBrushSource.call(void 0, x), usedBy: brushes.filter((b) => _chunkEU2ZZA6Lcjs.brushSourceIds.call(void 0, b).includes(x.id)).map((b) => b.id) })) };
+    }
+  };
+  const tools = [list, describe, check, exportTool, listSources];
   if (options.renderPreview) {
     const render = options.renderPreview;
     tools.push({
@@ -255,12 +297,12 @@ function createBrushLibraryTools(library, options = {}) {
       },
       annotations: { title: "Save a new brush", ...WRITE },
       handler: async ({ basedOn, ...spec }) => {
-        if (library.isBuiltin(spec.id)) throw new (0, _chunkXVOP3CGQcjs.BrushLibraryError)("builtin", `"${spec.id}" is a built-in brush id; pick another id (or basedOn "${spec.id}" with a new id).`);
-        if (await library.get(spec.id)) throw new (0, _chunkXVOP3CGQcjs.BrushLibraryError)("exists", `A brush "${spec.id}" exists already; pick another id, or change it with update_brush.`);
+        if (library.isBuiltin(spec.id)) throw new (0, _chunkEU2ZZA6Lcjs.BrushLibraryError)("builtin", `"${spec.id}" is a built-in brush id; pick another id (or basedOn "${spec.id}" with a new id).`);
+        if (await library.get(spec.id)) throw new (0, _chunkEU2ZZA6Lcjs.BrushLibraryError)("exists", `A brush "${spec.id}" exists already; pick another id, or change it with update_brush.`);
         const base = basedOn !== void 0 ? (await entry(basedOn)).brush : void 0;
         const raw = base ? merge(base, spec) : spec;
         const saved = await store(raw, false);
-        return { id: saved.brush.id, brush: saved.brush, engine: _chunkXVOP3CGQcjs.resolveEngine.call(void 0, saved.brush), problems: saved.problems, warnings: warnings(saved.check) };
+        return { id: saved.brush.id, brush: saved.brush, engine: _chunkEU2ZZA6Lcjs.resolveEngine.call(void 0, saved.brush), problems: saved.problems, warnings: warnings(saved.check) };
       }
     },
     {
@@ -281,13 +323,38 @@ function createBrushLibraryTools(library, options = {}) {
       annotations: { title: "Update a brush", ...WRITE, idempotentHint: true },
       handler: async ({ id, unset, ...patch }) => {
         const e = await entry(id);
-        if (e.builtin) throw new (0, _chunkXVOP3CGQcjs.BrushLibraryError)("builtin", `"${id}" is a built-in brush and can't be changed; duplicate_brush makes a copy you can change.`);
+        if (e.builtin) throw new (0, _chunkEU2ZZA6Lcjs.BrushLibraryError)("builtin", `"${id}" is a built-in brush and can't be changed; duplicate_brush makes a copy you can change.`);
         const base = copy2(e.brush);
         for (const k of _nullishCoalesce(unset, () => ( []))) delete base[k];
         const saved = await store(merge(base, { ...patch, id }), true, e.brush);
         return { id, brush: saved.brush, changed: changedPaths(e.brush, saved.brush), problems: saved.problems, warnings: warnings(saved.check), ...saved.check.kept.length ? { kept: saved.check.kept } : {} };
       }
     },
+    {
+      name: "add_brush_source",
+      title: "Add a brush image source",
+      description: `Adds an image to the brush library as a source for image tips and image grain (as Procreate's shape and grain sources). The image is a PNG data: URL; the marks are read from its transparency, its dark parts (a scan of marks on paper) or its light parts (white on black), as channel says, and kept as a grey mask at most ${_chunkEU2ZZA6Lcjs.MAX_BRUSH_SOURCE_SIZE} px on a side. Returns id, ref (source:<id>), the stored source's width and height, problems (the channel auto picked, scaling) and replaced. Then make the brush: create_brush or update_brush with tip { shape: "stamp", stamps: [ref] } for an image tip, or tip.grain { source: ref } for grain. A taken id is refused unless overwrite.`,
+      inputSchema: {
+        type: "object",
+        properties: {
+          name: { type: "string", minLength: 1, maxLength: 80, description: 'Display name, e.g. "Charcoal scan".' },
+          image: { type: "string", pattern: "^data:image/png;base64,", maxLength: 4e7, description: `The image: a PNG data: URL, at most ${_chunkEU2ZZA6Lcjs.MAX_BRUSH_SOURCE_INPUT_PIXELS} pixels; larger than ${_chunkEU2ZZA6Lcjs.MAX_BRUSH_SOURCE_SIZE} px it is scaled down.` },
+          id: { type: "string", pattern: String(FACETS2.id.pattern), description: "The source id (default: from the name, made unique): lowercase letters, digits and dashes." },
+          channel: { type: "string", enum: [..._chunkEU2ZZA6Lcjs.BRUSH_SOURCE_CHANNELS], description: "Where the marks are: auto (default: the transparency when the image has any, else the dark parts), alpha, darkness (dark marks on light paper) or lightness (light marks on black)." },
+          invert: { type: "boolean", description: "Swap painted and empty parts (default false)." },
+          licence: { type: "string", maxLength: 2e3, description: "The licence or terms the image came with, kept with the source." },
+          origin: { type: "string", maxLength: 200, description: "Where it came from: a file name, a pack or a URL." },
+          overwrite: { type: "boolean", description: "Replace the image of a source with the same id (default false); brushes using it change with it." }
+        },
+        required: ["name", "image"],
+        additionalProperties: false
+      },
+      annotations: { title: "Add a brush image source", ...WRITE },
+      handler: async ({ overwrite, ...input }) => {
+        const r = await library.addSource(input, { overwrite: !!overwrite });
+        return { id: r.source.id, ref: _chunkEU2ZZA6Lcjs.brushSourceRef.call(void 0, r.source.id), width: r.source.width, height: r.source.height, problems: r.problems, replaced: r.replaced };
+      }
+    },
     {
       name: "duplicate_brush",
       title: "Duplicate a brush",
@@ -340,7 +407,7 @@ function createBrushLibraryTools(library, options = {}) {
   return tools;
 }
 function createBrushLibraryToolProvider(library, options = {}) {
-  const profile = _nullishCoalesce(options.profile, () => ( _chunkXVOP3CGQcjs.PAINT_PROFILE));
+  const profile = _nullishCoalesce(options.profile, () => ( _chunkEU2ZZA6Lcjs.PAINT_PROFILE));
   const tools = createBrushLibraryTools(library, options);
   return {
     id: _nullishCoalesce(options.id, () => ( "brushes")),