@dumiflex/wp-kit 0.3.0 → 0.4.0

package/src/floating.ts

@@ -1,99 +1,99 @@
-/**
- * Where a floating panel (popover, menu, tooltip) goes next to its anchor:
- * on the preferred side when it fits, on the other side when it doesn't,
- * and always kept inside the viewport. Pure maths, no DOM, so it is the
- * same on the canvas and in the manager. `Popover`, `ContextMenu` and the
- * tooltip directive all place themselves through it.
- */
-
-export type Side = "top" | "bottom" | "left" | "right";
-export type Align = "start" | "center" | "end";
-export type Placement = Side | `${Side}-${Exclude<Align, "center">}`;
-
-export interface Rect {
-  left: number;
-  top: number;
-  width: number;
-  height: number;
-}
-
-export interface Size {
-  width: number;
-  height: number;
-}
-
-export interface PlaceOptions {
-  placement?: Placement;
-  /** Space between the anchor and the panel. */
-  gap?: number;
-  /** Space the panel keeps from the viewport edge. */
-  margin?: number;
-}
-
-export interface Placed {
-  x: number;
-  y: number;
-  /** The side it ended up on, after any flip. */
-  side: Side;
-}
-
-const OPPOSITE: Record<Side, Side> = { top: "bottom", bottom: "top", left: "right", right: "left" };
-
-export function splitPlacement(p: Placement): { side: Side; align: Align } {
-  const [side, align] = p.split("-") as [Side, Exclude<Align, "center"> | undefined];
-  return { side, align: align ?? "center" };
-}
-
-function room(side: Side, a: Rect, view: Size, gap: number, margin: number): number {
-  switch (side) {
-    case "top": return a.top - gap - margin;
-    case "bottom": return view.height - (a.top + a.height) - gap - margin;
-    case "left": return a.left - gap - margin;
-    case "right": return view.width - (a.left + a.width) - gap - margin;
-  }
-}
-
-function clamp(v: number, min: number, max: number): number {
-  return max < min ? min : Math.min(Math.max(v, min), max);
-}
-
-export function placeFloating(anchor: Rect, panel: Size, view: Size, opts: PlaceOptions = {}): Placed {
-  const gap = opts.gap ?? 6;
-  const margin = opts.margin ?? 8;
-  const { side: want, align } = splitPlacement(opts.placement ?? "bottom-start");
-  const vertical = want === "top" || want === "bottom";
-  const need = vertical ? panel.height : panel.width;
-
-  // Flip only when the other side has more room; a panel too big for both
-  // stays on the side with more space and gets clamped.
-  let side = want;
-  if (room(want, anchor, view, gap, margin) < need) {
-    const other = OPPOSITE[want];
-    if (room(other, anchor, view, gap, margin) > room(want, anchor, view, gap, margin)) side = other;
-  }
-
-  let x: number;
-  let y: number;
-  if (vertical) {
-    y = side === "bottom" ? anchor.top + anchor.height + gap : anchor.top - gap - panel.height;
-    x = align === "start" ? anchor.left
-      : align === "end" ? anchor.left + anchor.width - panel.width
-      : anchor.left + (anchor.width - panel.width) / 2;
-  } else {
-    x = side === "right" ? anchor.left + anchor.width + gap : anchor.left - gap - panel.width;
-    y = align === "start" ? anchor.top
-      : align === "end" ? anchor.top + anchor.height - panel.height
-      : anchor.top + (anchor.height - panel.height) / 2;
-  }
-
-  return {
-    x: Math.round(clamp(x, margin, view.width - margin - panel.width)),
-    y: Math.round(clamp(y, margin, view.height - margin - panel.height)),
-    side,
-  };
-}
-
-/** The viewport, for callers that have a window. */
-export function viewportSize(): Size {
-  return { width: window.innerWidth, height: window.innerHeight };
-}
+/**
+ * Where a floating panel (popover, menu, tooltip) goes next to its anchor:
+ * on the preferred side when it fits, on the other side when it doesn't,
+ * and always kept inside the viewport. Pure maths, no DOM, so it is the
+ * same on the canvas and in the manager. `Popover`, `ContextMenu` and the
+ * tooltip directive all place themselves through it.
+ */
+
+export type Side = "top" | "bottom" | "left" | "right";
+export type Align = "start" | "center" | "end";
+export type Placement = Side | `${Side}-${Exclude<Align, "center">}`;
+
+export interface Rect {
+  left: number;
+  top: number;
+  width: number;
+  height: number;
+}
+
+export interface Size {
+  width: number;
+  height: number;
+}
+
+export interface PlaceOptions {
+  placement?: Placement;
+  /** Space between the anchor and the panel. */
+  gap?: number;
+  /** Space the panel keeps from the viewport edge. */
+  margin?: number;
+}
+
+export interface Placed {
+  x: number;
+  y: number;
+  /** The side it ended up on, after any flip. */
+  side: Side;
+}
+
+const OPPOSITE: Record<Side, Side> = { top: "bottom", bottom: "top", left: "right", right: "left" };
+
+export function splitPlacement(p: Placement): { side: Side; align: Align } {
+  const [side, align] = p.split("-") as [Side, Exclude<Align, "center"> | undefined];
+  return { side, align: align ?? "center" };
+}
+
+function room(side: Side, a: Rect, view: Size, gap: number, margin: number): number {
+  switch (side) {
+    case "top": return a.top - gap - margin;
+    case "bottom": return view.height - (a.top + a.height) - gap - margin;
+    case "left": return a.left - gap - margin;
+    case "right": return view.width - (a.left + a.width) - gap - margin;
+  }
+}
+
+function clamp(v: number, min: number, max: number): number {
+  return max < min ? min : Math.min(Math.max(v, min), max);
+}
+
+export function placeFloating(anchor: Rect, panel: Size, view: Size, opts: PlaceOptions = {}): Placed {
+  const gap = opts.gap ?? 6;
+  const margin = opts.margin ?? 8;
+  const { side: want, align } = splitPlacement(opts.placement ?? "bottom-start");
+  const vertical = want === "top" || want === "bottom";
+  const need = vertical ? panel.height : panel.width;
+
+  // Flip only when the other side has more room; a panel too big for both
+  // stays on the side with more space and gets clamped.
+  let side = want;
+  if (room(want, anchor, view, gap, margin) < need) {
+    const other = OPPOSITE[want];
+    if (room(other, anchor, view, gap, margin) > room(want, anchor, view, gap, margin)) side = other;
+  }
+
+  let x: number;
+  let y: number;
+  if (vertical) {
+    y = side === "bottom" ? anchor.top + anchor.height + gap : anchor.top - gap - panel.height;
+    x = align === "start" ? anchor.left
+      : align === "end" ? anchor.left + anchor.width - panel.width
+      : anchor.left + (anchor.width - panel.width) / 2;
+  } else {
+    x = side === "right" ? anchor.left + anchor.width + gap : anchor.left - gap - panel.width;
+    y = align === "start" ? anchor.top
+      : align === "end" ? anchor.top + anchor.height - panel.height
+      : anchor.top + (anchor.height - panel.height) / 2;
+  }
+
+  return {
+    x: Math.round(clamp(x, margin, view.width - margin - panel.width)),
+    y: Math.round(clamp(y, margin, view.height - margin - panel.height)),
+    side,
+  };
+}
+
+/** The viewport, for callers that have a window. */
+export function viewportSize(): Size {
+  return { width: window.innerWidth, height: window.innerHeight };
+}

