@weasel-js/core 1.10.1 → 1.11.1

package/dist/features/paths/pathEditingOverlayLayer.js

@@ -1,135 +1,83 @@
-import { isVisibleFrom as e, previewSourcesFrom as t } from "../../canvas/drawEnvelope.js";
-import { circlePath as n, linePath as r, pathToAnchors as i, rectMarkerPath as a, squarePath as o } from "@weasel-js/geom";
+import { paintsLayer } from "../../core/selection/chromeState.js";
+import { chromeStateFrom, isVisibleFrom, previewSourcesFrom } from "../../canvas/drawEnvelope.js";
+import { DEFAULT_OVERLAY_STYLE, anchorMarkerCommands, worldToScreen } from "./anchorMarkers.js";
+import { pathToAnchors, rectMarkerPath } from "@weasel-js/geom";
+
 //#region src/features/paths/pathEditingOverlayLayer.ts
-var s = {
-	anchorSizePx: 8,
-	handleDotRadiusPx: 5,
-	anchorFill: "#ffffff",
-	anchorStroke: "#3478f6",
-	handleStroke: "#7da7e8",
-	handleDotFill: "rgba(125, 167, 232, 0.5)",
-	anchorFillSelected: "#3478f6",
-	marqueeStroke: "#3478f6",
-	marqueeFill: "rgba(52, 120, 246, 0.08)"
-}, c = /* @__PURE__ */ new Set();
-function l(e, t, n) {
-	return [(e - n.x) * n.scale.x, (t - n.y) * n.scale.y];
-}
-function u(u) {
-	let d = {
-		...s,
-		...u.style ?? {}
+var EMPTY_SELECTION = /* @__PURE__ */ new Set();
+var ALWAYS = () => true;
+/** Render layer that draws the outline and the anchors and control handles
+*  of the path currently being anchor-edited. Draws nothing when no path is
+*  being edited. */
+function createPathEditingOverlayLayer(opts) {
+	const style = {
+		...DEFAULT_OVERLAY_STYLE,
+		...opts.style ?? {}
 	};
 	return {
 		id: "path-editing-overlay",
 		label: "Path editing",
 		space: "screen",
-		draw: (s, f) => {
-			let p = u.getEditingId();
-			if (!p) return [];
-			let m = e(s);
-			if (m && !m("path-edit.anchors")) return [];
-			let h = u.getPose(p, t(s), f);
-			if (!h || h.kind !== "polygon") return [];
-			let { anchors: g } = i(h), _ = u.getSelectedAnchors?.() ?? c, v = [], y = 0;
-			for (let e of g) for (let t of e) {
-				let e = _.has(y);
-				y++;
-				let [i, a] = l(t.x, t.y, f);
-				if (t.inHandle) {
-					let [e, o] = l(t.inHandle.x, t.inHandle.y, f);
-					v.push({
-						kind: "path",
-						path: r({
-							x: i,
-							y: a
-						}, {
-							x: e,
-							y: o
-						}),
-						stroke: {
-							paint: {
-								kind: "solid",
-								color: d.handleStroke
-							},
-							width: 1
-						}
-					}), v.push({
-						kind: "path",
-						path: n(e, o, d.handleDotRadiusPx),
-						fill: { paint: {
-							kind: "solid",
-							color: d.handleDotFill
-						} }
-					});
-				}
-				if (t.outHandle) {
-					let [e, o] = l(t.outHandle.x, t.outHandle.y, f);
-					v.push({
-						kind: "path",
-						path: r({
-							x: i,
-							y: a
-						}, {
-							x: e,
-							y: o
-						}),
-						stroke: {
-							paint: {
-								kind: "solid",
-								color: d.handleStroke
-							},
-							width: 1
-						}
-					}), v.push({
-						kind: "path",
-						path: n(e, o, d.handleDotRadiusPx),
-						fill: { paint: {
-							kind: "solid",
-							color: d.handleDotFill
-						} }
-					});
+		draw: (data, view) => {
+			const id = opts.getEditingId();
+			if (!id) return [];
+			const isVisible = isVisibleFrom(data);
+			if (isVisible && !isVisible("path-edit.anchors")) return [];
+			const node = opts.getNode?.(id);
+			if (!paintsLayer(chromeStateFrom(data), node?.layer)) return [];
+			const previews = previewSourcesFrom(data);
+			const pose = opts.getPose(id, previews, view);
+			if (!pose || pose.kind !== "polygon") return [];
+			const markers = opts.getAnchorMarkers?.(id, previews) ?? null;
+			const selected = opts.getSelectedAnchors?.() ?? EMPTY_SELECTION;
+			const out = [];
+			if (node) {
+				const mark = opts.getSelectedMark?.() ?? null;
+				const anchors = pathToAnchors(pose);
+				const toScreen = (p) => worldToScreen(p, view);
+				for (const ext of opts.getExtensions?.() ?? []) {
+					if (!ext.marks) continue;
+					out.push(...ext.marks({
+						id,
+						node,
+						path: pose,
+						anchors,
+						view,
+						toScreen,
+						isVisible: isVisible ?? ALWAYS,
+						selected: mark?.owner === ext.id ? mark.index : null
+					}));
 				}
-				v.push({
-					kind: "path",
-					path: o(i, a, d.anchorSizePx),
-					fill: { paint: {
-						kind: "solid",
-						color: e ? d.anchorFillSelected : d.anchorFill
-					} },
-					stroke: {
-						paint: {
-							kind: "solid",
-							color: d.anchorStroke
-						},
-						width: 1
-					}
-				});
 			}
-			let b = u.getMarquee?.(f);
-			if (b) {
-				let [e, t] = l(b.x, b.y, f), [n, r] = l(b.x + b.width, b.y + b.height, f);
-				v.push({
+			out.push(...anchorMarkerCommands(pose, view, selected, style, markers));
+			const marquee = opts.getMarquee?.(view);
+			if (marquee) {
+				const m = worldToScreen(marquee, view);
+				const m2 = worldToScreen({
+					x: marquee.x + marquee.width,
+					y: marquee.y + marquee.height
+				}, view);
+				out.push({
 					kind: "path",
-					path: a(e, t, n - e, r - t),
+					path: rectMarkerPath(m.x, m.y, m2.x - m.x, m2.y - m.y),
 					fill: { paint: {
 						kind: "solid",
-						color: d.marqueeFill
+						color: style.marqueeFill
 					} },
 					stroke: {
 						paint: {
 							kind: "solid",
-							color: d.marqueeStroke
+							color: style.marqueeStroke
 						},
 						width: 1
 					}
 				});
 			}
-			return v;
+			return out;
 		}
 	};
 }
-//#endregion
-export { u as createPathEditingOverlayLayer };
 
+//#endregion
+export { createPathEditingOverlayLayer };
 //# sourceMappingURL=pathEditingOverlayLayer.js.map

package/dist/features/paths/pathEditingOverlayLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"pathEditingOverlayLayer.js","names":["DEFAULT_STYLE","EMPTY_SELECTION","w2s","wx","view","wy","createPathEditingOverlayLayer","style","opts","id","isVisible","isVisibleFrom","data","pose","previewSourcesFrom","pathToAnchors","selected","out","flat","sub","anchors","a","isSelected","ax","ay","hx","hy","linePath","circlePath","squarePath","marquee","mx","my","mx2","my2","rectMarkerPath"],"sources":["../../../src/features/paths/pathEditingOverlayLayer.ts"],"sourcesContent":["/**\n * Screen-space render layer for path-editing chrome — anchor squares,\n * tangent lines, and control-point dots for a polygon path that is the\n * current edit target. Marker sizes stay constant regardless of zoom.\n */\n\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { RenderLayer } from 'core/layers/render';\nimport { type Path, type PolygonPath, type View, linePath, pathToAnchors, circlePath, rectMarkerPath, squarePath } from '@weasel-js/geom';\nimport type { GesturePreviewSource } from 'canvas/gestureBounds';\nimport { previewSourcesFrom, isVisibleFrom } from 'canvas/drawEnvelope';\n\n/** Options for `createPathEditingOverlayLayer`. Everything is read per frame,\n *  so the layer follows a changing edit target without being rebuilt. */\nexport interface CreatePathEditingOverlayLayerOptions {\n  /** Returns the id of the polygon currently in anchor-edit mode, or null\n   *  when no node is being edited. */\n  getEditingId(): string | null;\n  /**\n   * Returns the pose for an id, or null if the node has been deleted.\n   * Non-polygon poses are tolerated (the layer no-ops on them).\n   *\n   * `previews` are the drawing view's in-flight preview surfaces, so an\n   * anchor dragged in one panel does not move in the others. Resolve against\n   * them before falling back to the committed pose.\n   *\n   * `view` is the drawing view's camera. Answer in its world: a node whose\n   * layer is a parallax plane stores its path in the plane's.\n   */\n  getPose(id: string, previews: readonly GesturePreviewSource[], view: View): Path | null;\n  /** Flat indices of the selected anchors. Selected anchors render\n   *  filled; unselected ones hollow. */\n  getSelectedAnchors?(): ReadonlySet<number>;\n  /** In-flight anchor-marquee rect in world coords, or null. Drawn as a\n   *  rubber band while `marqueeAnchorsAction` is dragging. */\n  getMarquee?(view: View): { x: number; y: number; width: number; height: number } | null;\n  /** Optional styling overrides. */\n  style?: PathEditingOverlayStyle;\n}\n\n/** Appearance of the anchor and handle markers. */\nexport interface PathEditingOverlayStyle {\n  anchorSizePx?: number;\n  handleDotRadiusPx?: number;\n  anchorFill?: string;\n  anchorStroke?: string;\n  handleStroke?: string;\n  /** Fill of the control-point circle. Defaults to the handleStroke color\n   *  at 50% alpha. */\n  handleDotFill?: string;\n  /** Fill of a selected anchor square. Defaults to the anchor stroke color. */\n  anchorFillSelected?: string;\n  /** Stroke of the marquee rubber band. */\n  marqueeStroke?: string;\n  /** Fill of the marquee rubber band. */\n  marqueeFill?: string;\n}\n\nconst DEFAULT_STYLE: Required<PathEditingOverlayStyle> = {\n  anchorSizePx: 8,\n  handleDotRadiusPx: 5,\n  anchorFill: '#ffffff',\n  anchorStroke: '#3478f6',\n  handleStroke: '#7da7e8',\n  // 50%-opacity handle-stroke color. #7da7e8 → rgba(125, 167, 232, 0.5).\n  handleDotFill: 'rgba(125, 167, 232, 0.5)',\n  anchorFillSelected: '#3478f6',\n  marqueeStroke: '#3478f6',\n  marqueeFill: 'rgba(52, 120, 246, 0.08)',\n};\n\nconst EMPTY_SELECTION: ReadonlySet<number> = new Set();\n\nfunction w2s(wx: number, wy: number, view: View): [number, number] {\n  return [(wx - view.x) * view.scale.x, (wy - view.y) * view.scale.y];\n}\n\n/** Render layer that draws the anchors and control handles of the path\n *  currently being anchor-edited. Draws nothing when no path is being\n *  edited. */\nexport function createPathEditingOverlayLayer(\n  opts: CreatePathEditingOverlayLayerOptions,\n): RenderLayer<unknown> {\n  const style = { ...DEFAULT_STYLE, ...(opts.style ?? {}) };\n\n  return {\n    id: 'path-editing-overlay',\n    label: 'Path editing',\n    space: 'screen',\n    draw: (data, view) => {\n      const id = opts.getEditingId();\n      if (!id) return [];\n      // Chrome-caps gate off the envelope, so paint and the anchor hit-test in\n      // `affordanceAt` consult the same rule — otherwise a consumer that hides\n      // the chrome still gets grabbable invisible anchors, or vice versa.\n      const isVisible = isVisibleFrom(data);\n      if (isVisible && !isVisible('path-edit.anchors')) return [];\n      const pose = opts.getPose(id, previewSourcesFrom(data), view);\n      if (!pose || pose.kind !== 'polygon') return [];\n\n      const { anchors } = pathToAnchors(pose as PolygonPath);\n      const selected = opts.getSelectedAnchors?.() ?? EMPTY_SELECTION;\n      const out: DrawCommand[] = [];\n\n      // Flat anchor index, incremented in walk order so it lines up with\n      // `enumerateAnchors` — the same numbering the affordances and the\n      // anchor selection use. See `anchorEdits` for why they agree.\n      let flat = 0;\n      for (const sub of anchors) {\n        for (const a of sub) {\n          const isSelected = selected.has(flat);\n          flat++;\n          const [ax, ay] = w2s(a.x, a.y, view);\n\n          // Tangent stems + handle dots first so the anchor square paints on top.\n          if (a.inHandle) {\n            const [hx, hy] = w2s(a.inHandle.x, a.inHandle.y, view);\n            out.push({\n              kind: 'path',\n              path: linePath({ x: ax, y: ay }, { x: hx, y: hy }),\n              stroke: { paint: { kind: 'solid', color: style.handleStroke }, width: 1 },\n            });\n            out.push({\n              kind: 'path',\n              path: circlePath(hx, hy, style.handleDotRadiusPx),\n              fill: { paint: { kind: 'solid', color: style.handleDotFill } },\n            });\n          }\n          if (a.outHandle) {\n            const [hx, hy] = w2s(a.outHandle.x, a.outHandle.y, view);\n            out.push({\n              kind: 'path',\n              path: linePath({ x: ax, y: ay }, { x: hx, y: hy }),\n              stroke: { paint: { kind: 'solid', color: style.handleStroke }, width: 1 },\n            });\n            out.push({\n              kind: 'path',\n              path: circlePath(hx, hy, style.handleDotRadiusPx),\n              fill: { paint: { kind: 'solid', color: style.handleDotFill } },\n            });\n          }\n\n          // Anchor square — drawn on top.\n          out.push({\n            kind: 'path',\n            path: squarePath(ax, ay, style.anchorSizePx),\n            fill: { paint: {\n              kind: 'solid',\n              color: isSelected ? style.anchorFillSelected : style.anchorFill,\n            } },\n            stroke: { paint: { kind: 'solid', color: style.anchorStroke }, width: 1 },\n          });\n        }\n      }\n\n      // Marquee rubber band, on top of everything.\n      const marquee = opts.getMarquee?.(view);\n      if (marquee) {\n        const [mx, my] = w2s(marquee.x, marquee.y, view);\n        const [mx2, my2] = w2s(marquee.x + marquee.width, marquee.y + marquee.height, view);\n        out.push({\n          kind: 'path',\n          path: rectMarkerPath(mx, my, mx2 - mx, my2 - my),\n          fill: { paint: { kind: 'solid', color: style.marqueeFill } },\n          stroke: { paint: { kind: 'solid', color: style.marqueeStroke }, width: 1 },\n        });\n      }\n\n      return out;\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"pathEditingOverlayLayer.js","names":[],"sources":["../../../src/features/paths/pathEditingOverlayLayer.ts"],"sourcesContent":["/**\n * Screen-space render layer for path-editing chrome — the open path's\n * outline, anchor markers, tangent lines, and control-point dots for a\n * polygon path that is the current edit target, under them whatever marks\n * its path-edit extensions draw. Marker sizes stay constant regardless of zoom.\n */\n\nimport type { DrawCommand } from '@weasel-js/renderer';\nimport type { RenderLayer } from 'core/layers/render';\nimport {\n  type AnchorSet, type Path, type PolygonPath, type View, pathToAnchors, rectMarkerPath,\n} from '@weasel-js/geom';\nimport type { GesturePreviewSource } from 'canvas/gestureBounds';\nimport { chromeStateFrom, previewSourcesFrom, isVisibleFrom } from 'canvas/drawEnvelope';\nimport { paintsLayer } from 'core/selection/chromeState';\nimport {\n  anchorMarkerCommands, DEFAULT_OVERLAY_STYLE, worldToScreen, type PathEditingOverlayStyle,\n} from './anchorMarkers';\nimport type { PathEditExtension, PathEditMark } from './pathEditExtension';\nimport type { AnchorMarkerShape } from './pathRepresentation';\n\nexport type { PathEditingOverlayStyle } from './anchorMarkers';\n\n/** Options for `createPathEditingOverlayLayer`. Everything is read per frame,\n *  so the layer follows a changing edit target without being rebuilt. */\nexport interface CreatePathEditingOverlayLayerOptions {\n  /** Returns the id of the polygon currently in anchor-edit mode, or null\n   *  when no node is being edited. */\n  getEditingId(): string | null;\n  /**\n   * Returns the pose for an id, or null if the node has been deleted.\n   * Non-polygon poses are tolerated (the layer no-ops on them).\n   *\n   * `previews` are the drawing view's in-flight preview surfaces, so an\n   * anchor dragged in one panel does not move in the others. Resolve against\n   * them before falling back to the committed pose.\n   *\n   * `view` is the drawing view's camera. Answer in its world: a node whose\n   * layer is a parallax plane stores its path in the plane's.\n   */\n  getPose(id: string, previews: readonly GesturePreviewSource[], view: View): Path | null;\n  /** The marker of each anchor, by flat index, for a node whose path was\n   *  drawn from a form (`PathRepresentation.anchorMarkers`); null, or an\n   *  anchor with none, draws a square. Resolve against `previews` as\n   *  `getPose` does. */\n  getAnchorMarkers?(id: string, previews: readonly GesturePreviewSource[]): readonly (AnchorMarkerShape | null)[] | null;\n  /** Flat indices of the selected anchors. Selected anchors render\n   *  filled; unselected ones hollow. */\n  getSelectedAnchors?(): ReadonlySet<number>;\n  /** In-flight anchor-marquee rect in world coords, or null. Drawn as a\n   *  rubber band while `marqueeAnchorsAction` is dragging. */\n  getMarquee?(view: View): { x: number; y: number; width: number; height: number } | null;\n  /** The edited node's committed pose and data, which extensions' marks read. */\n  getNode?(id: string): { pose: unknown; data: unknown; layer?: string } | null;\n  /** The path-edit extensions whose marks are drawn, in order. */\n  getExtensions?(): readonly PathEditExtension[];\n  /** The selected extension mark, or null. */\n  getSelectedMark?(): PathEditMark | null;\n  /** Optional styling overrides. */\n  style?: PathEditingOverlayStyle;\n}\n\nconst EMPTY_SELECTION: ReadonlySet<number> = new Set();\nconst ALWAYS = (): boolean => true;\n\n/** Render layer that draws the outline and the anchors and control handles\n *  of the path currently being anchor-edited. Draws nothing when no path is\n *  being edited. */\nexport function createPathEditingOverlayLayer(\n  opts: CreatePathEditingOverlayLayerOptions,\n): RenderLayer<unknown> {\n  const style = { ...DEFAULT_OVERLAY_STYLE, ...(opts.style ?? {}) };\n\n  return {\n    id: 'path-editing-overlay',\n    label: 'Path editing',\n    space: 'screen',\n    draw: (data, view) => {\n      const id = opts.getEditingId();\n      if (!id) return [];\n      // Chrome-caps gate off the envelope, so paint and the anchor hit-test in\n      // `affordanceAt` consult the same rule — otherwise a consumer that hides\n      // the chrome still gets grabbable invisible anchors, or vice versa.\n      const isVisible = isVisibleFrom(data);\n      if (isVisible && !isVisible('path-edit.anchors')) return [];\n      const node = opts.getNode?.(id);\n      if (!paintsLayer(chromeStateFrom(data), node?.layer)) return [];\n      const previews = previewSourcesFrom(data);\n      const pose = opts.getPose(id, previews, view);\n      if (!pose || pose.kind !== 'polygon') return [];\n      const markers = opts.getAnchorMarkers?.(id, previews) ?? null;\n\n      const selected = opts.getSelectedAnchors?.() ?? EMPTY_SELECTION;\n      // Extensions' marks under the markers, which are what a press reaches first.\n      const out: DrawCommand[] = [];\n      if (node) {\n        const mark = opts.getSelectedMark?.() ?? null;\n        const anchors = pathToAnchors(pose as PolygonPath) as AnchorSet;\n        const toScreen = (p: { x: number; y: number }) => worldToScreen(p, view);\n        for (const ext of opts.getExtensions?.() ?? []) {\n          if (!ext.marks) continue;\n          out.push(...ext.marks({\n            id, node, path: pose as PolygonPath, anchors, view, toScreen,\n            isVisible: isVisible ?? ALWAYS,\n            selected: mark?.owner === ext.id ? mark.index : null,\n          }));\n        }\n      }\n      out.push(...anchorMarkerCommands(pose as PolygonPath, view, selected, style, markers));\n\n      // Marquee rubber band, on top of everything.\n      const marquee = opts.getMarquee?.(view);\n      if (marquee) {\n        const m = worldToScreen(marquee, view);\n        const m2 = worldToScreen({ x: marquee.x + marquee.width, y: marquee.y + marquee.height }, view);\n        out.push({\n          kind: 'path',\n          path: rectMarkerPath(m.x, m.y, m2.x - m.x, m2.y - m.y),\n          fill: { paint: { kind: 'solid', color: style.marqueeFill } },\n          stroke: { paint: { kind: 'solid', color: style.marqueeStroke }, width: 1 },\n        });\n      }\n\n      return out;\n    },\n  };\n}\n"],"mappings":";;;;;;AA8DA,IAAM,kCAAuC,IAAI,IAAI;AACrD,IAAM,eAAwB;;;;AAK9B,SAAgB,8BACd,MACsB;CACtB,MAAM,QAAQ;EAAE,GAAG;EAAuB,GAAI,KAAK,SAAS,CAAC;CAAG;CAEhE,OAAO;EACL,IAAI;EACJ,OAAO;EACP,OAAO;EACP,OAAO,MAAM,SAAS;GACpB,MAAM,KAAK,KAAK,aAAa;GAC7B,IAAI,CAAC,IAAI,OAAO,CAAC;GAIjB,MAAM,YAAY,cAAc,IAAI;GACpC,IAAI,aAAa,CAAC,UAAU,mBAAmB,GAAG,OAAO,CAAC;GAC1D,MAAM,OAAO,KAAK,UAAU,EAAE;GAC9B,IAAI,CAAC,YAAY,gBAAgB,IAAI,GAAG,MAAM,KAAK,GAAG,OAAO,CAAC;GAC9D,MAAM,WAAW,mBAAmB,IAAI;GACxC,MAAM,OAAO,KAAK,QAAQ,IAAI,UAAU,IAAI;GAC5C,IAAI,CAAC,QAAQ,KAAK,SAAS,WAAW,OAAO,CAAC;GAC9C,MAAM,UAAU,KAAK,mBAAmB,IAAI,QAAQ,KAAK;GAEzD,MAAM,WAAW,KAAK,qBAAqB,KAAK;GAEhD,MAAM,MAAqB,CAAC;GAC5B,IAAI,MAAM;IACR,MAAM,OAAO,KAAK,kBAAkB,KAAK;IACzC,MAAM,UAAU,cAAc,IAAmB;IACjD,MAAM,YAAY,MAAgC,cAAc,GAAG,IAAI;IACvE,KAAK,MAAM,OAAO,KAAK,gBAAgB,KAAK,CAAC,GAAG;KAC9C,IAAI,CAAC,IAAI,OAAO;KAChB,IAAI,KAAK,GAAG,IAAI,MAAM;MACpB;MAAI;MAAM,MAAM;MAAqB;MAAS;MAAM;MACpD,WAAW,aAAa;MACxB,UAAU,MAAM,UAAU,IAAI,KAAK,KAAK,QAAQ;KAClD,CAAC,CAAC;IACJ;GACF;GACA,IAAI,KAAK,GAAG,qBAAqB,MAAqB,MAAM,UAAU,OAAO,OAAO,CAAC;GAGrF,MAAM,UAAU,KAAK,aAAa,IAAI;GACtC,IAAI,SAAS;IACX,MAAM,IAAI,cAAc,SAAS,IAAI;IACrC,MAAM,KAAK,cAAc;KAAE,GAAG,QAAQ,IAAI,QAAQ;KAAO,GAAG,QAAQ,IAAI,QAAQ;IAAO,GAAG,IAAI;IAC9F,IAAI,KAAK;KACP,MAAM;KACN,MAAM,eAAe,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,GAAG,IAAI,EAAE,CAAC;KACrD,MAAM,EAAE,OAAO;MAAE,MAAM;MAAS,OAAO,MAAM;KAAY,EAAE;KAC3D,QAAQ;MAAE,OAAO;OAAE,MAAM;OAAS,OAAO,MAAM;MAAc;MAAG,OAAO;KAAE;IAC3E,CAAC;GACH;GAEA,OAAO;EACT;CACF;AACF"}

package/dist/features/paths/pathLayer.js

@@ -1,45 +1,95 @@
 import "@weasel-js/renderer";
-import { countPathAnchors as e } from "@weasel-js/geom";
+import { countPathAnchors } from "@weasel-js/geom";
+import { isDev } from "@weasel-js/react";
 import "@weasel-js/paint";
+
 //#region src/features/paths/pathLayer.ts
-var t = { paint: { color: "#ffffff" } }, n = {
+var PLACEHOLDER_FILL = { paint: { color: "#ffffff" } };
+var PLACEHOLDER_STROKE = {
 	paint: { color: "#ffffff" },
 	width: 1
 };
-function r(r) {
-	let { id: i = "paths", label: a = "Paths", getNodes: o, getPath: s, getFill: c, getStroke: l, isHidden: u, getVertexColors: d, getStrokeVertexColors: f, getStrokeVertexWidths: p, colorOverrides: m, now: h = () => typeof performance < "u" ? performance.now() : Date.now() } = r;
+/** Build a `RenderLayer` that fills/strokes `Path` instances enumerated from a node list. */
+function createPathLayer(opts) {
+	const { id = "paths", label = "Paths", getNodes, getPath, getFill, getStroke, isHidden, getVertexColors, getStrokeVertexColors, getStrokeVertexWidths, colorOverrides, now = () => typeof performance !== "undefined" ? performance.now() : Date.now() } = opts;
+	const warned = /* @__PURE__ */ new Set();
+	const dev = isDev();
 	return {
-		id: i,
-		label: a,
+		id,
+		label,
 		draw: () => {
-			let r = [], i = o();
-			for (let a = 0; a < i.length; a++) {
-				let o = i[a];
-				if (u?.(o)) continue;
-				let g = s(o), _ = c?.(o), v = l?.(o), y = d?.(o), b = f?.(o), x = p?.(o), S = o.id ?? String(a), C = m ? h() : 0, w = m ? m.resolve(S, "fill", y ?? void 0, C) : y, T = m ? m.resolve(S, "stroke", b ?? void 0, C) : b, E = e(g), D = 4 * E, O = null;
-				w != null && w.length === D && (O = w);
-				let k = null;
-				T != null && T.length === D && (k = T);
-				let A = _ ?? (O == null ? void 0 : t), j = null;
-				x != null && x.length === E && (j = x);
-				let M = v ?? (k != null || j != null ? n : void 0), N = M == null ? M : {
-					...M,
-					...k == null ? {} : { vertexColors: k },
-					...j == null ? {} : { vertexWidths: j }
-				};
-				(A != null || N != null) && r.push({
+			const children = [];
+			const nodes = getNodes();
+			for (let idx = 0; idx < nodes.length; idx++) {
+				const node = nodes[idx];
+				if (isHidden?.(node)) continue;
+				const path = getPath(node);
+				const fillFromHook = getFill?.(node);
+				const strokeFromHook = getStroke?.(node);
+				const baseVColors = getVertexColors?.(node);
+				const baseStrokeVColors = getStrokeVertexColors?.(node);
+				const strokeVWidths = getStrokeVertexWidths?.(node);
+				const nodeId = node.id ?? String(idx);
+				const tMs = colorOverrides ? now() : 0;
+				const vColors = colorOverrides ? colorOverrides.resolve(nodeId, "fill", baseVColors ?? void 0, tMs) : baseVColors;
+				const strokeVColors = colorOverrides ? colorOverrides.resolve(nodeId, "stroke", baseStrokeVColors ?? void 0, tMs) : baseStrokeVColors;
+				const nodeKey = nodeId;
+				const anchorCount = countPathAnchors(path);
+				const expectedLen = 4 * anchorCount;
+				let useVColors = null;
+				if (vColors != null) {
+					if (vColors.length === expectedLen) useVColors = vColors;
+					else if (dev) {
+						const key = `${id}:${nodeKey}:fill`;
+						if (!warned.has(key)) {
+							warned.add(key);
+							console.warn(`[createPathLayer ${id}] node ${nodeKey}: fill vertexColors length ${vColors.length}, expected ${expectedLen}; dropping`);
+						}
+					}
+				}
+				let useStrokeVColors = null;
+				if (strokeVColors != null) {
+					if (strokeVColors.length === expectedLen) useStrokeVColors = strokeVColors;
+					else if (dev) {
+						const key = `${id}:${nodeKey}:stroke`;
+						if (!warned.has(key)) {
+							warned.add(key);
+							console.warn(`[createPathLayer ${id}] node ${nodeKey}: stroke vertexColors length ${strokeVColors.length}, expected ${expectedLen}; dropping`);
+						}
+					}
+				}
+				const fill = fillFromHook != null ? fillFromHook : useVColors != null ? PLACEHOLDER_FILL : void 0;
+				let useStrokeVWidths = null;
+				if (strokeVWidths != null) {
+					if (strokeVWidths.length === anchorCount) useStrokeVWidths = strokeVWidths;
+					else if (dev) {
+						const key = `${id}:${nodeKey}:strokeWidths`;
+						if (!warned.has(key)) {
+							warned.add(key);
+							console.warn(`[createPathLayer ${id}] node ${nodeKey}: stroke vertexWidths length ${strokeVWidths.length}, expected ${anchorCount}; dropping`);
+						}
+					}
+				}
+				const baseStroke = strokeFromHook != null ? strokeFromHook : useStrokeVColors != null || useStrokeVWidths != null ? PLACEHOLDER_STROKE : void 0;
+				const stroke = baseStroke != null ? {
+					...baseStroke,
+					...useStrokeVColors != null ? { vertexColors: useStrokeVColors } : {},
+					...useStrokeVWidths != null ? { vertexWidths: useStrokeVWidths } : {}
+				} : baseStroke;
+				if (fill == null && stroke == null) continue;
+				children.push({
 					kind: "path",
-					path: g,
-					...A == null ? {} : { fill: A },
-					...N == null ? {} : { stroke: N },
-					...O == null ? {} : { vertexColors: O }
+					path,
+					...fill != null ? { fill } : {},
+					...stroke != null ? { stroke } : {},
+					...useVColors != null ? { vertexColors: useVColors } : {}
 				});
 			}
-			return r;
+			return children;
 		}
 	};
 }
-//#endregion
-export { r as createPathLayer };
 
+//#endregion
+export { createPathLayer };
 //# sourceMappingURL=pathLayer.js.map

package/dist/features/paths/pathLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"pathLayer.js","names":["PLACEHOLDER_FILL","PLACEHOLDER_STROKE","createPathLayer","opts","children","nodes","getNodes","idx","node","isHidden","path","getPath","fillFromHook","getFill","strokeFromHook","getStroke","baseVColors","getVertexColors","baseStrokeVColors","getStrokeVertexColors","strokeVWidths","getStrokeVertexWidths","nodeId","tMs","colorOverrides","now","vColors","strokeVColors","anchorCount","countPathAnchors","expectedLen","useVColors","useStrokeVColors","fill","useStrokeVWidths","baseStroke","stroke"],"sources":["../../../src/features/paths/pathLayer.ts"],"sourcesContent":["/**\n * `RenderLayer` that fills/strokes `Path` instances. Mirrors the shape of\n * `createTextLayer`: caller hands over a `getNodes()` enumerator and a\n * `getPath(node)` lookup; the layer iterates and renders. Fill and\n * stroke are looked up per node so consumers can keep the path geometry\n * separate from the visual style record (the typical scene-graph layout).\n */\n\nimport { type DrawCommand } from '@weasel-js/renderer';\nimport { type CommandStroke, type CommandFill } from '@weasel-js/paint';\nimport type { RenderLayer } from 'core/layers/render';\nimport { type Path, countPathAnchors } from '@weasel-js/geom';\nimport type { ColorOverrideRegistry } from '@weasel-js/animator';\n\nconst PLACEHOLDER_FILL: CommandFill = { paint: { color: '#ffffff' } };\nconst PLACEHOLDER_STROKE: CommandStroke = { paint: { color: '#ffffff' }, width: 1 };\n\n\n/** Options for `createPathLayer`. */\nexport interface CreatePathLayerOpts<T> {\n  id?: string;\n  label?: string;\n  getNodes: () => readonly T[];\n  getPath: (node: T) => Path;\n  /** Per-node fill. Return `null`/`undefined` to skip filling. */\n  getFill?: (node: T) => CommandFill | null | undefined;\n  /** Per-node stroke. Return `null`/`undefined` to skip stroking. */\n  getStroke?: (node: T) => CommandStroke | null | undefined;\n  /** Optional per-node hide hook (e.g., suppress while editing). */\n  isHidden?: (node: T) => boolean;\n  /**\n   * Per-node fill vertex-color array, flat RGBA-per-path-anchor, in\n   * 0..1 floats (same color space as `PathDrawCommand.vertexColors`).\n   * Length must be `4 × countPathAnchors(getPath(node))`. When set and\n   * `getFill` returns null/undefined, a white placeholder fill is\n   * synthesized so the renderer's per-vertex shader path activates.\n   */\n  getVertexColors?: (node: T) => number[] | null | undefined;\n  /**\n   * Per-node stroke vertex-color array, flat RGBA-per-path-anchor, in\n   * 0..1 floats (same color space as `Stroke.vertexColors`).\n   * Length must be `4 × countPathAnchors(getPath(node))`. When set and\n   * `getStroke` returns null/undefined, a white 1px placeholder stroke\n   * is synthesized.\n   */\n  getStrokeVertexColors?: (node: T) => number[] | null | undefined;\n  /**\n   * Per-node stroke vertex-width array (one width per anchor).\n   * Length must be `countPathAnchors(getPath(node))`. The tessellator\n   * interpolates half-widths along each segment for tapered strokes.\n   * When set and `getStroke` returns null/undefined, a 1px placeholder\n   * stroke is synthesized so the per-anchor widths take effect.\n   */\n  getStrokeVertexWidths?: (node: T) => number[] | null | undefined;\n  /**\n   * Optional color override registry, typically `animator.colorOverrides`.\n   * When set, the renderer consults it before falling back to\n   * `getVertexColors` / `getStrokeVertexColors`. Function-form overrides\n   * receive the base color array and the current animation timestamp.\n   */\n  colorOverrides?: ColorOverrideRegistry;\n  /** Clock used to timestamp function-form color overrides. Defaults to\n   *  `performance.now`. Override in tests. */\n  now?: () => number;\n}\n\n/** Build a `RenderLayer` that fills/strokes `Path` instances enumerated from a node list. */\nexport function createPathLayer<T>(opts: CreatePathLayerOpts<T>): RenderLayer<unknown> {\n  const {\n    id = 'paths', label = 'Paths',\n    getNodes, getPath, getFill, getStroke, isHidden,\n    getVertexColors, getStrokeVertexColors, getStrokeVertexWidths,\n    colorOverrides,\n    now = (): number => (typeof performance !== 'undefined' ? performance.now() : Date.now()),\n  } = opts;\n  const warned = new Set<string>();\n  const isDev = typeof import.meta !== 'undefined'\n    && (import.meta as unknown as { env?: { DEV?: boolean } }).env\n    && (import.meta as unknown as { env?: { DEV?: boolean } }).env?.DEV;\n\n  return {\n    id,\n    label,\n    draw: () => {\n      const children: DrawCommand[] = [];\n      const nodes = getNodes();\n      for (let idx = 0; idx < nodes.length; idx++) {\n        const node = nodes[idx];\n        if (isHidden?.(node)) continue;\n        const path = getPath(node);\n        const fillFromHook = getFill?.(node);\n        const strokeFromHook = getStroke?.(node);\n        const baseVColors = getVertexColors?.(node);\n        const baseStrokeVColors = getStrokeVertexColors?.(node);\n        const strokeVWidths = getStrokeVertexWidths?.(node);\n\n        const nodeId = (node as { id?: string }).id ?? String(idx);\n        const tMs = colorOverrides ? now() : 0;\n\n        const vColors = colorOverrides\n          ? colorOverrides.resolve(nodeId, 'fill', baseVColors ?? undefined, tMs)\n          : baseVColors;\n        const strokeVColors = colorOverrides\n          ? colorOverrides.resolve(nodeId, 'stroke', baseStrokeVColors ?? undefined, tMs)\n          : baseStrokeVColors;\n\n        const nodeKey = nodeId;\n        const anchorCount = countPathAnchors(path);\n        const expectedLen = 4 * anchorCount;\n\n        let useVColors: readonly number[] | null = null;\n        if (vColors != null) {\n          if (vColors.length === expectedLen) {\n            useVColors = vColors;\n          } else if (isDev) {\n            const key = `${id}:${nodeKey}:fill`;\n            if (!warned.has(key)) {\n              warned.add(key);\n              console.warn(\n                `[createPathLayer ${id}] node ${nodeKey}: fill vertexColors length ${vColors.length}, expected ${expectedLen}; dropping`,\n              );\n            }\n          }\n        }\n\n        let useStrokeVColors: readonly number[] | null = null;\n        if (strokeVColors != null) {\n          if (strokeVColors.length === expectedLen) {\n            useStrokeVColors = strokeVColors;\n          } else if (isDev) {\n            const key = `${id}:${nodeKey}:stroke`;\n            if (!warned.has(key)) {\n              warned.add(key);\n              console.warn(\n                `[createPathLayer ${id}] node ${nodeKey}: stroke vertexColors length ${strokeVColors.length}, expected ${expectedLen}; dropping`,\n              );\n            }\n          }\n        }\n\n        // Synthesize placeholder only when colors validate (useVColors != null),\n        // not on any raw hook return. Mismatched-length arrays drop both the\n        // colors and placeholder so the dev signal (console warning) isn't duplicated.\n        const fill: CommandFill | undefined =\n          fillFromHook != null ? fillFromHook\n          : (useVColors != null ? PLACEHOLDER_FILL : undefined);\n\n        let useStrokeVWidths: number[] | null = null;\n        if (strokeVWidths != null) {\n          if (strokeVWidths.length === anchorCount) {\n            useStrokeVWidths = strokeVWidths;\n          } else if (isDev) {\n            const key = `${id}:${nodeKey}:strokeWidths`;\n            if (!warned.has(key)) {\n              warned.add(key);\n              console.warn(\n                `[createPathLayer ${id}] node ${nodeKey}: stroke vertexWidths length ${strokeVWidths.length}, expected ${anchorCount}; dropping`,\n              );\n            }\n          }\n        }\n\n        const baseStroke: CommandStroke | undefined =\n          strokeFromHook != null ? strokeFromHook\n          : (useStrokeVColors != null || useStrokeVWidths != null ? PLACEHOLDER_STROKE : undefined);\n\n        const stroke: CommandStroke | undefined =\n          baseStroke != null\n            ? {\n                ...baseStroke,\n                ...(useStrokeVColors != null ? { vertexColors: useStrokeVColors as number[] } : {}),\n                ...(useStrokeVWidths != null ? { vertexWidths: useStrokeVWidths } : {}),\n              }\n            : baseStroke;\n\n        if (fill == null && stroke == null) continue;\n\n        children.push({\n          kind: 'path',\n          path,\n          ...(fill != null ? { fill } : {}),\n          ...(stroke != null ? { stroke } : {}),\n          ...(useVColors != null ? { vertexColors: useVColors as number[] } : {}),\n        });\n      }\n      // World-space commands; drawLayers wraps in viewToMat3 automatically.\n      return children;\n    },\n  };\n}\n"],"mappings":";;;;AAcA,IAAMA,IAAgC,EAAE,OAAO,EAAE,OAAO,UAAU,EAAE,GAC9DC,IAAoC;CAAE,OAAO,EAAE,OAAO,UAAU;CAAG,OAAO;AAAE;AAoDlF,SAAgBC,EAAmB,GAAoD;CACrF,IAAM,EACJ,QAAK,SAAS,WAAQ,SACtB,aAAU,YAAS,YAAS,cAAW,aACvC,oBAAiB,0BAAuB,0BACxC,mBACA,eAAqB,OAAO,cAAgB,MAAc,YAAY,IAAI,IAAI,KAAK,IAAI,MACrFC;CAMJ,OAAO;EACL;EACA;EACA,YAAY;GACV,IAAMC,IAA0B,CAAC,GAC3BC,IAAQC,EAAS;GACvB,KAAK,IAAIC,IAAM,GAAGA,IAAMF,EAAM,QAAQ,KAAO;IAC3C,IAAMG,IAAOH,EAAME;IACnB,IAAIE,IAAWD,CAAI,GAAG;IACtB,IAAME,IAAOC,EAAQH,CAAI,GACnBI,IAAeC,IAAUL,CAAI,GAC7BM,IAAiBC,IAAYP,CAAI,GACjCQ,IAAcC,IAAkBT,CAAI,GACpCU,IAAoBC,IAAwBX,CAAI,GAChDY,IAAgBC,IAAwBb,CAAI,GAE5Cc,IAAUd,EAAyB,MAAM,OAAOD,CAAG,GACnDgB,IAAMC,IAAiBC,EAAI,IAAI,GAE/BC,IAAUF,IACZA,EAAe,QAAQF,GAAQ,QAAQN,KAAe,KAAA,GAAWO,CAAG,IACpEP,GACEW,IAAgBH,IAClBA,EAAe,QAAQF,GAAQ,UAAUJ,KAAqB,KAAA,GAAWK,CAAG,IAC5EL,GAGEU,IAAcC,EAAiBnB,CAAI,GACnCoB,IAAc,IAAIF,GAEpBG,IAAuC;IAC3C,AAAIL,KAAW,QACTA,EAAQ,WAAWI,MACrB,IAAaJ;IAYjB,IAAIM,IAA6C;IACjD,AAAIL,KAAiB,QACfA,EAAc,WAAWG,MAC3B,IAAmBH;IAevB,IAAMM,IACJrB,MACGmB,KAAc,OAA0B,KAAA,IAAnB/B,IAEtBkC,IAAoC;IACxC,AAAId,KAAiB,QACfA,EAAc,WAAWQ,MAC3B,IAAmBR;IAYvB,IAAMe,IACJrB,MACGkB,KAAoB,QAAQE,KAAoB,OAAOjC,IAAqB,KAAA,IAE3EmC,IACJD,KAAc,OAMVA,IALA;KACE,GAAGA;KACH,GAAIH,KAAoB,OAAwD,CAAC,IAAlD,EAAE,cAAcA,EAA6B;KAC5E,GAAIE,KAAoB,OAA4C,CAAC,IAAtC,EAAE,cAAcA,EAAiB;IAClE;IAGN,CAAID,KAAQ,QAAQG,KAAU,SAE9BhC,EAAS,KAAK;KACZ,MAAM;KACN;KACA,GAAI6B,KAAQ,OAAkB,CAAC,IAAZ,EAAE,QAAK;KAC1B,GAAIG,KAAU,OAAoB,CAAC,IAAd,EAAE,UAAO;KAC9B,GAAIL,KAAc,OAAkD,CAAC,IAA5C,EAAE,cAAcA,EAAuB;IAClE,CAAC;GACH;GAEA,OAAO3B;EACT;CACF;AACF"}
+{"version":3,"file":"pathLayer.js","names":[],"sources":["../../../src/features/paths/pathLayer.ts"],"sourcesContent":["/**\n * `RenderLayer` that fills/strokes `Path` instances. Mirrors the shape of\n * `createTextLayer`: caller hands over a `getNodes()` enumerator and a\n * `getPath(node)` lookup; the layer iterates and renders. Fill and\n * stroke are looked up per node so consumers can keep the path geometry\n * separate from the visual style record (the typical scene-graph layout).\n */\n\nimport { type DrawCommand } from '@weasel-js/renderer';\nimport { type CommandStroke, type CommandFill, type VertexWidth } from '@weasel-js/paint';\nimport type { RenderLayer } from 'core/layers/render';\nimport { type Path, countPathAnchors } from '@weasel-js/geom';\nimport type { ColorOverrideRegistry } from '@weasel-js/animator';\nimport { isDev } from '@weasel-js/react';\n\nconst PLACEHOLDER_FILL: CommandFill = { paint: { color: '#ffffff' } };\nconst PLACEHOLDER_STROKE: CommandStroke = { paint: { color: '#ffffff' }, width: 1 };\n\n\n/** Options for `createPathLayer`. */\nexport interface CreatePathLayerOpts<T> {\n  id?: string;\n  label?: string;\n  getNodes: () => readonly T[];\n  getPath: (node: T) => Path;\n  /** Per-node fill. Return `null`/`undefined` to skip filling. */\n  getFill?: (node: T) => CommandFill | null | undefined;\n  /** Per-node stroke. Return `null`/`undefined` to skip stroking. */\n  getStroke?: (node: T) => CommandStroke | null | undefined;\n  /** Optional per-node hide hook (e.g., suppress while editing). */\n  isHidden?: (node: T) => boolean;\n  /**\n   * Per-node fill vertex-color array, flat RGBA-per-path-anchor, in\n   * 0..1 floats (same color space as `PathDrawCommand.vertexColors`).\n   * Length must be `4 × countPathAnchors(getPath(node))`. When set and\n   * `getFill` returns null/undefined, a white placeholder fill is\n   * synthesized so the renderer's per-vertex shader path activates.\n   */\n  getVertexColors?: (node: T) => number[] | null | undefined;\n  /**\n   * Per-node stroke vertex-color array, flat RGBA-per-path-anchor, in\n   * 0..1 floats (same color space as `Stroke.vertexColors`).\n   * Length must be `4 × countPathAnchors(getPath(node))`. When set and\n   * `getStroke` returns null/undefined, a white 1px placeholder stroke\n   * is synthesized.\n   */\n  getStrokeVertexColors?: (node: T) => number[] | null | undefined;\n  /**\n   * Per-node stroke vertex-width array (one `VertexWidth` per anchor: a\n   * width, or a `{ left, right }` pair).\n   * Length must be `countPathAnchors(getPath(node))`. The tessellator\n   * interpolates half-widths along each segment for tapered strokes.\n   * When set and `getStroke` returns null/undefined, a 1px placeholder\n   * stroke is synthesized so the per-anchor widths take effect.\n   */\n  getStrokeVertexWidths?: (node: T) => VertexWidth[] | null | undefined;\n  /**\n   * Optional color override registry, typically `animator.colorOverrides`.\n   * When set, the renderer consults it before falling back to\n   * `getVertexColors` / `getStrokeVertexColors`. Function-form overrides\n   * receive the base color array and the current animation timestamp.\n   */\n  colorOverrides?: ColorOverrideRegistry;\n  /** Clock used to timestamp function-form color overrides. Defaults to\n   *  `performance.now`. Override in tests. */\n  now?: () => number;\n}\n\n/** Build a `RenderLayer` that fills/strokes `Path` instances enumerated from a node list. */\nexport function createPathLayer<T>(opts: CreatePathLayerOpts<T>): RenderLayer<unknown> {\n  const {\n    id = 'paths', label = 'Paths',\n    getNodes, getPath, getFill, getStroke, isHidden,\n    getVertexColors, getStrokeVertexColors, getStrokeVertexWidths,\n    colorOverrides,\n    now = (): number => (typeof performance !== 'undefined' ? performance.now() : Date.now()),\n  } = opts;\n  const warned = new Set<string>();\n  const dev = isDev();\n\n  return {\n    id,\n    label,\n    draw: () => {\n      const children: DrawCommand[] = [];\n      const nodes = getNodes();\n      for (let idx = 0; idx < nodes.length; idx++) {\n        const node = nodes[idx];\n        if (isHidden?.(node)) continue;\n        const path = getPath(node);\n        const fillFromHook = getFill?.(node);\n        const strokeFromHook = getStroke?.(node);\n        const baseVColors = getVertexColors?.(node);\n        const baseStrokeVColors = getStrokeVertexColors?.(node);\n        const strokeVWidths = getStrokeVertexWidths?.(node);\n\n        const nodeId = (node as { id?: string }).id ?? String(idx);\n        const tMs = colorOverrides ? now() : 0;\n\n        const vColors = colorOverrides\n          ? colorOverrides.resolve(nodeId, 'fill', baseVColors ?? undefined, tMs)\n          : baseVColors;\n        const strokeVColors = colorOverrides\n          ? colorOverrides.resolve(nodeId, 'stroke', baseStrokeVColors ?? undefined, tMs)\n          : baseStrokeVColors;\n\n        const nodeKey = nodeId;\n        const anchorCount = countPathAnchors(path);\n        const expectedLen = 4 * anchorCount;\n\n        let useVColors: readonly number[] | null = null;\n        if (vColors != null) {\n          if (vColors.length === expectedLen) {\n            useVColors = vColors;\n          } else if (dev) {\n            const key = `${id}:${nodeKey}:fill`;\n            if (!warned.has(key)) {\n              warned.add(key);\n              console.warn(\n                `[createPathLayer ${id}] node ${nodeKey}: fill vertexColors length ${vColors.length}, expected ${expectedLen}; dropping`,\n              );\n            }\n          }\n        }\n\n        let useStrokeVColors: readonly number[] | null = null;\n        if (strokeVColors != null) {\n          if (strokeVColors.length === expectedLen) {\n            useStrokeVColors = strokeVColors;\n          } else if (dev) {\n            const key = `${id}:${nodeKey}:stroke`;\n            if (!warned.has(key)) {\n              warned.add(key);\n              console.warn(\n                `[createPathLayer ${id}] node ${nodeKey}: stroke vertexColors length ${strokeVColors.length}, expected ${expectedLen}; dropping`,\n              );\n            }\n          }\n        }\n\n        // Synthesize placeholder only when colors validate (useVColors != null),\n        // not on any raw hook return. Mismatched-length arrays drop both the\n        // colors and placeholder so the dev signal (console warning) isn't duplicated.\n        const fill: CommandFill | undefined =\n          fillFromHook != null ? fillFromHook\n          : (useVColors != null ? PLACEHOLDER_FILL : undefined);\n\n        let useStrokeVWidths: VertexWidth[] | null = null;\n        if (strokeVWidths != null) {\n          if (strokeVWidths.length === anchorCount) {\n            useStrokeVWidths = strokeVWidths;\n          } else if (dev) {\n            const key = `${id}:${nodeKey}:strokeWidths`;\n            if (!warned.has(key)) {\n              warned.add(key);\n              console.warn(\n                `[createPathLayer ${id}] node ${nodeKey}: stroke vertexWidths length ${strokeVWidths.length}, expected ${anchorCount}; dropping`,\n              );\n            }\n          }\n        }\n\n        const baseStroke: CommandStroke | undefined =\n          strokeFromHook != null ? strokeFromHook\n          : (useStrokeVColors != null || useStrokeVWidths != null ? PLACEHOLDER_STROKE : undefined);\n\n        const stroke: CommandStroke | undefined =\n          baseStroke != null\n            ? {\n                ...baseStroke,\n                ...(useStrokeVColors != null ? { vertexColors: useStrokeVColors as number[] } : {}),\n                ...(useStrokeVWidths != null ? { vertexWidths: useStrokeVWidths } : {}),\n              }\n            : baseStroke;\n\n        if (fill == null && stroke == null) continue;\n\n        children.push({\n          kind: 'path',\n          path,\n          ...(fill != null ? { fill } : {}),\n          ...(stroke != null ? { stroke } : {}),\n          ...(useVColors != null ? { vertexColors: useVColors as number[] } : {}),\n        });\n      }\n      // World-space commands; drawLayers wraps in viewToMat3 automatically.\n      return children;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/features/paths/pathRepresentation.js

@@ -0,0 +1,27 @@
+//#region src/features/paths/pathRepresentation.ts
+/** The form `data` holds, or null. */
+function pathFormOf(data) {
+	const form = data?.representation;
+	return form && typeof form === "object" && typeof form.kind === "string" ? form : null;
+}
+/** `data` without its form: its path as plain geometry. */
+function withoutPathForm(data) {
+	if (data === null || typeof data !== "object" || !("representation" in data)) return data;
+	const { representation: _dropped, ...rest } = data;
+	return rest;
+}
+/** The form `data` holds, and the representation among `extensions` that
+*  reads it; null when either is missing. */
+function representationOf(extensions, data) {
+	const form = pathFormOf(data);
+	if (!form || !extensions) return null;
+	const representation = extensions.find((e) => e.representation?.kind === form.kind)?.representation;
+	return representation ? {
+		representation,
+		form
+	} : null;
+}
+
+//#endregion
+export { pathFormOf, representationOf, withoutPathForm };
+//# sourceMappingURL=pathRepresentation.js.map

package/dist/features/paths/pathRepresentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathRepresentation.js","names":[],"sources":["../../../src/features/paths/pathRepresentation.ts"],"sourcesContent":["/**\n * A path drawn from another form the node keeps beside it, such as a curve\n * solved through the points it passes. The node's path stays the geometry\n * every reader draws and hit-tests; `data.representation` holds the form,\n * named by its `kind`. A preset that knows a kind brings a\n * {@link PathRepresentation} for it (`PathEditExtension.representation`),\n * through which path edit shows and edits the form. Where none is on, path\n * edit edits the drawn path, and the edit drops the form.\n */\nimport type { ActionDeps, OngoingHandle } from '@weasel-js/routing';\nimport type { PolygonPath } from '@weasel-js/geom';\nimport type { PathEditExtension } from './pathEditExtension';\n\n/** What `data.representation` holds: a form named by `kind`, with whatever\n *  that kind keeps. */\nexport interface PathForm {\n  readonly kind: string;\n  readonly [field: string]: unknown;\n}\n\ntype Point = { x: number; y: number };\n\n/** The outline of an anchor's marker, in screen space: `size` px across at\n *  `at`, with the anchor's neighbors along its subpath, null past an open\n *  end. */\nexport type AnchorMarkerShape = (at: Point, size: number, prev: Point | null, next: Point | null) => PolygonPath;\n\n/** How path edit reads and writes one kind of {@link PathForm}. */\nexport interface PathRepresentation {\n  /** The `kind` of the forms it reads. */\n  readonly kind: string;\n  /** What path edit shows and moves for a node holding `form`, whose drawn\n   *  path in world space is `path`. Null when `form` does not describe\n   *  `path`: path edit then edits `path`, and the edit drops the form. */\n  editPath(path: PolygonPath, form: PathForm): PolygonPath | null;\n  /**\n   * The drawn path an edit makes, and the form to keep beside it: `edited` is\n   * an edit of what {@link editPath} gave, `path` the drawn path it was given\n   * from. Null when `form` does not describe `path`; the edit is then stored\n   * as drawn, without the form. Runs on every commit of an edit and every\n   * frame of one in flight.\n   */\n  store(path: PolygonPath, form: PathForm, edited: PolygonPath): { path: PolygonPath; form: PathForm } | null;\n  /** The marker of each anchor of the edit path, by flat index. An anchor\n   *  with none draws path edit's square. */\n  anchorMarkers?(form: PathForm): readonly (AnchorMarkerShape | null)[];\n  /**\n   * A press at world point `at` on the drawn outline of the node in path\n   * edit: the drag it starts, or null when it starts none there. A\n   * representation that has this takes every segment press, in place of\n   * Bend segment.\n   */\n  segmentPress?(deps: ActionDeps, at: Point): (() => OngoingHandle) | null;\n}\n\n/** The form `data` holds, or null. */\nexport function pathFormOf(data: unknown): PathForm | null {\n  const form = (data as { representation?: unknown } | null | undefined)?.representation;\n  return form && typeof form === 'object' && typeof (form as { kind?: unknown }).kind === 'string'\n    ? (form as PathForm)\n    : null;\n}\n\n/** `data` without its form: its path as plain geometry. */\nexport function withoutPathForm<T>(data: T): T {\n  if (data === null || typeof data !== 'object' || !('representation' in data)) return data;\n  const { representation: _dropped, ...rest } = data as Record<string, unknown>;\n  void _dropped;\n  return rest as T;\n}\n\n/** The form `data` holds, and the representation among `extensions` that\n *  reads it; null when either is missing. */\nexport function representationOf(\n  extensions: readonly PathEditExtension[] | undefined,\n  data: unknown,\n): { representation: PathRepresentation; form: PathForm } | null {\n  const form = pathFormOf(data);\n  if (!form || !extensions) return null;\n  const representation = extensions.find((e) => e.representation?.kind === form.kind)?.representation;\n  return representation ? { representation, form } : null;\n}\n"],"mappings":";;AAwDA,SAAgB,WAAW,MAAgC;CACzD,MAAM,OAAQ,MAA0D;CACxE,OAAO,QAAQ,OAAO,SAAS,YAAY,OAAQ,KAA4B,SAAS,WACnF,OACD;AACN;;AAGA,SAAgB,gBAAmB,MAAY;CAC7C,IAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,EAAE,oBAAoB,OAAO,OAAO;CACrF,MAAM,EAAE,gBAAgB,UAAU,GAAG,SAAS;CAE9C,OAAO;AACT;;;AAIA,SAAgB,iBACd,YACA,MAC+D;CAC/D,MAAM,OAAO,WAAW,IAAI;CAC5B,IAAI,CAAC,QAAQ,CAAC,YAAY,OAAO;CACjC,MAAM,iBAAiB,WAAW,MAAM,MAAM,EAAE,gBAAgB,SAAS,KAAK,IAAI,CAAC,EAAE;CACrF,OAAO,iBAAiB;EAAE;EAAgB;CAAK,IAAI;AACrD"}

package/dist/features/paths/pathSnap/glyphs.js

@@ -0,0 +1,39 @@
+//#region src/features/paths/pathSnap/glyphs.ts
+/** What the snap readout calls each kind of path target. */
+var PATH_SNAP_LABELS = {
+	anchor: "anchor",
+	center: "center",
+	intersection: "intersection",
+	tangent: "tangent",
+	perpendicular: "perpendicular",
+	midpoint: "midpoint",
+	extremum: "extremum",
+	quadrant: "quadrant",
+	nearest: "on path"
+};
+/** The glyph for `kind` centered on (x, y), `r` from center to edge, as SVG path data. */
+function pathSnapGlyph(kind, x, y, r) {
+	const L = x - r, R = x + r, T = y - r, B = y + r;
+	const ring = (cx, cy, rc) => {
+		const k = rc * .5523;
+		return `M${cx} ${cy - rc} C${cx + k} ${cy - rc} ${cx + rc} ${cy - k} ${cx + rc} ${cy} C${cx + rc} ${cy + k} ${cx + k} ${cy + rc} ${cx} ${cy + rc} C${cx - k} ${cy + rc} ${cx - rc} ${cy + k} ${cx - rc} ${cy} C${cx - rc} ${cy - k} ${cx - k} ${cy - rc} ${cx} ${cy - rc} Z`;
+	};
+	switch (kind) {
+		case "anchor": return `M${L} ${T} H${R} V${B} H${L} Z`;
+		case "center": return `${ring(x, y, r)} M${L} ${y} H${R} M${x} ${T} V${B}`;
+		case "intersection": return `M${L} ${T} L${R} ${B} M${R} ${T} L${L} ${B}`;
+		case "midpoint": return `M${x} ${T} L${R} ${B} L${L} ${B} Z`;
+		case "extremum": return `M${x} ${T} L${R} ${y} L${x} ${B} L${L} ${y} Z`;
+		case "quadrant": return ring(x, y, r);
+		case "perpendicular": return `M${L} ${T} V${B} H${R} M${L} ${y} H${x} V${B}`;
+		case "nearest": return `M${L} ${T} H${R} L${L} ${B} H${R} Z`;
+		case "tangent": {
+			const rc = 3 * r / 4;
+			return `${ring(x, y + r / 4, rc)} M${L} ${y + r / 4 - rc} H${R}`;
+		}
+	}
+}
+
+//#endregion
+export { PATH_SNAP_LABELS, pathSnapGlyph };
+//# sourceMappingURL=glyphs.js.map

package/dist/features/paths/pathSnap/glyphs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyphs.js","names":[],"sources":["../../../../src/features/paths/pathSnap/glyphs.ts"],"sourcesContent":["import type { PathSnapKind } from '@weasel-js/geom';\n\n/** What the snap readout calls each kind of path target. */\nexport const PATH_SNAP_LABELS: Readonly<Record<PathSnapKind, string>> = {\n  anchor: 'anchor',\n  center: 'center',\n  intersection: 'intersection',\n  tangent: 'tangent',\n  perpendicular: 'perpendicular',\n  midpoint: 'midpoint',\n  extremum: 'extremum',\n  quadrant: 'quadrant',\n  nearest: 'on path',\n};\n\n/** The glyph for `kind` centered on (x, y), `r` from center to edge, as SVG path data. */\nexport function pathSnapGlyph(kind: PathSnapKind, x: number, y: number, r: number): string {\n  const L = x - r, R = x + r, T = y - r, B = y + r;\n  const ring = (cx: number, cy: number, rc: number) => {\n    const k = rc * 0.5523;\n    return `M${cx} ${cy - rc} C${cx + k} ${cy - rc} ${cx + rc} ${cy - k} ${cx + rc} ${cy}`\n      + ` C${cx + rc} ${cy + k} ${cx + k} ${cy + rc} ${cx} ${cy + rc}`\n      + ` C${cx - k} ${cy + rc} ${cx - rc} ${cy + k} ${cx - rc} ${cy}`\n      + ` C${cx - rc} ${cy - k} ${cx - k} ${cy - rc} ${cx} ${cy - rc} Z`;\n  };\n  switch (kind) {\n    case 'anchor': return `M${L} ${T} H${R} V${B} H${L} Z`;\n    case 'center': return `${ring(x, y, r)} M${L} ${y} H${R} M${x} ${T} V${B}`;\n    case 'intersection': return `M${L} ${T} L${R} ${B} M${R} ${T} L${L} ${B}`;\n    case 'midpoint': return `M${x} ${T} L${R} ${B} L${L} ${B} Z`;\n    case 'extremum': return `M${x} ${T} L${R} ${y} L${x} ${B} L${L} ${y} Z`;\n    case 'quadrant': return ring(x, y, r);\n    case 'perpendicular': return `M${L} ${T} V${B} H${R} M${L} ${y} H${x} V${B}`;\n    case 'nearest': return `M${L} ${T} H${R} L${L} ${B} H${R} Z`;\n    case 'tangent': {\n      const rc = (3 * r) / 4;\n      return `${ring(x, y + r / 4, rc)} M${L} ${y + r / 4 - rc} H${R}`;\n    }\n  }\n}\n"],"mappings":";;AAGA,IAAa,mBAA2D;CACtE,QAAQ;CACR,QAAQ;CACR,cAAc;CACd,SAAS;CACT,eAAe;CACf,UAAU;CACV,UAAU;CACV,UAAU;CACV,SAAS;AACX;;AAGA,SAAgB,cAAc,MAAoB,GAAW,GAAW,GAAmB;CACzF,MAAM,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,IAAI,IAAI;CAC/C,MAAM,QAAQ,IAAY,IAAY,OAAe;EACnD,MAAM,IAAI,KAAK;EACf,OAAO,IAAI,GAAG,GAAG,KAAK,GAAG,IAAI,KAAK,EAAE,GAAG,KAAK,GAAG,GAAG,KAAK,GAAG,GAAG,KAAK,EAAE,GAAG,KAAK,GAAG,GAAG,OACzE,KAAK,GAAG,GAAG,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,KAAK,OACrD,KAAK,EAAE,GAAG,KAAK,GAAG,GAAG,KAAK,GAAG,GAAG,KAAK,EAAE,GAAG,KAAK,GAAG,GAAG,OACrD,KAAK,GAAG,GAAG,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,KAAK,GAAG;CACnE;CACA,QAAQ,MAAR;EACE,KAAK,UAAU,OAAO,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;EACnD,KAAK,UAAU,OAAO,GAAG,KAAK,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI;EACvE,KAAK,gBAAgB,OAAO,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG;EACtE,KAAK,YAAY,OAAO,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;EACzD,KAAK,YAAY,OAAO,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;EACpE,KAAK,YAAY,OAAO,KAAK,GAAG,GAAG,CAAC;EACpC,KAAK,iBAAiB,OAAO,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI;EACzE,KAAK,WAAW,OAAO,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;EACzD,KAAK,WAAW;GACd,MAAM,KAAM,IAAI,IAAK;GACrB,OAAO,GAAG,KAAK,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI;EAC/D;CACF;AACF"}

package/dist/features/paths/pathSnap/pathSnapSource.js

@@ -0,0 +1,82 @@
+import { DEFAULT_SNAP_PX } from "../../snap/session2d.js";
+import { PATH_SNAP_LABELS } from "./glyphs.js";
+import { sceneSnapIndex } from "./sceneIndex.js";
+import { PATH_SNAP_KINDS, findPathSnap, findPathSnaps } from "@weasel-js/geom";
+
+//#region src/features/paths/pathSnap/pathSnapSource.ts
+/**
+* The scene's paths as snap targets: a point for every enabled kind of
+* target in range of a pointer or geometry probe. `nearest` is offered only
+* when no other kind is in range of that probe. Tangent and perpendicular
+* targets need the query's `origin`.
+*/
+function pathSnapSource(opts = {}) {
+	const kinds = (opts.only ?? PATH_SNAP_KINDS).filter((k) => opts.kinds?.[k] !== false);
+	return {
+		id: "path-snap",
+		roles: ["pointer", "geometry"],
+		...opts.reachPx !== void 0 ? { reachPx: opts.reachPx } : {},
+		*collect(q) {
+			if (!q.scene) return;
+			const { ids, index } = sceneSnapIndex(q.scene, q.also);
+			const exclude = new Set(q.exclude);
+			const include = q.include ? new Set(q.include) : null;
+			const radius = q.reachWorld(opts.reachPx ?? q.reachPx);
+			const skip = (i) => {
+				const id = ids[i];
+				if (id === null) return false;
+				return exclude.has(id) || (include ? !include.has(id) : false);
+			};
+			for (const p of q.probes) {
+				const hits = findPathSnaps(index, p.at, {
+					radius,
+					kinds,
+					skip,
+					...q.origin ? { origin: q.origin } : {}
+				});
+				for (const h of hits) {
+					const at = {
+						x: h.x,
+						y: h.y
+					};
+					yield {
+						probe: p.id,
+						locus: {
+							at,
+							dirs: []
+						},
+						mark: {
+							kind: "point",
+							at,
+							glyph: h.kind,
+							label: PATH_SNAP_LABELS[h.kind]
+						}
+					};
+				}
+			}
+		}
+	};
+}
+/** The point of the nodes `ids`' own geometry nearest `press`, within
+*  `reachPx` screen px, or null: where a move's `geometry` probe sits. Leaves
+*  no mark. */
+function ownGeometryAt(scene, press, ids, scale, reachPx = DEFAULT_SNAP_PX) {
+	const { ids: owners, index } = sceneSnapIndex(scene);
+	const own = new Set(ids);
+	const hit = findPathSnap(index, press, {
+		radius: reachPx,
+		scale,
+		skip: (i) => {
+			const id = owners[i];
+			return id !== null && !own.has(id);
+		}
+	});
+	return hit ? {
+		x: hit.x,
+		y: hit.y
+	} : null;
+}
+
+//#endregion
+export { ownGeometryAt, pathSnapSource };
+//# sourceMappingURL=pathSnapSource.js.map

package/dist/features/paths/pathSnap/pathSnapSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathSnapSource.js","names":[],"sources":["../../../../src/features/paths/pathSnap/pathSnapSource.ts"],"sourcesContent":["import { findPathSnap, findPathSnaps, PATH_SNAP_KINDS, type PathSnapKind } from '@weasel-js/geom';\nimport type { Scene } from 'core/scene/types';\nimport { DEFAULT_SNAP_PX } from 'features/snap/session2d';\nimport type { SnapSource } from 'features/snap/types';\nimport { PATH_SNAP_LABELS } from './glyphs';\nimport { sceneSnapIndex } from './sceneIndex';\n\ntype Point = { x: number; y: number };\n\n/** Options for `pathSnapSource`. */\nexport interface PathSnapSourceOptions {\n  /** The kinds offered. Default: every kind. */\n  only?: readonly PathSnapKind[];\n  /** Kinds to turn on or off. A kind not named is on. */\n  kinds?: Partial<Record<PathSnapKind, boolean>>;\n  /** Overrides the canvas's reach for path targets, in screen px. */\n  reachPx?: number;\n}\n\n/**\n * The scene's paths as snap targets: a point for every enabled kind of\n * target in range of a pointer or geometry probe. `nearest` is offered only\n * when no other kind is in range of that probe. Tangent and perpendicular\n * targets need the query's `origin`.\n */\nexport function pathSnapSource(opts: PathSnapSourceOptions = {}): SnapSource {\n  const kinds = (opts.only ?? PATH_SNAP_KINDS).filter((k) => opts.kinds?.[k] !== false);\n  return {\n    id: 'path-snap',\n    roles: ['pointer', 'geometry'],\n    ...(opts.reachPx !== undefined ? { reachPx: opts.reachPx } : {}),\n    *collect(q) {\n      if (!q.scene) return;\n      const { ids, index } = sceneSnapIndex(q.scene, q.also);\n      const exclude = new Set(q.exclude);\n      const include = q.include ? new Set(q.include) : null;\n      const radius = q.reachWorld(opts.reachPx ?? q.reachPx);\n      const skip = (i: number) => {\n        const id = ids[i];\n        if (id === null) return false;\n        return exclude.has(id) || (include ? !include.has(id) : false);\n      };\n      for (const p of q.probes) {\n        const hits = findPathSnaps(index, p.at, { radius, kinds, skip, ...(q.origin ? { origin: q.origin } : {}) });\n        for (const h of hits) {\n          const at = { x: h.x, y: h.y };\n          yield {\n            probe: p.id,\n            locus: { at, dirs: [] },\n            mark: { kind: 'point', at, glyph: h.kind, label: PATH_SNAP_LABELS[h.kind] },\n          };\n        }\n      }\n    },\n  };\n}\n\n/** The point of the nodes `ids`' own geometry nearest `press`, within\n *  `reachPx` screen px, or null: where a move's `geometry` probe sits. Leaves\n *  no mark. */\nexport function ownGeometryAt(\n  scene: Pick<Scene<unknown, string, unknown>, 'nodes' | 'layers' | 'getVersion'>,\n  press: Point,\n  ids: readonly string[],\n  scale: { x: number; y: number },\n  reachPx = DEFAULT_SNAP_PX,\n): Point | null {\n  const { ids: owners, index } = sceneSnapIndex(scene);\n  const own = new Set(ids);\n  const hit = findPathSnap(index, press, {\n    radius: reachPx,\n    scale,\n    skip: (i) => {\n      const id = owners[i];\n      return id !== null && !own.has(id);\n    },\n  });\n  return hit ? { x: hit.x, y: hit.y } : null;\n}\n"],"mappings":";;;;;;;;;;;;AAyBA,SAAgB,eAAe,OAA8B,CAAC,GAAe;CAC3E,MAAM,SAAS,KAAK,QAAQ,gBAAA,CAAiB,QAAQ,MAAM,KAAK,QAAQ,OAAO,KAAK;CACpF,OAAO;EACL,IAAI;EACJ,OAAO,CAAC,WAAW,UAAU;EAC7B,GAAI,KAAK,YAAY,SAAY,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;EAC9D,CAAC,QAAQ,GAAG;GACV,IAAI,CAAC,EAAE,OAAO;GACd,MAAM,EAAE,KAAK,UAAU,eAAe,EAAE,OAAO,EAAE,IAAI;GACrD,MAAM,UAAU,IAAI,IAAI,EAAE,OAAO;GACjC,MAAM,UAAU,EAAE,UAAU,IAAI,IAAI,EAAE,OAAO,IAAI;GACjD,MAAM,SAAS,EAAE,WAAW,KAAK,WAAW,EAAE,OAAO;GACrD,MAAM,QAAQ,MAAc;IAC1B,MAAM,KAAK,IAAI;IACf,IAAI,OAAO,MAAM,OAAO;IACxB,OAAO,QAAQ,IAAI,EAAE,MAAM,UAAU,CAAC,QAAQ,IAAI,EAAE,IAAI;GAC1D;GACA,KAAK,MAAM,KAAK,EAAE,QAAQ;IACxB,MAAM,OAAO,cAAc,OAAO,EAAE,IAAI;KAAE;KAAQ;KAAO;KAAM,GAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,IAAI,CAAC;IAAG,CAAC;IAC1G,KAAK,MAAM,KAAK,MAAM;KACpB,MAAM,KAAK;MAAE,GAAG,EAAE;MAAG,GAAG,EAAE;KAAE;KAC5B,MAAM;MACJ,OAAO,EAAE;MACT,OAAO;OAAE;OAAI,MAAM,CAAC;MAAE;MACtB,MAAM;OAAE,MAAM;OAAS;OAAI,OAAO,EAAE;OAAM,OAAO,iBAAiB,EAAE;MAAM;KAC5E;IACF;GACF;EACF;CACF;AACF;;;;AAKA,SAAgB,cACd,OACA,OACA,KACA,OACA,UAAU,iBACI;CACd,MAAM,EAAE,KAAK,QAAQ,UAAU,eAAe,KAAK;CACnD,MAAM,MAAM,IAAI,IAAI,GAAG;CACvB,MAAM,MAAM,aAAa,OAAO,OAAO;EACrC,QAAQ;EACR;EACA,OAAO,MAAM;GACX,MAAM,KAAK,OAAO;GAClB,OAAO,OAAO,QAAQ,CAAC,IAAI,IAAI,EAAE;EACnC;CACF,CAAC;CACD,OAAO,MAAM;EAAE,GAAG,IAAI;EAAG,GAAG,IAAI;CAAE,IAAI;AACxC"}