@hraness/slopcamera 3.6.0 → 3.8.0

package/apps/desktop/html-overlay/film.ts

@@ -0,0 +1,418 @@
+/**
+ * Motion helpers for HTML launch films.
+ *
+ * Every helper is a pure function of the frame time, or applies such a value
+ * to an element it is handed. A frame callback built on these renders the
+ * same picture whether a frame is requested first, last, twice, or alone,
+ * which is what `slopcamera html render` and `html still` rely on.
+ *
+ * This module has no imports so `slopcamera html init` can copy it into a
+ * film project as a self-contained file. Keep it that way.
+ */
+
+/** The frame record `SlopcameraOverlay.onFrame` passes to each callback. */
+export interface HtmlFilmFrame {
+  /** Zero-based frame index on the absolute render clock. */
+  readonly frame: number;
+  /** Frame time in milliseconds: `frame * 1000 / fps`. */
+  readonly timeMs: number;
+  /** Milliseconds since the previous frame, zero on the first frame. */
+  readonly deltaMs: number;
+  /** `timeMs / durationMs`, capped at 1. */
+  readonly progress: number;
+  readonly width: number;
+  readonly height: number;
+}
+
+/** The page-visible `globalThis.SlopcameraOverlay` API a film uses. */
+export interface HtmlFilmOverlay {
+  onFrame(callback: (frame: HtmlFilmFrame) => void | Promise<void>): void;
+  ready(work: Promise<unknown>): void;
+  asset(name: string): string;
+  readonly parameters?: Readonly<Record<string, unknown>>;
+  readonly width?: number;
+  readonly height?: number;
+}
+
+// ------------------------------------------------------------------ numbers
+
+export const clamp = (value: number, min = 0, max = 1): number => Math.min(max, Math.max(min, value));
+export const lerp = (from: number, to: number, amount: number): number => from + (to - from) * amount;
+/** Progress of `t` through the window `[start, end]`, clamped to 0..1. */
+export function prog(t: number, start: number, end: number): number {
+  if (end <= start) return t >= end ? 1 : 0;
+  return clamp((t - start) / (end - start));
+}
+
+export type Easing = (x: number) => number;
+export const easings = Object.freeze({
+  linear: (x: number) => x,
+  inCubic: (x: number) => x ** 3,
+  outCubic: (x: number) => 1 - (1 - x) ** 3,
+  inOutCubic: (x: number) => (x < 0.5 ? 4 * x ** 3 : 1 - (-2 * x + 2) ** 3 / 2),
+  inQuart: (x: number) => x ** 4,
+  outQuart: (x: number) => 1 - (1 - x) ** 4,
+  inOutQuart: (x: number) => (x < 0.5 ? 8 * x ** 4 : 1 - (-2 * x + 2) ** 4 / 2),
+  outQuint: (x: number) => 1 - (1 - x) ** 5,
+  outExpo: (x: number) => (x >= 1 ? 1 : 1 - 2 ** (-10 * x)),
+  inOutSine: (x: number) => (1 - Math.cos(Math.PI * x)) / 2,
+  outBack: (x: number) => 1 + 2.70158 * (x - 1) ** 3 + 1.70158 * (x - 1) ** 2,
+} satisfies Record<string, Easing>);
+
+/**
+ * A damped spring from 0 to 1. `seconds` is the time since release; before
+ * release it is 0. Lower `damping` overshoots more; 1 or more never overshoots.
+ */
+export function spring(seconds: number, frequency = 1.5, damping = 0.7): number {
+  if (seconds <= 0) return 0;
+  const w = 2 * Math.PI * frequency;
+  if (damping >= 1) return 1 - Math.exp(-w * seconds) * (1 + w * seconds);
+  const wd = w * Math.sqrt(1 - damping * damping);
+  return 1 - Math.exp(-damping * w * seconds) * (Math.cos(wd * seconds) + ((damping * w) / wd) * Math.sin(wd * seconds));
+}
+
+/**
+ * A value that holds, then eases to the next key. Keys are `[atSeconds, value]`
+ * in time order; each change takes `duration` seconds.
+ */
+export function stepValue(keys: readonly (readonly [number, number])[], t: number, duration = 0.5, ease: Easing = easings.inOutCubic): number {
+  if (keys.length === 0) throw new RangeError("stepValue needs at least one key.");
+  let value = keys[0]![1];
+  for (let index = 1; index < keys.length; index++) {
+    const [at, to] = keys[index]!;
+    if (t < at) break;
+    value = lerp(value, to, ease(prog(t, at, at + duration)));
+  }
+  return value;
+}
+
+/** Opacities for a crossfade that starts at `at` and lasts `duration` seconds. */
+export function crossfade(t: number, at: number, duration = 0.6, ease: Easing = easings.inOutCubic): { readonly out: number; readonly in: number } {
+  const amount = ease(prog(t, at, at + duration));
+  return { out: 1 - amount, in: amount };
+}
+
+// ----------------------------------------------------------------- timeline
+
+export interface HtmlFilmActInput {
+  readonly id: string;
+  /** Seconds the act is on screen, including its overlap with the next act. */
+  readonly duration: number;
+  /** Seconds this act starts before the previous one ends, for crossfades. */
+  readonly overlap?: number;
+  /** One short line said in the act, used for WebVTT captions and beats. */
+  readonly caption?: string;
+}
+
+export interface HtmlFilmAct extends HtmlFilmActInput {
+  readonly start: number;
+  readonly end: number;
+}
+
+export interface HtmlFilmTimeline {
+  readonly acts: readonly HtmlFilmAct[];
+  readonly duration: number;
+  act(id: string): HtmlFilmAct;
+  /** Seconds since the act started; negative before it. */
+  local(t: number, id: string): number;
+  /** Progress through the act, 0..1. */
+  progress(t: number, id: string): number;
+  /** True while the act is on screen, widened by `pad` seconds on each side. */
+  active(t: number, id: string, pad?: number): boolean;
+  /** The latest act that has started at `t`. */
+  current(t: number): HtmlFilmAct;
+}
+
+/** Lays acts end to end. Overlaps pull an act earlier so it can crossfade. */
+export function defineTimeline(inputs: readonly HtmlFilmActInput[]): HtmlFilmTimeline {
+  if (inputs.length === 0) throw new RangeError("A timeline needs at least one act.");
+  const seen = new Set<string>();
+  const acts: HtmlFilmAct[] = [];
+  let cursor = 0;
+  for (const input of inputs) {
+    if (seen.has(input.id)) throw new RangeError(`Duplicate act id: ${input.id}`);
+    if (!(input.duration > 0) || !Number.isFinite(input.duration)) throw new RangeError(`Act ${input.id} needs a positive duration.`);
+    const overlap = input.overlap ?? 0;
+    if (overlap < 0 || (acts.length === 0 && overlap > 0) || overlap >= input.duration) throw new RangeError(`Act ${input.id} has an invalid overlap.`);
+    seen.add(input.id);
+    const start = Math.max(0, cursor - overlap);
+    const end = start + input.duration;
+    acts.push(Object.freeze({ ...input, start, end }));
+    cursor = end;
+  }
+  const byId = new Map(acts.map(act => [act.id, act]));
+  const act = (id: string) => {
+    const found = byId.get(id);
+    if (found === undefined) throw new RangeError(`Unknown act: ${id}`);
+    return found;
+  };
+  return Object.freeze({
+    acts: Object.freeze(acts),
+    duration: cursor,
+    act,
+    local: (t: number, id: string) => t - act(id).start,
+    progress: (t: number, id: string) => prog(t, act(id).start, act(id).end),
+    active: (t: number, id: string, pad = 0) => t >= act(id).start - pad && t < act(id).end + pad,
+    current: (t: number) => acts.reduce((found, candidate) => (candidate.start <= t ? candidate : found), acts[0]!),
+  });
+}
+
+function vttTime(seconds: number): string {
+  const ms = Math.round(seconds * 1000);
+  const h = Math.floor(ms / 3_600_000);
+  const m = Math.floor((ms % 3_600_000) / 60_000);
+  const s = Math.floor((ms % 60_000) / 1000);
+  const pad = (value: number, width = 2) => String(value).padStart(width, "0");
+  return `${pad(h)}:${pad(m)}:${pad(s)}.${pad(ms % 1000, 3)}`;
+}
+
+/**
+ * WebVTT captions from each act's `caption`. A cue runs from its act's start
+ * until the next captioned act starts, so overlapping acts never stack cues.
+ */
+export function captionsFromTimeline(timeline: Pick<HtmlFilmTimeline, "acts" | "duration">): string {
+  const captioned = timeline.acts.filter(act => act.caption !== undefined && act.caption.trim() !== "");
+  const cues = captioned.map((act, index) => {
+    const next = captioned[index + 1];
+    const end = next === undefined ? Math.min(act.end, timeline.duration) : Math.min(act.end, next.start);
+    const text = act.caption!.replaceAll("-->", "->").replace(/\s*\n\s*/gu, "\n").trim();
+    return `${act.id}\n${vttTime(act.start)} --> ${vttTime(end)}\n${text}`;
+  });
+  return `WEBVTT\n\n${cues.join("\n\n")}${cues.length === 0 ? "" : "\n"}`;
+}
+
+// ------------------------------------------------------------------ camera
+
+export interface HtmlFilmRect { readonly x: number; readonly y: number; readonly w: number; readonly h: number }
+export interface HtmlFilmCamera { readonly tx: number; readonly ty: number; readonly z: number }
+
+export interface HtmlFilmCameraInput {
+  /** The visible window, for example a browser frame's page area. */
+  readonly viewport: { readonly w: number; readonly h: number };
+  /** The full content that moves inside the window. */
+  readonly content: { readonly w: number; readonly h: number };
+  /** The area to bring into view, in content coordinates. */
+  readonly focus: HtmlFilmRect;
+  /** Zoom; `"fit"` zooms out until the focus plus padding fits. Default 1. */
+  readonly zoom?: number | "fit";
+  /** Where the focus centre lands vertically, 0 top to 1 bottom. Default 0.5. */
+  readonly anchor?: number;
+  readonly padding?: number;
+  /** 0 keeps the resting view, 1 is fully on the focus. */
+  readonly mix?: number;
+}
+
+/**
+ * Where content sits inside a window to frame a focus rectangle, as a
+ * translate and a zoom. It never shows past the content's edges.
+ */
+export function camera(input: HtmlFilmCameraInput): HtmlFilmCamera {
+  const { viewport, content, focus } = input;
+  const padding = input.padding ?? 0;
+  const mix = clamp(input.mix ?? 1);
+  const z = input.zoom === "fit"
+    ? Math.min(1, (viewport.w) / (focus.w + padding * 2), (viewport.h) / (focus.h + padding * 2))
+    : input.zoom ?? 1;
+  const fx = focus.x + focus.w / 2;
+  const fy = focus.y + focus.h / 2;
+  let tx = viewport.w / 2 - fx * z;
+  tx = content.w * z <= viewport.w ? (viewport.w - content.w * z) / 2 : clamp(tx, viewport.w - content.w * z, 0);
+  let ty = viewport.h * (input.anchor ?? 0.5) - fy * z;
+  ty = content.h * z <= viewport.h ? 0 : clamp(ty, viewport.h - content.h * z, 0);
+  const restX = content.w <= viewport.w ? (viewport.w - content.w) / 2 : 0;
+  return { tx: lerp(restX, tx, mix), ty: lerp(0, ty, mix), z: lerp(1, z, mix) };
+}
+
+/** Interpolates two camera positions. */
+export const cameraBetween = (from: HtmlFilmCamera, to: HtmlFilmCamera, amount: number): HtmlFilmCamera => ({
+  tx: lerp(from.tx, to.tx, amount), ty: lerp(from.ty, to.ty, amount), z: lerp(from.z, to.z, amount),
+});
+
+/** The CSS transform for a camera; pair it with `transform-origin: 0 0`. */
+export const cameraTransform = (value: HtmlFilmCamera): string =>
+  `translate3d(${value.tx.toFixed(2)}px, ${value.ty.toFixed(2)}px, 0) scale(${value.z.toFixed(4)})`;
+
+// ------------------------------------------------------------------ cursor
+
+export interface HtmlFilmCursorKey {
+  readonly at: number;
+  readonly x: number;
+  readonly y: number;
+  /** A click that peaks at `at`. */
+  readonly click?: boolean;
+}
+
+export interface HtmlFilmCursorState {
+  readonly x: number;
+  readonly y: number;
+  readonly opacity: number;
+  /** 0..1, peaks at each click. */
+  readonly press: number;
+}
+
+/**
+ * The cursor position at `t`. It glides between keys with an ease, fades in
+ * over `fade` seconds before the first key and out after the last.
+ */
+export function cursor(t: number, keys: readonly HtmlFilmCursorKey[], options: { readonly fade?: number; readonly hold?: number; readonly ease?: Easing } = {}): HtmlFilmCursorState {
+  if (keys.length === 0) throw new RangeError("cursor needs at least one key.");
+  const fade = options.fade ?? 0.25;
+  const hold = options.hold ?? 0.6;
+  const ease = options.ease ?? easings.inOutCubic;
+  const first = keys[0]!;
+  const last = keys[keys.length - 1]!;
+  let x = first.x;
+  let y = first.y;
+  for (let index = 1; index < keys.length; index++) {
+    const from = keys[index - 1]!;
+    const to = keys[index]!;
+    if (t <= from.at) break;
+    const amount = ease(prog(t, from.at, to.at));
+    x = lerp(from.x, to.x, amount);
+    y = lerp(from.y, to.y, amount);
+  }
+  const opacity = prog(t, first.at - fade, first.at) * (1 - prog(t, last.at + hold, last.at + hold + fade));
+  let press = 0;
+  for (const key of keys) if (key.click === true) press = Math.max(press, Math.sin(Math.PI * prog(t, key.at - 0.08, key.at + 0.14)));
+  return { x, y, opacity, press };
+}
+
+// -------------------------------------------------------------- DOM helpers
+
+interface StyleLike {
+  visibility: string;
+  display: string;
+  opacity: string;
+  transform: string;
+  setProperty?(name: string, value: string): void;
+}
+interface StyledLike { readonly style: StyleLike }
+interface AttributeLike { setAttribute(name: string, value: string): void }
+
+/**
+ * Shows or hides an element. It sets both visibility and display: a hidden
+ * parent does not hide children that set `visibility: visible` themselves.
+ */
+export function show(element: StyledLike, on: boolean): void {
+  element.style.visibility = on ? "visible" : "hidden";
+  element.style.display = on ? "" : "none";
+}
+
+/** Places a cursor element from a `cursor()` state. */
+export function placeCursor(element: StyledLike, state: HtmlFilmCursorState): void {
+  element.style.opacity = String(state.opacity);
+  element.style.transform = `translate3d(${state.x.toFixed(2)}px, ${state.y.toFixed(2)}px, 0) scale(${(1 - 0.08 * state.press).toFixed(4)})`;
+  element.style.visibility = state.opacity > 0 ? "visible" : "hidden";
+}
+
+export interface HtmlFilmMark {
+  /** Positioned box the mark fills. */
+  readonly box: StyledLike;
+  readonly svg: AttributeLike;
+  /** A `<rect pathLength="1">` stroked with the mark colour. */
+  readonly rect: AttributeLike & StyledLike & { readonly style: StyleLike & { strokeWidth: string; strokeDasharray: string; strokeDashoffset: string } };
+}
+
+export interface HtmlFilmMarkState extends HtmlFilmRect {
+  readonly radius: number;
+  readonly stroke: number;
+  /** 0..1 of the outline drawn. */
+  readonly drawn: number;
+  readonly opacity: number;
+}
+
+/** Draws a rounded outline around a rectangle, `drawn` of the way round. */
+export function drawMark(mark: HtmlFilmMark, state: HtmlFilmMarkState): void {
+  const { box, svg, rect } = mark;
+  const style = box.style as StyleLike & { left?: string; top?: string; width?: string; height?: string };
+  style.left = `${state.x}px`;
+  style.top = `${state.y}px`;
+  style.width = `${state.w}px`;
+  style.height = `${state.h}px`;
+  style.opacity = String(state.opacity);
+  style.visibility = state.opacity > 0 && state.drawn > 0 ? "visible" : "hidden";
+  svg.setAttribute("viewBox", `0 0 ${state.w} ${state.h}`);
+  const inset = state.stroke / 2;
+  rect.setAttribute("x", String(inset));
+  rect.setAttribute("y", String(inset));
+  rect.setAttribute("width", String(Math.max(0, state.w - state.stroke)));
+  rect.setAttribute("height", String(Math.max(0, state.h - state.stroke)));
+  rect.setAttribute("rx", String(state.radius));
+  rect.style.strokeWidth = `${state.stroke}px`;
+  rect.style.strokeDasharray = "1 1";
+  rect.style.strokeDashoffset = String(1 - clamp(state.drawn));
+}
+
+interface NodeLike { textContent: string | null }
+interface ElementLike extends NodeLike, StyledLike {
+  className: string;
+  append(...nodes: unknown[]): void;
+  readonly ownerDocument: {
+    createElement(tag: string): ElementLike;
+    createTextNode(text: string): unknown;
+  };
+}
+
+const PARTS = new WeakMap<object, readonly StyledLike[]>();
+
+/**
+ * Wraps each word (or character) of an element in a mask span `.w` holding an
+ * inner span `.wi`, for `kin`. A newline in the text becomes a line break.
+ */
+export function split(element: ElementLike, unit: "word" | "char" = "word"): readonly StyledLike[] {
+  const text = element.textContent ?? "";
+  const doc = element.ownerDocument;
+  element.textContent = "";
+  const pieces = unit === "char" ? [...text] : text.split(/(\s+)/u);
+  const parts: ElementLike[] = [];
+  for (const piece of pieces) {
+    if (piece === "") continue;
+    if (/^\s+$/u.test(piece)) {
+      element.append(piece.includes("\n") ? doc.createElement("br") : doc.createTextNode(" "));
+      continue;
+    }
+    const mask = doc.createElement("span");
+    mask.className = "w";
+    const inner = doc.createElement("span");
+    inner.className = "wi";
+    inner.textContent = piece;
+    mask.append(inner);
+    element.append(mask);
+    parts.push(inner);
+  }
+  PARTS.set(element, parts);
+  return parts;
+}
+
+export interface HtmlFilmKinOptions {
+  readonly stagger?: number;
+  readonly duration?: number;
+  readonly outStagger?: number;
+  readonly outDuration?: number;
+  /** Degrees each word starts rotated. */
+  readonly tilt?: number;
+}
+
+/**
+ * Kinetic type: the split words rise into their masks from `inAt` and leave
+ * upward from `outAt`. Returns whether any word is on screen.
+ */
+export function kin(element: StyledLike, t: number, inAt: number, outAt = Infinity, options: HtmlFilmKinOptions = {}): boolean {
+  const parts = PARTS.get(element);
+  if (parts === undefined) throw new Error("kin needs an element prepared with split().");
+  const stagger = options.stagger ?? 0.055;
+  const duration = options.duration ?? 0.9;
+  const outStagger = options.outStagger ?? 0.025;
+  const outDuration = options.outDuration ?? 0.5;
+  let visible = false;
+  parts.forEach((part, index) => {
+    const a = easings.outQuint(prog(t, inAt + index * stagger, inAt + index * stagger + duration));
+    const b = outAt === Infinity ? 0 : easings.inCubic(prog(t, outAt + index * outStagger, outAt + index * outStagger + outDuration));
+    const y = (1 - a) * 115 - b * 115;
+    const r = (1 - a) * (options.tilt ?? 0);
+    part.style.transform = r === 0 ? `translate3d(0, ${y.toFixed(2)}%, 0)` : `translate3d(0, ${y.toFixed(2)}%, 0) rotate(${r.toFixed(2)}deg)`;
+    if (a > 0 && b < 1) visible = true;
+  });
+  element.style.visibility = visible ? "visible" : "hidden";
+  return visible;
+}

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 // @bun
-import{SLOPCAMERA_VERSION,VISUAL_STYLE_PROFILES,artifactSummary,checkDiagramFile,checkDrawingFile,createVisualStyleDirection,getVisualStyleProfile,renderDiagramFile,renderDrawingFile,runMcpServer,starterDrawingSource}from"./index-qxfexvj3.js";import{installSkill,pathExists}from"./index-grk47tgs.js";import"./index-z1kd1x8j.js";import"./index-3cxf2c58.js";import"./index-4z9y2wa2.js";import{executeSlopcameraOperation,generateSlopcameraIcon,generateSlopcameraImageGallery,isSlopcameraOperationCode,parseSlopcameraGalleryVary,searchSlopcameraOperations,slopcameraGalleryKinds,slopcameraGalleryLimits,slopcameraIconMaximumRounds,slopcameraOperationCodes,withSlopcameraOperationHostAdmission}from"./index-fevf4ppk.js";import{vectorizeImage}from"./index-mnp0bftq.js";import{generateSlopcameraImageFile,slopcameraGatewayCredentialStatus,slopcameraImageModels}from"./index-nxtmy18t.js";import"./index-b3geqczn.js";import{__require}from"./index-80a36bc0.js";import{readFile,writeFile}from"fs/promises";import{resolve}from"path";function reportUsefulResult(observer){try{if(observer!==undefined)Promise.resolve(observer()).catch(()=>{return})}catch{}}import{maybeShowSupportInvitation,runSupportCommand,supportAdvancedHelp,supportHelpLine}from"@hraness/support-foundation/node";var slopcameraSupportHelpLine=()=>supportHelpLine({command:["slopcamera"]});var slopcameraSupportAdvancedHelp=()=>supportAdvancedHelp({command:["slopcamera"]});var supportProfile={id:"slopcamera",name:"Slopcamera",valueProposition:"Support ongoing development of local media tools for agents.",updates:false};function standaloneSupportEnvironment(){const env={...process.env};process.env.HRANESS_SUPPORT_AUDIENCE="off";process.env.HRANESS_SUPPORT_EMAIL="off";return env}async function runProductSupportCommand(args,options={}){const result=await runSupportCommand(supportProfile,args,{command:["slopcamera"],...options,gitEmail:false});if(result.stdout!=="")process.stdout.write(result.stdout);if(result.stderr!=="")process.stderr.write(result.stderr);return result.exitCode}async function showProductSupportInvitation(options={}){try{await maybeShowSupportInvitation(supportProfile,{usefulResult:true,command:["slopcamera"],...options,gitEmail:false})}catch{}}var slopcameraCliVersion=SLOPCAMERA_VERSION;var help=()=>`slopcamera ${slopcameraCliVersion}
+import{SLOPCAMERA_VERSION,VISUAL_STYLE_PROFILES,artifactSummary,checkDiagramFile,checkDrawingFile,createVisualStyleDirection,generateSlopcameraIconSet,getVisualStyleProfile,parseSlopcameraIconSetSpec,renderDiagramFile,renderDrawingFile,runMcpServer,slopcameraIconSetMaximumSetRounds,starterDrawingSource}from"./index-k9bjw80z.js";import{installSkill,pathExists}from"./index-grk47tgs.js";import"./index-z1kd1x8j.js";import"./index-3cxf2c58.js";import"./index-842t02pp.js";import{executeSlopcameraOperation,generateSlopcameraIcon,generateSlopcameraImageGallery,isSlopcameraOperationCode,parseSlopcameraGalleryVary,searchSlopcameraOperations,slopcameraGalleryKinds,slopcameraGalleryLimits,slopcameraIconContexts,slopcameraIconMaximumRounds,slopcameraOperationCodes,withSlopcameraOperationHostAdmission}from"./index-y8spxs77.js";import{vectorizeImage}from"./index-mnp0bftq.js";import{generateSlopcameraImageFile,slopcameraGatewayCredentialStatus,slopcameraImageModels}from"./index-p74xy76d.js";import"./index-b3geqczn.js";import{__require}from"./index-80a36bc0.js";import{readFile,writeFile}from"fs/promises";import{dirname,resolve}from"path";function reportUsefulResult(observer){try{if(observer!==undefined)Promise.resolve(observer()).catch(()=>{return})}catch{}}import{maybeShowSupportInvitation,runSupportCommand,supportAdvancedHelp,supportHelpLine}from"@hraness/support-foundation/node";var slopcameraSupportHelpLine=()=>supportHelpLine({command:["slopcamera"]});var slopcameraSupportAdvancedHelp=()=>supportAdvancedHelp({command:["slopcamera"]});var supportProfile={id:"slopcamera",name:"Slopcamera",valueProposition:"Support ongoing development of local media tools for agents.",updates:false};function standaloneSupportEnvironment(){const env={...process.env};process.env.HRANESS_SUPPORT_AUDIENCE="off";process.env.HRANESS_SUPPORT_EMAIL="off";return env}async function runProductSupportCommand(args,options={}){const result=await runSupportCommand(supportProfile,args,{command:["slopcamera"],...options,gitEmail:false});if(result.stdout!=="")process.stdout.write(result.stdout);if(result.stderr!=="")process.stderr.write(result.stderr);return result.exitCode}async function showProductSupportInvitation(options={}){try{await maybeShowSupportInvitation(supportProfile,{usefulResult:true,command:["slopcamera"],...options,gitEmail:false})}catch{}}var slopcameraCliVersion=SLOPCAMERA_VERSION;var help=()=>`slopcamera ${slopcameraCliVersion}
 
 Turn source material into deterministic diagrams, images, and canvas assets.
 