package/src/hsv.ts

@@ -1,100 +1,100 @@
-/**
- * HSV / RGB / hex color conversion utilities.
- *
- * `h` in `[0, 360)`, `s` and `v` in `[0, 1]`. Hex strings are `#rrggbb`
- * lowercase. Functions are tolerant of out-of-range input — they clamp
- * rather than throw, which keeps the picker UI robust under fast drags.
- *
- * Lives in shared/ so both the manager-side ColorPicker / TweaksPanel
- * AND the canvas-side bundle modal can drive the same HsvPicker
- * without a cross-package import.
- */
-
-export interface Hsv {
-  h: number;
-  s: number;
-  v: number;
-}
-
-export interface Rgb {
-  r: number;
-  g: number;
-  b: number;
-}
-
-const HEX_PATTERN = /^#?([0-9a-fA-F]{6})$/;
-
-function clamp(n: number, lo: number, hi: number): number {
-  if (Number.isNaN(n)) return lo;
-  return Math.min(hi, Math.max(lo, n));
-}
-
-export function hsvToRgb(hsv: Hsv): Rgb {
-  const H = (((hsv.h % 360) + 360) % 360);
-  const S = clamp(hsv.s, 0, 1);
-  const V = clamp(hsv.v, 0, 1);
-
-  const C = V * S;
-  const X = C * (1 - Math.abs(((H / 60) % 2) - 1));
-  const M = V - C;
-  let r1 = 0;
-  let g1 = 0;
-  let b1 = 0;
-  if (H < 60)        { r1 = C; g1 = X; b1 = 0; }
-  else if (H < 120)  { r1 = X; g1 = C; b1 = 0; }
-  else if (H < 180)  { r1 = 0; g1 = C; b1 = X; }
-  else if (H < 240)  { r1 = 0; g1 = X; b1 = C; }
-  else if (H < 300)  { r1 = X; g1 = 0; b1 = C; }
-  else               { r1 = C; g1 = 0; b1 = X; }
-  return {
-    r: Math.round((r1 + M) * 255),
-    g: Math.round((g1 + M) * 255),
-    b: Math.round((b1 + M) * 255),
-  };
-}
-
-export function rgbToHsv(rgb: Rgb): Hsv {
-  const R = clamp(rgb.r, 0, 255) / 255;
-  const G = clamp(rgb.g, 0, 255) / 255;
-  const B = clamp(rgb.b, 0, 255) / 255;
-  const max = Math.max(R, G, B);
-  const min = Math.min(R, G, B);
-  const delta = max - min;
-
-  let h = 0;
-  if (delta > 0) {
-    if (max === R)      h = ((G - B) / delta) % 6;
-    else if (max === G) h = (B - R) / delta + 2;
-    else                h = (R - G) / delta + 4;
-    h *= 60;
-    if (h < 0) h += 360;
-  }
-  const s = max === 0 ? 0 : delta / max;
-  const v = max;
-  return { h, s, v };
-}
-
-export function rgbToHex(rgb: Rgb): string {
-  const part = (n: number): string => clamp(Math.round(n), 0, 255).toString(16).padStart(2, "0");
-  return `#${part(rgb.r)}${part(rgb.g)}${part(rgb.b)}`;
-}
-
-export function hexToRgb(hex: string): Rgb | null {
-  const matches = hex.trim().match(HEX_PATTERN);
-  if (!matches) return null;
-  const v = matches[1];
-  return {
-    r: parseInt(v.slice(0, 2), 16),
-    g: parseInt(v.slice(2, 4), 16),
-    b: parseInt(v.slice(4, 6), 16),
-  };
-}
-
-export function hexToHsv(hex: string): Hsv | null {
-  const rgb = hexToRgb(hex);
-  return rgb ? rgbToHsv(rgb) : null;
-}
-
-export function hsvToHex(hsv: Hsv): string {
-  return rgbToHex(hsvToRgb(hsv));
-}
+/**
+ * HSV / RGB / hex color conversion utilities.
+ *
+ * `h` in `[0, 360)`, `s` and `v` in `[0, 1]`. Hex strings are `#rrggbb`
+ * lowercase. Functions are tolerant of out-of-range input — they clamp
+ * rather than throw, which keeps the picker UI robust under fast drags.
+ *
+ * Lives in shared/ so both the manager-side ColorPicker / TweaksPanel
+ * AND the canvas-side bundle modal can drive the same HsvPicker
+ * without a cross-package import.
+ */
+
+export interface Hsv {
+  h: number;
+  s: number;
+  v: number;
+}
+
+export interface Rgb {
+  r: number;
+  g: number;
+  b: number;
+}
+
+const HEX_PATTERN = /^#?([0-9a-fA-F]{6})$/;
+
+function clamp(n: number, lo: number, hi: number): number {
+  if (Number.isNaN(n)) return lo;
+  return Math.min(hi, Math.max(lo, n));
+}
+
+export function hsvToRgb(hsv: Hsv): Rgb {
+  const H = (((hsv.h % 360) + 360) % 360);
+  const S = clamp(hsv.s, 0, 1);
+  const V = clamp(hsv.v, 0, 1);
+
+  const C = V * S;
+  const X = C * (1 - Math.abs(((H / 60) % 2) - 1));
+  const M = V - C;
+  let r1 = 0;
+  let g1 = 0;
+  let b1 = 0;
+  if (H < 60)        { r1 = C; g1 = X; b1 = 0; }
+  else if (H < 120)  { r1 = X; g1 = C; b1 = 0; }
+  else if (H < 180)  { r1 = 0; g1 = C; b1 = X; }
+  else if (H < 240)  { r1 = 0; g1 = X; b1 = C; }
+  else if (H < 300)  { r1 = X; g1 = 0; b1 = C; }
+  else               { r1 = C; g1 = 0; b1 = X; }
+  return {
+    r: Math.round((r1 + M) * 255),
+    g: Math.round((g1 + M) * 255),
+    b: Math.round((b1 + M) * 255),
+  };
+}
+
+export function rgbToHsv(rgb: Rgb): Hsv {
+  const R = clamp(rgb.r, 0, 255) / 255;
+  const G = clamp(rgb.g, 0, 255) / 255;
+  const B = clamp(rgb.b, 0, 255) / 255;
+  const max = Math.max(R, G, B);
+  const min = Math.min(R, G, B);
+  const delta = max - min;
+
+  let h = 0;
+  if (delta > 0) {
+    if (max === R)      h = ((G - B) / delta) % 6;
+    else if (max === G) h = (B - R) / delta + 2;
+    else                h = (R - G) / delta + 4;
+    h *= 60;
+    if (h < 0) h += 360;
+  }
+  const s = max === 0 ? 0 : delta / max;
+  const v = max;
+  return { h, s, v };
+}
+
+export function rgbToHex(rgb: Rgb): string {
+  const part = (n: number): string => clamp(Math.round(n), 0, 255).toString(16).padStart(2, "0");
+  return `#${part(rgb.r)}${part(rgb.g)}${part(rgb.b)}`;
+}
+
+export function hexToRgb(hex: string): Rgb | null {
+  const matches = hex.trim().match(HEX_PATTERN);
+  if (!matches) return null;
+  const v = matches[1];
+  return {
+    r: parseInt(v.slice(0, 2), 16),
+    g: parseInt(v.slice(2, 4), 16),
+    b: parseInt(v.slice(4, 6), 16),
+  };
+}
+
+export function hexToHsv(hex: string): Hsv | null {
+  const rgb = hexToRgb(hex);
+  return rgb ? rgbToHsv(rgb) : null;
+}
+
+export function hsvToHex(hsv: Hsv): string {
+  return rgbToHex(hsvToRgb(hsv));
+}

