@lacspace/image 1.0.0 → 1.1.0

package/dist/index.d.cts

@@ -136,6 +136,52 @@ declare function radial(width: number, height: number, opts: RadialGradientOptio
 /** Convenience: a solid surface with a pattern painted over it. */
 declare function pattern(width: number, height: number, base: Color, kind: PatternKind, opts?: PatternOptions): Surface;
 
+/**
+ * Tiny, dependency-free colour parser → RGBA tuple (0..255 each).
+ * Supports: #rgb, #rgba, #rrggbb, #rrggbbaa, rgb()/rgba(), and "transparent".
+ */
+
+type RGBA = [number, number, number, number];
+declare function parseColor(input: Color): RGBA;
+
+/**
+ * Deterministic, no-AI image generators built on Surface:
+ *  - identicon(): a symmetric avatar from any string (GitHub-style)
+ *  - mesh():      a smooth multi-point mesh gradient
+ *  - placeholder(): a tasteful gradient placeholder / LQIP from a seed
+ * All are seeded, so the same input always yields the same image.
+ */
+
+interface IdenticonOptions {
+    size?: number;
+    /** Odd number of cells across (default 5). */
+    grid?: number;
+    background?: Color;
+    /** Force the foreground colour; default derived from the seed. */
+    color?: Color;
+    /** Cell padding fraction (default 0.12 of the size). */
+    padding?: number;
+}
+/** A symmetric identicon avatar from any string. */
+declare function identicon(seed: string, opts?: IdenticonOptions): Surface;
+interface MeshOptions {
+    colors?: Color[];
+    /** Number of colour points (default = colors.length or 5). */
+    points?: number;
+    seed?: string | number;
+}
+/** A smooth multi-point mesh gradient (inverse-distance blend of seeded points). */
+declare function mesh(width: number, height: number, opts?: MeshOptions): Surface;
+interface PlaceholderOptions {
+    seed?: string | number;
+    /** Force the two gradient endpoints instead of deriving from the seed. */
+    colors?: [Color, Color];
+    /** Add a faint dot grid over the gradient (default true). */
+    texture?: boolean;
+}
+/** A tasteful, seeded gradient placeholder (great as an LQIP or empty state). */
+declare function placeholder(width: number, height: number, opts?: PlaceholderOptions): Surface;
+
 /**
  * Unified, isomorphic encode(): pick the best available encoder for the format
  * and runtime. Browser/Worker → native Canvas (all formats). Node → pure-JS PNG
@@ -218,12 +264,4 @@ declare function hasCanvas(): boolean;
 /** True where the platform can actually emit this format via canvas. */
 declare function canvasSupports(format: ImageFormat): Promise<boolean>;
 
-/**
- * Tiny, dependency-free colour parser → RGBA tuple (0..255 each).
- * Supports: #rgb, #rgba, #rrggbb, #rrggbbaa, rgb()/rgba(), and "transparent".
- */
-
-type RGBA = [number, number, number, number];
-declare function parseColor(input: Color): RGBA;
-
-export { type Color, type DrawImageOptions, type EncodeOptions, type EncodeResult, type Fit, type FitOptions, type GradientStop, type ImageFormat, type LinearGradientOptions, type PatternKind, type PatternOptions, type PixelSource, type RGBA, type RadialGradientOptions, type RasterizeSvgOptions, Surface, canvasSupports, encode, encodeJpeg, encodePng, encodePngSync, fit, formatBytes, gradient, hasCanvas, parseColor, parseSize, pattern, radial, rasterizeSvg };
+export { type Color, type DrawImageOptions, type EncodeOptions, type EncodeResult, type Fit, type FitOptions, type GradientStop, type IdenticonOptions, type ImageFormat, type LinearGradientOptions, type MeshOptions, type PatternKind, type PatternOptions, type PixelSource, type PlaceholderOptions, type RGBA, type RadialGradientOptions, type RasterizeSvgOptions, Surface, canvasSupports, encode, encodeJpeg, encodePng, encodePngSync, fit, formatBytes, gradient, hasCanvas, identicon, mesh, parseColor, parseSize, pattern, placeholder, radial, rasterizeSvg };

package/dist/index.d.ts

@@ -136,6 +136,52 @@ declare function radial(width: number, height: number, opts: RadialGradientOptio
 /** Convenience: a solid surface with a pattern painted over it. */
 declare function pattern(width: number, height: number, base: Color, kind: PatternKind, opts?: PatternOptions): Surface;
 
+/**
+ * Tiny, dependency-free colour parser → RGBA tuple (0..255 each).
+ * Supports: #rgb, #rgba, #rrggbb, #rrggbbaa, rgb()/rgba(), and "transparent".
+ */
+
+type RGBA = [number, number, number, number];
+declare function parseColor(input: Color): RGBA;
+
+/**
+ * Deterministic, no-AI image generators built on Surface:
+ *  - identicon(): a symmetric avatar from any string (GitHub-style)
+ *  - mesh():      a smooth multi-point mesh gradient
+ *  - placeholder(): a tasteful gradient placeholder / LQIP from a seed
+ * All are seeded, so the same input always yields the same image.
+ */
+
+interface IdenticonOptions {
+    size?: number;
+    /** Odd number of cells across (default 5). */
+    grid?: number;
+    background?: Color;
+    /** Force the foreground colour; default derived from the seed. */
+    color?: Color;
+    /** Cell padding fraction (default 0.12 of the size). */
+    padding?: number;
+}
+/** A symmetric identicon avatar from any string. */
+declare function identicon(seed: string, opts?: IdenticonOptions): Surface;
+interface MeshOptions {
+    colors?: Color[];
+    /** Number of colour points (default = colors.length or 5). */
+    points?: number;
+    seed?: string | number;
+}
+/** A smooth multi-point mesh gradient (inverse-distance blend of seeded points). */
+declare function mesh(width: number, height: number, opts?: MeshOptions): Surface;
+interface PlaceholderOptions {
+    seed?: string | number;
+    /** Force the two gradient endpoints instead of deriving from the seed. */
+    colors?: [Color, Color];
+    /** Add a faint dot grid over the gradient (default true). */
+    texture?: boolean;
+}
+/** A tasteful, seeded gradient placeholder (great as an LQIP or empty state). */
+declare function placeholder(width: number, height: number, opts?: PlaceholderOptions): Surface;
+
 /**
  * Unified, isomorphic encode(): pick the best available encoder for the format
  * and runtime. Browser/Worker → native Canvas (all formats). Node → pure-JS PNG
@@ -218,12 +264,4 @@ declare function hasCanvas(): boolean;
 /** True where the platform can actually emit this format via canvas. */
 declare function canvasSupports(format: ImageFormat): Promise<boolean>;
 
-/**
- * Tiny, dependency-free colour parser → RGBA tuple (0..255 each).
- * Supports: #rgb, #rgba, #rrggbb, #rrggbbaa, rgb()/rgba(), and "transparent".
- */
-
-type RGBA = [number, number, number, number];
-declare function parseColor(input: Color): RGBA;
-
-export { type Color, type DrawImageOptions, type EncodeOptions, type EncodeResult, type Fit, type FitOptions, type GradientStop, type ImageFormat, type LinearGradientOptions, type PatternKind, type PatternOptions, type PixelSource, type RGBA, type RadialGradientOptions, type RasterizeSvgOptions, Surface, canvasSupports, encode, encodeJpeg, encodePng, encodePngSync, fit, formatBytes, gradient, hasCanvas, parseColor, parseSize, pattern, radial, rasterizeSvg };
+export { type Color, type DrawImageOptions, type EncodeOptions, type EncodeResult, type Fit, type FitOptions, type GradientStop, type IdenticonOptions, type ImageFormat, type LinearGradientOptions, type MeshOptions, type PatternKind, type PatternOptions, type PixelSource, type PlaceholderOptions, type RGBA, type RadialGradientOptions, type RasterizeSvgOptions, Surface, canvasSupports, encode, encodeJpeg, encodePng, encodePngSync, fit, formatBytes, gradient, hasCanvas, identicon, mesh, parseColor, parseSize, pattern, placeholder, radial, rasterizeSvg };

package/dist/index.js

@@ -367,6 +367,119 @@ function pattern(width, height, base, kind, opts) {
   return new Surface(width, height).fill(base).pattern(kind, opts);
 }
 
+// src/generators.ts
+function hash32(str) {
+  let h = 2166136261 >>> 0;
+  for (let i = 0; i < str.length; i++) {
+    h ^= str.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return h >>> 0;
+}
+function rng2(seed) {
+  let s = seed >>> 0 || 1;
+  return () => {
+    s |= 0;
+    s = s + 1831565813 | 0;
+    let t = Math.imul(s ^ s >>> 15, 1 | s);
+    t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
+    return ((t ^ t >>> 14) >>> 0) / 4294967296;
+  };
+}
+function hsl(h, s, l) {
+  h = (h % 360 + 360) % 360;
+  const c = (1 - Math.abs(2 * l - 1)) * s;
+  const x = c * (1 - Math.abs(h / 60 % 2 - 1));
+  const m = l - c / 2;
+  let r = 0, g = 0, b = 0;
+  if (h < 60) [r, g, b] = [c, x, 0];
+  else if (h < 120) [r, g, b] = [x, c, 0];
+  else if (h < 180) [r, g, b] = [0, c, x];
+  else if (h < 240) [r, g, b] = [0, x, c];
+  else if (h < 300) [r, g, b] = [x, 0, c];
+  else [r, g, b] = [c, 0, x];
+  return [Math.round((r + m) * 255), Math.round((g + m) * 255), Math.round((b + m) * 255), 255];
+}
+function identicon(seed, opts = {}) {
+  const size = opts.size ?? 240;
+  const grid = Math.max(3, (opts.grid ?? 5) | 1);
+  const h = hash32(seed);
+  const rand = rng2(h);
+  const fgRgba = hsl(h % 360, 0.62, 0.58);
+  const fg = opts.color ?? `rgb(${fgRgba[0]},${fgRgba[1]},${fgRgba[2]})`;
+  const s = new Surface(size, size).fill(opts.background ?? "#0f1117");
+  const pad = Math.round(size * (opts.padding ?? 0.12));
+  const cell = (size - pad * 2) / grid;
+  const half = Math.ceil(grid / 2);
+  for (let col = 0; col < half; col++) {
+    for (let row = 0; row < grid; row++) {
+      if (rand() > 0.5) {
+        const mirror = grid - 1 - col;
+        const y = pad + row * cell;
+        s.rect(pad + col * cell, y, Math.ceil(cell), Math.ceil(cell), fg);
+        if (mirror !== col) s.rect(pad + mirror * cell, y, Math.ceil(cell), Math.ceil(cell), fg);
+      }
+    }
+  }
+  return s;
+}
+var DEFAULT_MESH = ["#0BB9D9", "#3B82F6", "#7C3AED", "#EC4899", "#22D3EE"];
+function mesh(width, height, opts = {}) {
+  const palette = (opts.colors ?? DEFAULT_MESH).map(parseColor);
+  const n = Math.max(2, opts.points ?? palette.length);
+  const seed = typeof opts.seed === "number" ? opts.seed : hash32(String(opts.seed ?? "mesh"));
+  const rand = rng2(seed);
+  const pts = Array.from({ length: n }, (_, i) => ({
+    x: rand() * width,
+    y: rand() * height,
+    c: palette[i % palette.length]
+  }));
+  const out = new Surface(width, height);
+  const d = out.data;
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      let wr = 0, wg = 0, wb = 0, wsum = 0;
+      for (const p of pts) {
+        const dx = x - p.x;
+        const dy = y - p.y;
+        const w = 1 / (dx * dx + dy * dy + 800);
+        wr += p.c[0] * w;
+        wg += p.c[1] * w;
+        wb += p.c[2] * w;
+        wsum += w;
+      }
+      const i = (y * width + x) * 4;
+      d[i] = wr / wsum;
+      d[i + 1] = wg / wsum;
+      d[i + 2] = wb / wsum;
+      d[i + 3] = 255;
+    }
+  }
+  return out;
+}
+function placeholder(width, height, opts = {}) {
+  const seed = typeof opts.seed === "number" ? opts.seed : hash32(String(opts.seed ?? `${width}x${height}`));
+  const rand = rng2(seed);
+  let from, to;
+  if (opts.colors) {
+    [from, to] = [parseColor(opts.colors[0]), parseColor(opts.colors[1])];
+  } else {
+    const base = Math.floor(rand() * 360);
+    from = hsl(base, 0.55, 0.55);
+    to = hsl(base + 40 + rand() * 60, 0.55, 0.45);
+  }
+  const angle = Math.floor(rand() * 180);
+  const s = new Surface(width, height).linearGradient({
+    angle,
+    stops: [
+      { offset: 0, color: `rgb(${from[0]},${from[1]},${from[2]})` },
+      { offset: 1, color: `rgb(${to[0]},${to[1]},${to[2]})` }
+    ]
+  });
+  if (opts.texture !== false) s.pattern("dots", { size: Math.max(20, Math.round(width / 24)), color: "rgba(255,255,255,0.08)" });
+  return s;
+}
+
 // src/env.ts
 function hasCanvas() {
   if (typeof OffscreenCanvas !== "undefined") return true;
@@ -1577,6 +1690,6 @@ async function rasterizeSvg(svg, opts = {}) {
   return svgToSurfaceNode(svg, opts);
 }
 
-export { Surface, canvasSupports, encode, encodeJpeg, encodePng, encodePngSync, fit, formatBytes, gradient, hasCanvas, parseColor, parseSize, pattern, radial, rasterizeSvg };
+export { Surface, canvasSupports, encode, encodeJpeg, encodePng, encodePngSync, fit, formatBytes, gradient, hasCanvas, identicon, mesh, parseColor, parseSize, pattern, placeholder, radial, rasterizeSvg };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map