@@ -15,7 +15,11 @@ Usage:
   slopcamera image generate <prompt> --output <file.png|jpg|webp> [--model <provider/model>] [--json]
   slopcamera image icon <subject> --output <file.svg> [--purpose <mark|illustration>]
     [--model <provider/model>] [--ink <#rgb|#rrggbb>] [--rounds <1-${slopcameraIconMaximumRounds}>]
+    [--context <${slopcameraIconContexts.join("|")}>] [--candidates <1-${slopcameraIconMaximumRounds}>]
     [--critique-model <provider/model>] [--keep-raster] [--json]
+  slopcamera image icon --set <file.json> --output-dir <directory>
+    [--context <${slopcameraIconContexts.join("|")}>] [--candidates <1-${slopcameraIconMaximumRounds}>]
+    [--set-rounds <1-${slopcameraIconSetMaximumSetRounds}>] [--keep-raster] [--json]
   slopcamera image gallery <subject> --output-dir <directory> [--kind <${slopcameraGalleryKinds.join("|")}>]
     [--count <1-${slopcameraGalleryLimits.candidates}>] [--vary <axis[=v1,v2][;axis...]>] [--candidates <file.json>]
     [--model <provider/model>] [--cell <${slopcameraGalleryLimits.cellEdgeMin}-${slopcameraGalleryLimits.cellEdgeMax}>] [--tile|--no-tile] [--json]
@@ -59,6 +63,13 @@ vectorizer, and (when --rounds exceeds 1) critiqued by a vision model whose
 feedback revises the prompt for the next attempt. Only Slopcamera's own
 generated output is uploaded for critique \u2014 never user media.
 
+Icon --set reads a bounded JSON manifest ({name?, ink?, context?, members:
+[{slug, subject, purpose?, context?}]}) and generates the whole family at
+once: each member keeps a small candidate pool, joint selection minimizes the
+measured coverage and stroke-weight spread across the set, and a
+contact-sheet critique reviews the family as a unit before SVGs publish.
+Manifests and receipts stay local.
+
 Gallery generates several bounded candidates in parallel and composes them
 into one labelled contact sheet plus a receipt. Use it to review texture,
 skybox, backdrop, sprite, or design alternatives, then promote a chosen
@@ -82,7 +93,7 @@ stdout.
 ${help()}`)}return args}async function main(args,dependencies={}){if(args[0]==="style"){const[action,...words]=args.slice(1);const json=words.at(-1)==="--json";const positionals=json?words.slice(0,-1):words;const log=dependencies.log??console.log;if(action==="list"&&positionals.length===0){log(json?JSON.stringify({schemaVersion:1,styles:VISUAL_STYLE_PROFILES}):["Visual style foundations (authoring guidance; no effects are applied):",...VISUAL_STYLE_PROFILES.map((style)=>`${style.id}  ${style.name}
   ${style.summary}`),"Use slopcamera style show <id> for palette, cadence, materials, delivery, and review criteria."].join(`
 `));return}if(action==="show"&&positionals.length===1&&!positionals[0].startsWith("-")){let style;try{style=getVisualStyleProfile(positionals[0])}catch{throw new Error(`Unknown visual style: ${JSON.stringify(positionals[0].slice(0,128))}. Use slopcamera style list.`)}log(json?JSON.stringify({schemaVersion:1,style}):createVisualStyleDirection(style.id));return}throw new Error("Use slopcamera style list [--json] or slopcamera style show <id> [--json].")}if(args[0]==="diagram"&&args[1]==="sheets"){await runDrawingSheets(args.slice(2),dependencies);return}if(args[0]==="support"){process.exitCode=await runProductSupportCommand(args.slice(1),dependencies.supportEnvironment===undefined?{}:{env:dependencies.supportEnvironment});return}const[command,...rest]=canonicalArguments(args);if(command===undefined||command==="--help"||command==="-h"){console.log(help());return}if(command==="help"){console.log(rest[0]==="advanced"?slopcameraSupportAdvancedHelp():help());return}if(command==="version"||command==="--version"||command==="-v"){console.log(slopcameraCliVersion);return}if(command==="init"){const parsed=parseArguments(rest,new Set);const filePath=resolve(parsed.positionals[0]??"diagram.diagram.json");if(await pathExists(filePath))throw new Error(`Refusing to overwrite existing file: ${filePath}`);await writeFile(filePath,`${JSON.stringify(starter,null,2)}
-`);console.log(`Created ${filePath}`);reportUsefulResult(dependencies.onUsefulResult);return}if(command==="check"){const parsed=parseArguments(rest,new Set(["config"]));const result=await withSlopcameraOperationHostAdmission("slopcamera.diagram.check",async()=>await checkDiagramFile({filePath:requiredPositional(parsed,0,"diagram file"),...parsed.options.config===undefined?{}:{configPath:parsed.options.config}}),hostAdmissionOptions(dependencies));console.log(`Valid diagram${result.configPath===null?"":` with ${result.configPath}`}.`);printFindings(result.findings);if(parsed.flags.has("strict")&&result.findings.length>0)process.exitCode=2;return}if(command==="render"){const parsed=parseArguments(rest,new Set(["out-dir","config","scale"]));const scale=parsed.options.scale===undefined?undefined:Number.parseFloat(parsed.options.scale);const result=await withSlopcameraOperationHostAdmission("slopcamera.diagram.render",async()=>await renderDiagramFile({filePath:requiredPositional(parsed,0,"diagram file"),...parsed.options["out-dir"]===undefined?{}:{outDirectory:parsed.options["out-dir"]},...parsed.options.config===undefined?{}:{configPath:parsed.options.config},...scale===undefined?{}:{scale}}),hostAdmissionOptions(dependencies));console.log(artifactSummary(result.artifacts));printFindings(result.findings);reportUsefulResult(dependencies.onUsefulResult);return}if(command==="vectorize"){const parsed=parseArguments(rest,new Set(["output","duotone","alpha-cutoff","timeout-ms"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json");if(unknownFlags.length>0){throw new Error(`Unknown vectorize option: --${unknownFlags[0]}`)}if(parsed.positionals.length>1){throw new Error("slopcamera image vectorize accepts exactly one raster input")}const output=requiredOption(parsed,"output");if(!output.toLowerCase().endsWith(".svg")){throw new Error("--output must end in .svg")}const alphaCutoff=parsePositiveInteger(parsed.options["alpha-cutoff"],"alpha-cutoff");const timeoutMs=parsePositiveInteger(parsed.options["timeout-ms"],"timeout-ms");const duotone=parseDuotone(parsed.options.duotone);const result=await withSlopcameraOperationHostAdmission("slopcamera.image.vectorize",async(lease)=>await(dependencies.vectorize??vectorizeImage)(requiredPositional(parsed,0,"raster image"),{...alphaCutoff===undefined?{}:{alphaCutoff},...duotone===undefined?{}:{duotone},...timeoutMs===undefined?{}:{limits:{maxDurationMs:timeoutMs}},inheritedFileDescriptors:[lease.inheritedFileDescriptor],outputPath:output}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify({...result.receipt,outputPath:result.outputPath},null,2))}else{(dependencies.log??console.log)(`Vectorized ${result.receipt.width}\xD7${result.receipt.height} with `+`${result.receipt.profile}/${result.receipt.representation}: ${result.outputPath}`)}reportUsefulResult(dependencies.onUsefulResult);return}if(command==="generate"){const parsed=parseArguments(rest,new Set(["model","output"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json");if(unknownFlags.length>0){throw new Error(`Unknown generate option: --${unknownFlags[0]}`)}if(parsed.positionals.length!==1){throw new Error("slopcamera image generate accepts exactly one prompt")}const model=parsed.options.model??slopcameraImageModels[1];if(model.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(model)){throw new Error("--model must be a bounded Vercel AI Gateway provider/model id")}const result=await withSlopcameraOperationHostAdmission("slopcamera.image.generate",async()=>await(dependencies.generate??generateSlopcameraImageFile)({model,prompt:requiredPositional(parsed,0,"prompt"),outputPath:requiredOption(parsed,"output")}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify(result,null,2))}else{(dependencies.log??console.log)(`Generated ${result.mediaType} with ${result.model}: ${result.outputPath} (${result.bytes} bytes, request ${result.requestId})`)}reportUsefulResult(dependencies.onUsefulResult);return}if(command==="icon"){const parsed=parseArguments(rest,new Set(["model","output","ink","purpose","rounds","critique-model"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json"&&flag!=="keep-raster");if(unknownFlags.length>0){throw new Error(`Unknown icon option: --${unknownFlags[0]}`)}if(parsed.positionals.length!==1){throw new Error("slopcamera image icon accepts exactly one subject")}const output=requiredOption(parsed,"output");if(!output.toLowerCase().endsWith(".svg")){throw new Error("--output must end in .svg")}const model=parsed.options.model??slopcameraImageModels[1];if(model.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(model)){throw new Error("--model must be a bounded Vercel AI Gateway provider/model id")}const critiqueModel=parsed.options["critique-model"];if(critiqueModel!==undefined&&(critiqueModel.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(critiqueModel))){throw new Error("--critique-model must be a bounded Vercel AI Gateway provider/model id")}const ink=parsed.options.ink;if(ink!==undefined&&!/^#[a-f0-9]{3}(?:[a-f0-9]{3})?$/iu.test(ink)){throw new Error("--ink must be a #rgb or #rrggbb color")}const purpose=parsed.options.purpose;if(purpose!==undefined&&purpose!=="mark"&&purpose!=="illustration"){throw new Error("--purpose must be mark or illustration")}const rounds=parsePositiveInteger(parsed.options.rounds,"rounds");if(rounds!==undefined&&rounds>slopcameraIconMaximumRounds){throw new Error(`--rounds must be at most ${slopcameraIconMaximumRounds}`)}const result=await withSlopcameraOperationHostAdmission("slopcamera.image.icon",async(lease)=>await(dependencies.icon??generateSlopcameraIcon)({keepRaster:parsed.flags.has("keep-raster"),model,outputPath:output,subject:requiredPositional(parsed,0,"subject"),inheritedFileDescriptors:[lease.inheritedFileDescriptor],...critiqueModel===undefined?{}:{critiqueModel},...ink===undefined?{}:{ink},...purpose===undefined?{}:{purpose},...rounds===undefined?{}:{rounds}}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify(result,null,2))}else{const scored=result.attempts.map((attempt)=>attempt.score===undefined?`#${attempt.round}`:`#${attempt.round}=${attempt.score}`).join(" ");(dependencies.log??console.log)(`Icon ${result.svgSha256.slice(0,12)} round ${result.selectedRound}/${result.attempts.length} (${scored}): ${result.outputPath}`)}return}if(command==="gallery"){const parsed=parseArguments(rest,new Set(["model","output-dir","kind","count","vary","candidates","cell","timeout-ms"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json"&&flag!=="tile"&&flag!=="no-tile");if(unknownFlags.length>0){throw new Error(`Unknown gallery option: --${unknownFlags[0]}`)}if(parsed.flags.has("tile")&&parsed.flags.has("no-tile")){throw new Error("--tile and --no-tile are mutually exclusive")}if(parsed.positionals.length!==1){throw new Error("slopcamera image gallery accepts exactly one subject")}const model=parsed.options.model??slopcameraImageModels[1];if(model.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(model)){throw new Error("--model must be a bounded Vercel AI Gateway provider/model id")}const kind=parsed.options.kind;if(kind!==undefined&&!slopcameraGalleryKinds.includes(kind)){throw new Error(`--kind must be one of: ${slopcameraGalleryKinds.join(", ")}`)}const count=parsePositiveInteger(parsed.options.count,"count");if(count!==undefined&&count>slopcameraGalleryLimits.candidates){throw new Error(`--count must be at most ${slopcameraGalleryLimits.candidates}`)}const cell=parsePositiveInteger(parsed.options.cell,"cell");if(cell!==undefined&&(cell<slopcameraGalleryLimits.cellEdgeMin||cell>slopcameraGalleryLimits.cellEdgeMax)){throw new Error(`--cell must be between ${slopcameraGalleryLimits.cellEdgeMin} and ${slopcameraGalleryLimits.cellEdgeMax}`)}const timeoutMs=parsePositiveInteger(parsed.options["timeout-ms"],"timeout-ms");const vary=parseGalleryVary(parsed.options.vary);const candidates=parsed.options.candidates===undefined?undefined:await readGalleryCandidates(parsed.options.candidates);if(candidates!==undefined&&!Array.isArray(candidates)){throw new Error("--candidates JSON must be an array of {id, prompt|variant} entries")}const result=await withSlopcameraOperationHostAdmission("slopcamera.image.gallery",async()=>await(dependencies.gallery??generateSlopcameraImageGallery)({subject:requiredPositional(parsed,0,"subject"),outputDir:requiredOption(parsed,"output-dir"),model,...kind===undefined?{}:{kind},...count===undefined?{}:{count},...vary===undefined?{}:{vary},...candidates===undefined?{}:{candidates},...cell===undefined?{}:{cellEdge:cell},...timeoutMs===undefined?{}:{timeoutMs},...parsed.flags.has("tile")?{tiled:true}:parsed.flags.has("no-tile")?{tiled:false}:{}}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify(result,null,2))}else{const rows=result.candidates.map((candidate)=>candidate.status==="generated"?`#${candidate.index} ${candidate.id}	${candidate.path}`:`#${candidate.index} ${candidate.id}	failed`);(dependencies.log??console.log)(`Gallery ${result.counts.generated}/${result.counts.requested} generated (${result.model}): ${result.gallery.path}
+`);console.log(`Created ${filePath}`);reportUsefulResult(dependencies.onUsefulResult);return}if(command==="check"){const parsed=parseArguments(rest,new Set(["config"]));const result=await withSlopcameraOperationHostAdmission("slopcamera.diagram.check",async()=>await checkDiagramFile({filePath:requiredPositional(parsed,0,"diagram file"),...parsed.options.config===undefined?{}:{configPath:parsed.options.config}}),hostAdmissionOptions(dependencies));console.log(`Valid diagram${result.configPath===null?"":` with ${result.configPath}`}.`);printFindings(result.findings);if(parsed.flags.has("strict")&&result.findings.length>0)process.exitCode=2;return}if(command==="render"){const parsed=parseArguments(rest,new Set(["out-dir","config","scale"]));const scale=parsed.options.scale===undefined?undefined:Number.parseFloat(parsed.options.scale);const result=await withSlopcameraOperationHostAdmission("slopcamera.diagram.render",async()=>await renderDiagramFile({filePath:requiredPositional(parsed,0,"diagram file"),...parsed.options["out-dir"]===undefined?{}:{outDirectory:parsed.options["out-dir"]},...parsed.options.config===undefined?{}:{configPath:parsed.options.config},...scale===undefined?{}:{scale}}),hostAdmissionOptions(dependencies));console.log(artifactSummary(result.artifacts));printFindings(result.findings);reportUsefulResult(dependencies.onUsefulResult);return}if(command==="vectorize"){const parsed=parseArguments(rest,new Set(["output","duotone","alpha-cutoff","timeout-ms"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json");if(unknownFlags.length>0){throw new Error(`Unknown vectorize option: --${unknownFlags[0]}`)}if(parsed.positionals.length>1){throw new Error("slopcamera image vectorize accepts exactly one raster input")}const output=requiredOption(parsed,"output");if(!output.toLowerCase().endsWith(".svg")){throw new Error("--output must end in .svg")}const alphaCutoff=parsePositiveInteger(parsed.options["alpha-cutoff"],"alpha-cutoff");const timeoutMs=parsePositiveInteger(parsed.options["timeout-ms"],"timeout-ms");const duotone=parseDuotone(parsed.options.duotone);const result=await withSlopcameraOperationHostAdmission("slopcamera.image.vectorize",async(lease)=>await(dependencies.vectorize??vectorizeImage)(requiredPositional(parsed,0,"raster image"),{...alphaCutoff===undefined?{}:{alphaCutoff},...duotone===undefined?{}:{duotone},...timeoutMs===undefined?{}:{limits:{maxDurationMs:timeoutMs}},inheritedFileDescriptors:[lease.inheritedFileDescriptor],outputPath:output}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify({...result.receipt,outputPath:result.outputPath},null,2))}else{(dependencies.log??console.log)(`Vectorized ${result.receipt.width}\xD7${result.receipt.height} with `+`${result.receipt.profile}/${result.receipt.representation}: ${result.outputPath}`)}reportUsefulResult(dependencies.onUsefulResult);return}if(command==="generate"){const parsed=parseArguments(rest,new Set(["model","output"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json");if(unknownFlags.length>0){throw new Error(`Unknown generate option: --${unknownFlags[0]}`)}if(parsed.positionals.length!==1){throw new Error("slopcamera image generate accepts exactly one prompt")}const model=parsed.options.model??slopcameraImageModels[1];if(model.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(model)){throw new Error("--model must be a bounded Vercel AI Gateway provider/model id")}const result=await withSlopcameraOperationHostAdmission("slopcamera.image.generate",async()=>await(dependencies.generate??generateSlopcameraImageFile)({model,prompt:requiredPositional(parsed,0,"prompt"),outputPath:requiredOption(parsed,"output")}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify(result,null,2))}else{(dependencies.log??console.log)(`Generated ${result.mediaType} with ${result.model}: ${result.outputPath} (${result.bytes} bytes, request ${result.requestId})`)}reportUsefulResult(dependencies.onUsefulResult);return}if(command==="icon"){const parsed=parseArguments(rest,new Set(["model","output","output-dir","ink","purpose","rounds","critique-model","context","candidates","set","set-rounds"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json"&&flag!=="keep-raster");if(unknownFlags.length>0){throw new Error(`Unknown icon option: --${unknownFlags[0]}`)}const model=parsed.options.model??slopcameraImageModels[1];if(model.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(model)){throw new Error("--model must be a bounded Vercel AI Gateway provider/model id")}const critiqueModel=parsed.options["critique-model"];if(critiqueModel!==undefined&&(critiqueModel.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(critiqueModel))){throw new Error("--critique-model must be a bounded Vercel AI Gateway provider/model id")}const ink=parsed.options.ink;if(ink!==undefined&&!/^#[a-f0-9]{3}(?:[a-f0-9]{3})?$/iu.test(ink)){throw new Error("--ink must be a #rgb or #rrggbb color")}const purpose=parsed.options.purpose;if(purpose!==undefined&&purpose!=="mark"&&purpose!=="illustration"){throw new Error("--purpose must be mark or illustration")}const context=parsed.options.context;if(context!==undefined&&!slopcameraIconContexts.includes(context)){throw new Error(`--context must be one of: ${slopcameraIconContexts.join(", ")}`)}const rounds=parsePositiveInteger(parsed.options.rounds,"rounds");if(rounds!==undefined&&rounds>slopcameraIconMaximumRounds){throw new Error(`--rounds must be at most ${slopcameraIconMaximumRounds}`)}const candidates=parsePositiveInteger(parsed.options.candidates,"candidates");if(candidates!==undefined&&candidates>slopcameraIconMaximumRounds){throw new Error(`--candidates must be at most ${slopcameraIconMaximumRounds}`)}const setRounds=parsePositiveInteger(parsed.options["set-rounds"],"set-rounds");if(setRounds!==undefined&&setRounds>slopcameraIconSetMaximumSetRounds){throw new Error(`--set-rounds must be at most ${slopcameraIconSetMaximumSetRounds}`)}if(parsed.options.set!==undefined){if(parsed.positionals.length!==0){throw new Error("slopcamera image icon --set takes no subject positional")}if(parsed.options.output!==undefined){throw new Error("--output cannot be combined with --set; use --output-dir")}const outputDir=requiredOption(parsed,"output-dir");const manifestPath=parsed.options.set;let manifestText;try{manifestText=await readFile(manifestPath,"utf8")}catch{throw new Error(`--set manifest could not be read: ${manifestPath}`)}if(Buffer.byteLength(manifestText,"utf8")>256*1024){throw new Error("--set manifest exceeds the 256 KiB bound")}let manifestJson;try{manifestJson=JSON.parse(manifestText)}catch{throw new Error("--set manifest must be valid JSON")}const spec=parseSlopcameraIconSetSpec(manifestJson);const result2=await withSlopcameraOperationHostAdmission("slopcamera.image.icon",async(lease)=>await(dependencies.iconSet??generateSlopcameraIconSet)({keepRaster:parsed.flags.has("keep-raster"),manifestDir:dirname(resolve(manifestPath)),model,outputDir,spec,inheritedFileDescriptors:[lease.inheritedFileDescriptor],...critiqueModel===undefined?{}:{critiqueModel},...ink===undefined?{}:{ink},...context===undefined?{}:{context},...purpose===undefined?{}:{purpose},...rounds===undefined?{}:{rounds},...candidates===undefined?{}:{candidatesPerMember:candidates},...setRounds===undefined?{}:{setRounds}}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify(result2,null,2))}else{(dependencies.log??console.log)(`Icon set ${result2.name??"icon-set"}: ${result2.members.length} members to ${result2.outputDir} `+`(target coverage ${result2.target.coverageRatio.toFixed(3)}, `+`stroke ${result2.target.strokePx.toFixed(1)}px, ${result2.setRoundsUsed} set rounds)`)}reportUsefulResult(dependencies.onUsefulResult);return}if(parsed.positionals.length!==1){throw new Error("slopcamera image icon accepts exactly one subject")}const output=requiredOption(parsed,"output");if(!output.toLowerCase().endsWith(".svg")){throw new Error("--output must end in .svg")}const result=await withSlopcameraOperationHostAdmission("slopcamera.image.icon",async(lease)=>await(dependencies.icon??generateSlopcameraIcon)({keepRaster:parsed.flags.has("keep-raster"),model,outputPath:output,subject:requiredPositional(parsed,0,"subject"),inheritedFileDescriptors:[lease.inheritedFileDescriptor],...critiqueModel===undefined?{}:{critiqueModel},...ink===undefined?{}:{ink},...purpose===undefined?{}:{purpose},...rounds===undefined?{}:{rounds},...context===undefined?{}:{context},...candidates===undefined?{}:{candidatePool:candidates}}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify(result,null,2))}else{const scored=result.attempts.map((attempt)=>attempt.score===undefined?`#${attempt.round}`:`#${attempt.round}=${attempt.score}`).join(" ");(dependencies.log??console.log)(`Icon ${result.svgSha256.slice(0,12)} round ${result.selectedRound}/${result.attempts.length} (${scored}): ${result.outputPath}`)}return}if(command==="gallery"){const parsed=parseArguments(rest,new Set(["model","output-dir","kind","count","vary","candidates","cell","timeout-ms"]));const unknownFlags=[...parsed.flags].filter((flag)=>flag!=="json"&&flag!=="tile"&&flag!=="no-tile");if(unknownFlags.length>0){throw new Error(`Unknown gallery option: --${unknownFlags[0]}`)}if(parsed.flags.has("tile")&&parsed.flags.has("no-tile")){throw new Error("--tile and --no-tile are mutually exclusive")}if(parsed.positionals.length!==1){throw new Error("slopcamera image gallery accepts exactly one subject")}const model=parsed.options.model??slopcameraImageModels[1];if(model.length>256||!/^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:-]*$/iu.test(model)){throw new Error("--model must be a bounded Vercel AI Gateway provider/model id")}const kind=parsed.options.kind;if(kind!==undefined&&!slopcameraGalleryKinds.includes(kind)){throw new Error(`--kind must be one of: ${slopcameraGalleryKinds.join(", ")}`)}const count=parsePositiveInteger(parsed.options.count,"count");if(count!==undefined&&count>slopcameraGalleryLimits.candidates){throw new Error(`--count must be at most ${slopcameraGalleryLimits.candidates}`)}const cell=parsePositiveInteger(parsed.options.cell,"cell");if(cell!==undefined&&(cell<slopcameraGalleryLimits.cellEdgeMin||cell>slopcameraGalleryLimits.cellEdgeMax)){throw new Error(`--cell must be between ${slopcameraGalleryLimits.cellEdgeMin} and ${slopcameraGalleryLimits.cellEdgeMax}`)}const timeoutMs=parsePositiveInteger(parsed.options["timeout-ms"],"timeout-ms");const vary=parseGalleryVary(parsed.options.vary);const candidates=parsed.options.candidates===undefined?undefined:await readGalleryCandidates(parsed.options.candidates);if(candidates!==undefined&&!Array.isArray(candidates)){throw new Error("--candidates JSON must be an array of {id, prompt|variant} entries")}const result=await withSlopcameraOperationHostAdmission("slopcamera.image.gallery",async()=>await(dependencies.gallery??generateSlopcameraImageGallery)({subject:requiredPositional(parsed,0,"subject"),outputDir:requiredOption(parsed,"output-dir"),model,...kind===undefined?{}:{kind},...count===undefined?{}:{count},...vary===undefined?{}:{vary},...candidates===undefined?{}:{candidates},...cell===undefined?{}:{cellEdge:cell},...timeoutMs===undefined?{}:{timeoutMs},...parsed.flags.has("tile")?{tiled:true}:parsed.flags.has("no-tile")?{tiled:false}:{}}),hostAdmissionOptions(dependencies));if(parsed.flags.has("json")){(dependencies.log??console.log)(JSON.stringify(result,null,2))}else{const rows=result.candidates.map((candidate)=>candidate.status==="generated"?`#${candidate.index} ${candidate.id}	${candidate.path}`:`#${candidate.index} ${candidate.id}	failed`);(dependencies.log??console.log)(`Gallery ${result.counts.generated}/${result.counts.requested} generated (${result.model}): ${result.gallery.path}
 `+`${rows.join(`
 `)}
 receipt ${result.receiptPath}`)}reportUsefulResult(dependencies.onUsefulResult);return}if(command==="code"){const[subcommand,...subcommandArgs]=rest;if(subcommand==="search"){const parsed=parseArguments(subcommandArgs,new Set(["limit"]));if(parsed.flags.size>0||parsed.positionals.length>1){throw new Error("Use slopcamera code search [query] [--limit <number>]")}const limit=parsePositiveInteger(parsed.options.limit,"limit")??slopcameraOperationCodes.length;const operations=searchSlopcameraOperations(parsed.positionals[0]??"",limit);console.log(JSON.stringify({operations},null,2));return}if(subcommand==="execute"){const parsed=parseArguments(subcommandArgs,new Set(["input"]));if(parsed.flags.size>0||parsed.positionals.length!==1){throw new Error("Use slopcamera code execute <operation> --input <JSON>")}const requestedOperation=parsed.positionals[0];const operation=isSlopcameraOperationCode(requestedOperation)?requestedOperation:undefined;if(operation===undefined){throw new Error(`Unknown Slopcamera operation code: ${requestedOperation}`)}const inputText=requiredOption(parsed,"input");if(Buffer.byteLength(inputText,"utf8")>64*1024){throw new Error("--input JSON must be no more than 65536 UTF-8 bytes")}let input;try{input=JSON.parse(inputText)}catch{throw new Error("--input must be valid JSON")}const result=await executeSlopcameraOperation(operation,input,{...hostAdmissionOptions(dependencies)});(dependencies.log??console.log)(JSON.stringify({operation,result},null,2));if(operation==="slopcamera.diagram.render"||operation==="slopcamera.image.vectorize"||operation==="slopcamera.image.generate"){reportUsefulResult(dependencies.onUsefulResult)}return}throw new Error("Use slopcamera code search [query] or slopcamera code execute <operation> --input <JSON>")}if(command==="mcp"){const parsed=parseArguments(rest,new Set(["root"]));if(parsed.positionals.length>0||parsed.flags.size>0){throw new Error("slopcamera mcp accepts only --root <workspace>")}await runMcpServer({rootDirectory:requiredOption(parsed,"root"),serverVersion:slopcameraCliVersion});return}if(command==="doctor"){console.log(`slopcamera ${slopcameraCliVersion}`);console.log(`Bun ${process.versions.bun??"not detected"}`);console.log("Headless diagram SVG/PNG/tldraw renderer ready");console.log(process.platform==="win32"?"Local raster-to-SVG vectorizer unavailable on Windows (fails closed with tool_platform)":"Local raster-to-SVG vectorizer ready without authentication (VTracer downloads on first use)");console.log("Root-relative MCP check/render/scene server ready (trusted local workspace)");const gateway=slopcameraGatewayCredentialStatus();console.log(gateway.available?`Vercel AI Gateway ready via ${gateway.source}`:"Vercel AI Gateway requires AI_GATEWAY_API_KEY or VERCEL_OIDC_TOKEN");return}if(command==="skill"){const[subcommand,...subcommandArgs]=rest;if(subcommand==="path"){const{bundledSkillPath}=await import("./skill-install-gx7afxsd.js");console.log(bundledSkillPath());return}if(subcommand==="install"){const parsed=parseArguments(subcommandArgs,new Set(["target","scope","project"]));const target=parsed.options.target??"codex";const scope=parsed.options.scope??"user";if(!["codex","claude","agents"].includes(target)){throw new Error("--target must be codex, claude, or agents")}if(!["user","project"].includes(scope)){throw new Error("--scope must be user or project")}const destination=await installSkill({target,scope,...parsed.options.project===undefined?{}:{projectDirectory:parsed.options.project},force:parsed.flags.has("force")});console.log(`Installed slopcamera skill at ${destination}`);return}throw new Error("Use slopcamera skill path or install")}throw new Error(`Unknown command: ${command}

package/dist/generate.js

@@ -1,2 +1,2 @@
 // @bun
-import{createFixedGatewayFetch,generateSlopcameraImage,generateSlopcameraImageFile,resolveSlopcameraGatewayCredential,slopcameraGatewayApiBaseUrl,slopcameraGatewayCredentialStatus,slopcameraImageModels,slopcameraMaximumPromptBytes,slopcameraMaximumRawImageBytes,slopcameraResponseMediaTypes}from"./index-nxtmy18t.js";import"./index-80a36bc0.js";export{slopcameraResponseMediaTypes,slopcameraMaximumRawImageBytes,slopcameraMaximumPromptBytes,slopcameraImageModels,slopcameraGatewayCredentialStatus,slopcameraGatewayApiBaseUrl,resolveSlopcameraGatewayCredential,generateSlopcameraImageFile,generateSlopcameraImage,createFixedGatewayFetch};
+import{createFixedGatewayFetch,generateSlopcameraImage,generateSlopcameraImageFile,resolveSlopcameraGatewayCredential,slopcameraGatewayApiBaseUrl,slopcameraGatewayCredentialStatus,slopcameraImageModels,slopcameraMaximumPromptBytes,slopcameraMaximumRawImageBytes,slopcameraResponseMediaTypes}from"./index-p74xy76d.js";import"./index-80a36bc0.js";export{slopcameraResponseMediaTypes,slopcameraMaximumRawImageBytes,slopcameraMaximumPromptBytes,slopcameraImageModels,slopcameraGatewayCredentialStatus,slopcameraGatewayApiBaseUrl,resolveSlopcameraGatewayCredential,generateSlopcameraImageFile,generateSlopcameraImage,createFixedGatewayFetch};

package/dist/{index-4z9y2wa2.js → index-842t02pp.js}

@@ -1,3 +1,3 @@
 // @bun
-import{executeSlopcameraOperationWithLease,isSlopcameraOperationCode,parseSlopcameraOperationInput,slopcameraOperationHostResourceClaims}from"./index-fevf4ppk.js";import{createDefaultHostResourceCoordinator}from"./index-b3geqczn.js";var workflowIdPattern=/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/u;var workflowStepIdPattern=/^[A-Za-z0-9]+(?:[._:-][A-Za-z0-9]+)*$/u;var defaultMaximumSteps=64;var hardMaximumSteps=256;class SlopcameraWorkflowError extends Error{code;completedSteps;failedStep;constructor(code,message,options={}){super(`[${code}] ${message}`,{cause:options.cause});this.name="SlopcameraWorkflowError";this.code=code;this.completedSteps=Object.freeze([...options.completedSteps??[]].sort((left,right)=>left.index-right.index));if(options.failedStep!==undefined){this.failedStep=Object.freeze({...options.failedStep})}}}function workflowError(code,message){throw new SlopcameraWorkflowError(code,message)}function validateWorkflowId(id){if(typeof id!=="string"||id.length<1||id.length>80||!workflowIdPattern.test(id)){workflowError("INVALID_WORKFLOW","Workflow id must be 1 through 80 lowercase letters, numbers, dots, underscores, or hyphens.")}}function validateStepId(id,completedSteps=[]){if(typeof id!=="string"||id.length<1||id.length>80||!workflowStepIdPattern.test(id)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP","Step id must be 1 through 80 letters, numbers, dots, underscores, colons, or hyphens.",{completedSteps})}}function defineSlopcameraWorkflow(options){if(typeof options!=="object"||options===null){workflowError("INVALID_WORKFLOW","Workflow definition must be an object.")}validateWorkflowId(options.id);if(!Number.isSafeInteger(options.version)||options.version<1){workflowError("INVALID_WORKFLOW","Workflow version must be a positive safe integer.")}if(typeof options.parseInput!=="function"||typeof options.run!=="function"){workflowError("INVALID_WORKFLOW","Workflow definition requires parseInput and run functions.")}return Object.freeze({id:options.id,version:options.version,parseInput:options.parseInput,run:options.run})}function maximumSteps(value){const resolved=value??defaultMaximumSteps;if(!Number.isSafeInteger(resolved)||resolved<1||resolved>hardMaximumSteps){workflowError("INVALID_WORKFLOW",`maximumSteps must be an integer from 1 through ${hardMaximumSteps}.`)}return resolved}function aborted(completedSteps,cause){return new SlopcameraWorkflowError("WORKFLOW_ABORTED","Workflow execution was aborted.",{cause,completedSteps})}async function runSlopcameraWorkflow(definition,value,options={}){const normalized=defineSlopcameraWorkflow(definition);const limit=maximumSteps(options.maximumSteps);const signal=options.signal??options.dependencies?.signal??new AbortController().signal;const invoked=new Set;const completed=[];const dispatched=[];let acceptingOperations=true;let nextIndex=0;if(signal.aborted)throw aborted(completed);let input;try{input=normalized.parseInput(value)}catch(cause){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_INPUT","Workflow input did not satisfy its parser.",{cause})}const executor=options.executor??((code,operationInput,context2)=>executeSlopcameraOperationWithLease(code,operationInput,context2.hostResourceLease,options.dependencies));const hostResourceCoordinator=options.hostResourceCoordinator??options.dependencies?.hostResourceCoordinator??createDefaultHostResourceCoordinator();const waitTimeoutMilliseconds=options.waitTimeoutMilliseconds??options.dependencies?.waitTimeoutMilliseconds;async function dispatchOperation(id,code,operationInput){if(signal.aborted)throw aborted(completed);validateStepId(id,completed);if(!isSlopcameraOperationCode(code)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow step ${id} names an unknown Slopcamera operation.`,{completedSteps:completed})}if(invoked.has(id)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Duplicate workflow step id: ${id}.`,{completedSteps:completed})}if(nextIndex>=limit){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow exceeds its ${String(limit)}-step limit.`,{completedSteps:completed})}const index=nextIndex;nextIndex+=1;invoked.add(id);let normalizedInput;try{normalizedInput=parseSlopcameraOperationInput(code,operationInput)}catch(cause){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow step ${id} has invalid input for ${code}.`,{cause,completedSteps:completed})}try{const result=await hostResourceCoordinator.withLease(slopcameraOperationHostResourceClaims(code),async(hostResourceLease)=>await executor(code,normalizedInput,{hostResourceLease,signal,stepId:id}),{signal,...waitTimeoutMilliseconds===undefined?{}:{waitTimeoutMilliseconds}});completed.push(Object.freeze({id,index,operation:code}));if(signal.aborted)throw aborted(completed);return result}catch(cause){if(cause instanceof SlopcameraWorkflowError&&cause.code==="WORKFLOW_ABORTED"){throw cause}if(signal.aborted)throw aborted(completed,cause);throw new SlopcameraWorkflowError("WORKFLOW_STEP_FAILED",`Workflow step ${id} (${code}) failed.`,{cause,completedSteps:completed,failedStep:{id,operation:code}})}}const context=Object.freeze({signal,operation(id,code,operationInput){if(!acceptingOperations){const closed=Promise.reject(new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP","Workflow operations cannot start after authored workflow code has settled.",{completedSteps:completed}));closed.catch(()=>{return});return closed}const operation=dispatchOperation(id,code,operationInput);dispatched.push(operation);operation.catch(()=>{return});return operation}});let output;let runFailed=false;let runFailure;try{output=await normalized.run(context,input)}catch(cause){runFailed=true;runFailure=cause}finally{acceptingOperations=false}const operationResults=await Promise.allSettled(dispatched);if(signal.aborted)throw aborted(completed,runFailed?runFailure:undefined);if(runFailed){if(runFailure instanceof SlopcameraWorkflowError)throw runFailure;throw new SlopcameraWorkflowError("WORKFLOW_FAILED",`Workflow ${normalized.id} failed in authored code.`,{cause:runFailure,completedSteps:completed})}const operationFailure=operationResults.find((result)=>result.status==="rejected");if(operationFailure!==undefined){const cause=operationFailure.reason;if(cause instanceof SlopcameraWorkflowError)throw cause;throw new SlopcameraWorkflowError("WORKFLOW_STEP_FAILED","A dispatched workflow operation failed.",{cause,completedSteps:completed})}return Object.freeze({workflow:Object.freeze({id:normalized.id,version:normalized.version}),output,steps:Object.freeze([...completed].sort((left,right)=>left.index-right.index))})}
+import{executeSlopcameraOperationWithLease,isSlopcameraOperationCode,parseSlopcameraOperationInput,slopcameraOperationHostResourceClaims}from"./index-y8spxs77.js";import{createDefaultHostResourceCoordinator}from"./index-b3geqczn.js";var workflowIdPattern=/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/u;var workflowStepIdPattern=/^[A-Za-z0-9]+(?:[._:-][A-Za-z0-9]+)*$/u;var defaultMaximumSteps=64;var hardMaximumSteps=256;class SlopcameraWorkflowError extends Error{code;completedSteps;failedStep;constructor(code,message,options={}){super(`[${code}] ${message}`,{cause:options.cause});this.name="SlopcameraWorkflowError";this.code=code;this.completedSteps=Object.freeze([...options.completedSteps??[]].sort((left,right)=>left.index-right.index));if(options.failedStep!==undefined){this.failedStep=Object.freeze({...options.failedStep})}}}function workflowError(code,message){throw new SlopcameraWorkflowError(code,message)}function validateWorkflowId(id){if(typeof id!=="string"||id.length<1||id.length>80||!workflowIdPattern.test(id)){workflowError("INVALID_WORKFLOW","Workflow id must be 1 through 80 lowercase letters, numbers, dots, underscores, or hyphens.")}}function validateStepId(id,completedSteps=[]){if(typeof id!=="string"||id.length<1||id.length>80||!workflowStepIdPattern.test(id)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP","Step id must be 1 through 80 letters, numbers, dots, underscores, colons, or hyphens.",{completedSteps})}}function defineSlopcameraWorkflow(options){if(typeof options!=="object"||options===null){workflowError("INVALID_WORKFLOW","Workflow definition must be an object.")}validateWorkflowId(options.id);if(!Number.isSafeInteger(options.version)||options.version<1){workflowError("INVALID_WORKFLOW","Workflow version must be a positive safe integer.")}if(typeof options.parseInput!=="function"||typeof options.run!=="function"){workflowError("INVALID_WORKFLOW","Workflow definition requires parseInput and run functions.")}return Object.freeze({id:options.id,version:options.version,parseInput:options.parseInput,run:options.run})}function maximumSteps(value){const resolved=value??defaultMaximumSteps;if(!Number.isSafeInteger(resolved)||resolved<1||resolved>hardMaximumSteps){workflowError("INVALID_WORKFLOW",`maximumSteps must be an integer from 1 through ${hardMaximumSteps}.`)}return resolved}function aborted(completedSteps,cause){return new SlopcameraWorkflowError("WORKFLOW_ABORTED","Workflow execution was aborted.",{cause,completedSteps})}async function runSlopcameraWorkflow(definition,value,options={}){const normalized=defineSlopcameraWorkflow(definition);const limit=maximumSteps(options.maximumSteps);const signal=options.signal??options.dependencies?.signal??new AbortController().signal;const invoked=new Set;const completed=[];const dispatched=[];let acceptingOperations=true;let nextIndex=0;if(signal.aborted)throw aborted(completed);let input;try{input=normalized.parseInput(value)}catch(cause){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_INPUT","Workflow input did not satisfy its parser.",{cause})}const executor=options.executor??((code,operationInput,context2)=>executeSlopcameraOperationWithLease(code,operationInput,context2.hostResourceLease,options.dependencies));const hostResourceCoordinator=options.hostResourceCoordinator??options.dependencies?.hostResourceCoordinator??createDefaultHostResourceCoordinator();const waitTimeoutMilliseconds=options.waitTimeoutMilliseconds??options.dependencies?.waitTimeoutMilliseconds;async function dispatchOperation(id,code,operationInput){if(signal.aborted)throw aborted(completed);validateStepId(id,completed);if(!isSlopcameraOperationCode(code)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow step ${id} names an unknown Slopcamera operation.`,{completedSteps:completed})}if(invoked.has(id)){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Duplicate workflow step id: ${id}.`,{completedSteps:completed})}if(nextIndex>=limit){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow exceeds its ${String(limit)}-step limit.`,{completedSteps:completed})}const index=nextIndex;nextIndex+=1;invoked.add(id);let normalizedInput;try{normalizedInput=parseSlopcameraOperationInput(code,operationInput)}catch(cause){throw new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP",`Workflow step ${id} has invalid input for ${code}.`,{cause,completedSteps:completed})}try{const result=await hostResourceCoordinator.withLease(slopcameraOperationHostResourceClaims(code),async(hostResourceLease)=>await executor(code,normalizedInput,{hostResourceLease,signal,stepId:id}),{signal,...waitTimeoutMilliseconds===undefined?{}:{waitTimeoutMilliseconds}});completed.push(Object.freeze({id,index,operation:code}));if(signal.aborted)throw aborted(completed);return result}catch(cause){if(cause instanceof SlopcameraWorkflowError&&cause.code==="WORKFLOW_ABORTED"){throw cause}if(signal.aborted)throw aborted(completed,cause);throw new SlopcameraWorkflowError("WORKFLOW_STEP_FAILED",`Workflow step ${id} (${code}) failed.`,{cause,completedSteps:completed,failedStep:{id,operation:code}})}}const context=Object.freeze({signal,operation(id,code,operationInput){if(!acceptingOperations){const closed=Promise.reject(new SlopcameraWorkflowError("INVALID_WORKFLOW_STEP","Workflow operations cannot start after authored workflow code has settled.",{completedSteps:completed}));closed.catch(()=>{return});return closed}const operation=dispatchOperation(id,code,operationInput);dispatched.push(operation);operation.catch(()=>{return});return operation}});let output;let runFailed=false;let runFailure;try{output=await normalized.run(context,input)}catch(cause){runFailed=true;runFailure=cause}finally{acceptingOperations=false}const operationResults=await Promise.allSettled(dispatched);if(signal.aborted)throw aborted(completed,runFailed?runFailure:undefined);if(runFailed){if(runFailure instanceof SlopcameraWorkflowError)throw runFailure;throw new SlopcameraWorkflowError("WORKFLOW_FAILED",`Workflow ${normalized.id} failed in authored code.`,{cause:runFailure,completedSteps:completed})}const operationFailure=operationResults.find((result)=>result.status==="rejected");if(operationFailure!==undefined){const cause=operationFailure.reason;if(cause instanceof SlopcameraWorkflowError)throw cause;throw new SlopcameraWorkflowError("WORKFLOW_STEP_FAILED","A dispatched workflow operation failed.",{cause,completedSteps:completed})}return Object.freeze({workflow:Object.freeze({id:normalized.id,version:normalized.version}),output,steps:Object.freeze([...completed].sort((left,right)=>left.index-right.index))})}
 export{SlopcameraWorkflowError,defineSlopcameraWorkflow,runSlopcameraWorkflow};