package/src/icon-catalog.ts

@@ -1,52 +1,52 @@
-/**
- * Curated PrimeIcons glyphs offered by `IconPicker.vue`.
- *
- * PrimeIcons ships ~314 glyphs; this is a subset. The full set would need its
- * own search UI, and most of it (chevrons, spinners, media transport, brand
- * logos) means nothing as a library label. The groups below follow the kinds
- * of things people actually categorise prompt modules by.
- *
- * Names are PrimeIcons ids MINUS the `pi-` prefix (`"user"`, not `"pi-user"`)
- * — that is what the engine's `icon` column holds and what `Icon.vue` expects.
- *
- * In a plain module rather than inside the SFC so `icon-catalog.test.ts` can
- * check every name against the installed `primeicons.css` without mounting a
- * component. That test is the point: a name with no matching glyph renders as
- * an EMPTY CELL, which looks like a layout bug rather than a typo, and `brush`
- * shipped that way because nothing verified the list.
- */
-export interface IconGroup {
-  label: string;
-  icons: string[];
-}
-
-export const ICON_GROUPS: IconGroup[] = [
-  {
-    label: "Subject",
-    icons: ["user", "users", "heart", "star", "eye", "face-smile", "crown", "id-card"],
-  },
-  {
-    // `sliders-h` stands in for the art-supply glyph PrimeIcons doesn't have —
-    // there is no brush/paint icon in the set, and `palette` already carries
-    // "art style". Sliders read as "tune the look".
-    label: "Style & look",
-    icons: ["palette", "pencil", "sliders-h", "camera", "image", "sparkles", "sun", "moon"],
-  },
-  {
-    label: "Scene",
-    icons: ["home", "building", "map", "map-marker", "globe", "compass", "car", "cloud"],
-  },
-  {
-    label: "Structure",
-    icons: ["box", "folder", "book", "tag", "tags", "list", "sitemap", "objects-column"],
-  },
-  {
-    label: "Signals",
-    icons: ["bolt", "flag", "bell", "shield", "lock", "wrench", "filter", "info-circle"],
-  },
-];
-
-/** Every offered glyph, flattened — for tests and any future search box. */
-export function allCuratedIcons(): string[] {
-  return ICON_GROUPS.flatMap((g) => g.icons);
-}
+/**
+ * Curated PrimeIcons glyphs offered by `IconPicker.vue`.
+ *
+ * PrimeIcons ships ~314 glyphs; this is a subset. The full set would need its
+ * own search UI, and most of it (chevrons, spinners, media transport, brand
+ * logos) means nothing as a library label. The groups below follow the kinds
+ * of things people actually categorise prompt modules by.
+ *
+ * Names are PrimeIcons ids MINUS the `pi-` prefix (`"user"`, not `"pi-user"`)
+ * — that is what the engine's `icon` column holds and what `Icon.vue` expects.
+ *
+ * In a plain module rather than inside the SFC so `icon-catalog.test.ts` can
+ * check every name against the installed `primeicons.css` without mounting a
+ * component. That test is the point: a name with no matching glyph renders as
+ * an EMPTY CELL, which looks like a layout bug rather than a typo, and `brush`
+ * shipped that way because nothing verified the list.
+ */
+export interface IconGroup {
+  label: string;
+  icons: string[];
+}
+
+export const ICON_GROUPS: IconGroup[] = [
+  {
+    label: "Subject",
+    icons: ["user", "users", "heart", "star", "eye", "face-smile", "crown", "id-card"],
+  },
+  {
+    // `sliders-h` stands in for the art-supply glyph PrimeIcons doesn't have —
+    // there is no brush/paint icon in the set, and `palette` already carries
+    // "art style". Sliders read as "tune the look".
+    label: "Style & look",
+    icons: ["palette", "pencil", "sliders-h", "camera", "image", "sparkles", "sun", "moon"],
+  },
+  {
+    label: "Scene",
+    icons: ["home", "building", "map", "map-marker", "globe", "compass", "car", "cloud"],
+  },
+  {
+    label: "Structure",
+    icons: ["box", "folder", "book", "tag", "tags", "list", "sitemap", "objects-column"],
+  },
+  {
+    label: "Signals",
+    icons: ["bolt", "flag", "bell", "shield", "lock", "wrench", "filter", "info-circle"],
+  },
+];
+
+/** Every offered glyph, flattened — for tests and any future search box. */
+export function allCuratedIcons(): string[] {
+  return ICON_GROUPS.flatMap((g) => g.icons);
+}