@5even7/dlc-ui 0.2.18 → 0.2.20

package/dist/chunks/color-DnmNceaf.mjs

@@ -0,0 +1,350 @@
+/**
+ * Color helpers. `normalizeColor` converts any supported CSS color
+ * (hex / named / rgb() / rgba() / hsl() / hsla()) into a 6-digit hex string,
+ * so renderers can keep working with #rrggbb only. rgba()/hsla() alpha is
+ * intentionally dropped: the WebGL shader has no per-color alpha channel, and
+ * the component is opaque by design — use component-level `opacity` for
+ * transparency.
+ *
+ * `normalizeColorWithAlpha` keeps the alpha channel: it returns a 6-digit hex
+ * when alpha is 1, an 8-digit #rrggbbaa hex when alpha < 1, and the literal
+ * string 'transparent' for `transparent`. Use it for renderers (e.g. SVG)
+ * that can represent per-color transparency.
+ */
+
+const NAMED_COLORS = {
+  aliceblue: '#f0f8ff',
+  antiquewhite: '#faebd7',
+  aqua: '#00ffff',
+  aquamarine: '#7fffd4',
+  azure: '#f0ffff',
+  beige: '#f5f5dc',
+  bisque: '#ffe4c4',
+  black: '#000000',
+  blanchedalmond: '#ffebcd',
+  blue: '#0000ff',
+  blueviolet: '#8a2be2',
+  brown: '#a52a2a',
+  burlywood: '#deb887',
+  cadetblue: '#5f9ea0',
+  chartreuse: '#7fff00',
+  chocolate: '#d2691e',
+  coral: '#ff7f50',
+  cornflowerblue: '#6495ed',
+  cornsilk: '#fff8dc',
+  crimson: '#dc143c',
+  cyan: '#00ffff',
+  darkblue: '#00008b',
+  darkcyan: '#008b8b',
+  darkgoldenrod: '#b8860b',
+  darkgray: '#a9a9a9',
+  darkgreen: '#006400',
+  darkgrey: '#a9a9a9',
+  darkkhaki: '#bdb76b',
+  darkmagenta: '#8b008b',
+  darkolivegreen: '#556b2f',
+  darkorange: '#ff8c00',
+  darkorchid: '#9932cc',
+  darkred: '#8b0000',
+  darksalmon: '#e9967a',
+  darkseagreen: '#8fbc8f',
+  darkslateblue: '#483d8b',
+  darkslategray: '#2f4f4f',
+  darkslategrey: '#2f4f4f',
+  darkturquoise: '#00ced1',
+  darkviolet: '#9400d3',
+  deeppink: '#ff1493',
+  deepskyblue: '#00bfff',
+  dimgray: '#696969',
+  dimgrey: '#696969',
+  dodgerblue: '#1e90ff',
+  firebrick: '#b22222',
+  floralwhite: '#fffaf0',
+  forestgreen: '#228b22',
+  fuchsia: '#ff00ff',
+  gainsboro: '#dcdcdc',
+  ghostwhite: '#f8f8ff',
+  gold: '#ffd700',
+  goldenrod: '#daa520',
+  gray: '#808080',
+  green: '#008000',
+  greenyellow: '#adff2f',
+  grey: '#808080',
+  honeydew: '#f0fff0',
+  hotpink: '#ff69b4',
+  indianred: '#cd5c5c',
+  indigo: '#4b0082',
+  ivory: '#fffff0',
+  khaki: '#f0e68c',
+  lavender: '#e6e6fa',
+  lavenderblush: '#fff0f5',
+  lawngreen: '#7cfc00',
+  lemonchiffon: '#fffacd',
+  lightblue: '#add8e6',
+  lightcoral: '#f08080',
+  lightcyan: '#e0ffff',
+  lightgoldenrodyellow: '#fafad2',
+  lightgray: '#d3d3d3',
+  lightgreen: '#90ee90',
+  lightgrey: '#d3d3d3',
+  lightpink: '#ffb6c1',
+  lightsalmon: '#ffa07a',
+  lightseagreen: '#20b2aa',
+  lightskyblue: '#87cefa',
+  lightslategray: '#778899',
+  lightslategrey: '#778899',
+  lightsteelblue: '#b0c4de',
+  lightyellow: '#ffffe0',
+  lime: '#00ff00',
+  limegreen: '#32cd32',
+  linen: '#faf0e6',
+  magenta: '#ff00ff',
+  maroon: '#800000',
+  mediumaquamarine: '#66cdaa',
+  mediumblue: '#0000cd',
+  mediumorchid: '#ba55d3',
+  mediumpurple: '#9370db',
+  mediumseagreen: '#3cb371',
+  mediumslateblue: '#7b68ee',
+  mediumspringgreen: '#00fa9a',
+  mediumturquoise: '#48d1cc',
+  mediumvioletred: '#c71585',
+  midnightblue: '#191970',
+  mintcream: '#f5fffa',
+  mistyrose: '#ffe4e1',
+  moccasin: '#ffe4b5',
+  navajowhite: '#ffdead',
+  navy: '#000080',
+  oldlace: '#fdf5e6',
+  olive: '#808000',
+  olivedrab: '#6b8e23',
+  orange: '#ffa500',
+  orangered: '#ff4500',
+  orchid: '#da70d6',
+  palegoldenrod: '#eee8aa',
+  palegreen: '#98fb98',
+  paleturquoise: '#afeeee',
+  palevioletred: '#db7093',
+  papayawhip: '#ffefd5',
+  peachpuff: '#ffdab9',
+  peru: '#cd853f',
+  pink: '#ffc0cb',
+  plum: '#dda0dd',
+  powderblue: '#b0e0e6',
+  purple: '#800080',
+  rebeccapurple: '#663399',
+  red: '#ff0000',
+  rosybrown: '#bc8f8f',
+  royalblue: '#4169e1',
+  saddlebrown: '#8b4513',
+  salmon: '#fa8072',
+  sandybrown: '#f4a460',
+  seagreen: '#2e8b57',
+  seashell: '#fff5ee',
+  sienna: '#a0522d',
+  silver: '#c0c0c0',
+  skyblue: '#87ceeb',
+  slateblue: '#6a5acd',
+  slategray: '#708090',
+  slategrey: '#708090',
+  snow: '#fffafa',
+  springgreen: '#00ff7f',
+  steelblue: '#4682b4',
+  tan: '#d2b48c',
+  teal: '#008080',
+  thistle: '#d8bfd8',
+  tomato: '#ff6347',
+  turquoise: '#40e0d0',
+  violet: '#ee82ee',
+  wheat: '#f5deb3',
+  white: '#ffffff',
+  whitesmoke: '#f5f5f5',
+  yellow: '#ffff00',
+  yellowgreen: '#9acd32'
+};
+
+function clampChannel(value) {
+  return Math.min(255, Math.max(0, Math.round(value)));
+}
+
+function clampUnit(value) {
+  return Math.min(1, Math.max(0, value));
+}
+
+function hexPair(value) {
+  const text = clampChannel(value).toString(16);
+  return text.length === 1 ? `0${text}` : text;
+}
+
+/**
+ * Parse the argument list of rgb()/rgba()/hsl()/hsla() (comma syntax or
+ * modern space + slash syntax). Returns { parts, alpha } where alpha is 1 when
+ * omitted. Returns null when the argument list cannot be parsed.
+ */
+function parseFunctionArgs(args) {
+  const parts = args
+    .split(/[,\s]+/)
+    .map((part) => part.trim())
+    .filter((part) => part !== '' && part !== '/');
+  if (parts.length < 3) return null;
+  let alpha = 1;
+  if (parts.length >= 4) {
+    const alphaText = parts.pop().trim();
+    if (alphaText.endsWith('%')) {
+      const percent = parseFloat(alphaText);
+      if (!Number.isFinite(percent)) return null;
+      alpha = clampUnit(percent / 100);
+    } else {
+      const number = Number(alphaText);
+      if (!Number.isFinite(number)) return null;
+      alpha = clampUnit(number);
+    }
+  }
+  return { parts, alpha };
+}
+
+function parseChannel(value) {
+  if (typeof value !== 'string' || value === '') return null;
+  const text = value.trim();
+  if (text.endsWith('%')) return clampChannel((parseFloat(text) / 100) * 255);
+  const number = Number(text);
+  return Number.isFinite(number) ? clampChannel(number) : null;
+}
+
+function parsePercent(value) {
+  if (typeof value !== 'string' || value === '') return null;
+  const text = value.trim();
+  if (!text.endsWith('%')) return null;
+  const number = parseFloat(text);
+  return Number.isFinite(number) ? Math.min(100, Math.max(0, number)) : null;
+}
+
+function parseHue(value) {
+  if (typeof value !== 'string' || value === '') return null;
+  const number = parseFloat(value);
+  return Number.isFinite(number) ? number : null;
+}
+
+/** Standard HSL -> RGB. h in degrees, s/l in 0..100, returns r/g/b in 0..255. */
+function hslToRgb(h, s, l) {
+  const hue = ((h % 360) + 360) % 360 / 360;
+  const saturation = s / 100;
+  const lightness = l / 100;
+  const chroma = (1 - Math.abs(2 * lightness - 1)) * saturation;
+  const section = hue * 6;
+  const x = chroma * (1 - Math.abs((section % 2) - 1));
+  let red = 0;
+  let green = 0;
+  let blue = 0;
+  if (section < 1) { red = chroma; green = x; }
+  else if (section < 2) { red = x; green = chroma; }
+  else if (section < 3) { green = chroma; blue = x; }
+  else if (section < 4) { green = x; blue = chroma; }
+  else if (section < 5) { red = x; blue = chroma; }
+  else { red = chroma; blue = x; }
+  const match = lightness - chroma / 2;
+  return [
+    Math.round((red + match) * 255),
+    Math.round((green + match) * 255),
+    Math.round((blue + match) * 255)
+  ];
+}
+
+/**
+ * Parse any supported CSS color. When keepAlpha is true the alpha channel is
+ * preserved (8-digit hex for alpha < 1); when false it is dropped. 'transparent'
+ * is only preserved when keepAlpha is true.
+ */
+function parseColor(value, keepAlpha) {
+  if (typeof value !== 'string') return null;
+  const input = value.trim();
+  if (!input) return null;
+  const lower = input.toLowerCase();
+  if (keepAlpha && lower === 'transparent') return 'transparent';
+  if (NAMED_COLORS[lower]) return NAMED_COLORS[lower];
+  // #rgb / #rgba / #rrggbb / #rrggbbaa，以及无 # 前缀的 6/8 位 hex（dicebear 习惯）
+  const hexMatch = input.match(/^#?([0-9a-f]{3,8})$/i);
+  if (hexMatch) {
+    let hex = hexMatch[1].toLowerCase();
+    if (hex.length === 3 || hex.length === 4) {
+      hex = hex.split('').map((c) => c + c).join('');
+    }
+    if (keepAlpha && hex.length === 8) return `#${hex}`;
+    return `#${hex.slice(0, 6)}`;
+  }
+  const funcMatch = input.match(/^(rgba?|hsla?)\(([^)]*)\)$/i);
+  if (!funcMatch) return null;
+  const kind = funcMatch[1].toLowerCase();
+  const parsed = parseFunctionArgs(funcMatch[2]);
+  if (!parsed) return null;
+  const { parts, alpha } = parsed;
+  let red;
+  let green;
+  let blue;
+  if (kind === 'rgb' || kind === 'rgba') {
+    if (parts.length !== 3) return null;
+    red = parseChannel(parts[0]);
+    green = parseChannel(parts[1]);
+    blue = parseChannel(parts[2]);
+    if (red === null || green === null || blue === null) return null;
+  } else {
+    if (parts.length !== 3) return null;
+    const hue = parseHue(parts[0]);
+    const saturation = parsePercent(parts[1]);
+    const lightness = parsePercent(parts[2]);
+    if (hue === null || saturation === null || lightness === null) return null;
+    [red, green, blue] = hslToRgb(hue, saturation, lightness);
+  }
+  const hex = `#${hexPair(red)}${hexPair(green)}${hexPair(blue)}`;
+  if (keepAlpha && alpha < 1) return `${hex}${hexPair(alpha * 255)}`;
+  return hex;
+}
+
+/**
+ * Convert any supported CSS color into `#rrggbb`. Returns null when the
+ * value cannot be parsed. Supports: #rgb / #rgba / #rrggbb / #rrggbbaa
+ * (case-insensitive), bare 6/8-digit hex, CSS named colors, rgb() / rgba() /
+ * hsl() / hsla() with comma or modern space syntax, including percentages.
+ * Alpha is ignored.
+ */
+function normalizeColor(value) {
+  return parseColor(value, false);
+}
+
+/**
+ * Convert any supported CSS color into `#rrggbb` (alpha = 1) or `#rrggbbaa`
+ * (alpha < 1). The literal string 'transparent' is returned as-is. Returns
+ * null when the value cannot be parsed.
+ */
+function normalizeColorWithAlpha(value) {
+  return parseColor(value, true);
+}
+
+function hexToRgb01(color) {
+  const hex = normalizeColor(color);
+  if (!hex) return [0, 0, 0];
+  const value = Number.parseInt(hex.slice(1), 16);
+  return [
+    ((value >> 16) & 255) / 255,
+    ((value >> 8) & 255) / 255,
+    (value & 255) / 255
+  ];
+}
+
+function hexToRgba(color, alpha = 1) {
+  const hex = normalizeColor(color);
+  if (!hex) return 'rgba(0, 0, 0, 0)';
+  const value = Number.parseInt(hex.slice(1), 16);
+  const red = (value >> 16) & 255;
+  const green = (value >> 8) & 255;
+  const blue = value & 255;
+  return `rgba(${red}, ${green}, ${blue}, ${alpha})`;
+}
+
+function validateColors(colors) {
+  return Array.isArray(colors)
+    && colors.length === 4
+    && colors.every((color) => normalizeColor(color) !== null);
+}
+
+export { hexToRgba as a, normalizeColorWithAlpha as b, hexToRgb01 as h, normalizeColor as n, validateColors as v };

package/dist/chunks/controls-B5_ctvvA.mjs

@@ -0,0 +1,160 @@
+/**
+ * SVG helpers for the avatar pipeline: XML escaping, size application,
+ * data-URI encoding and a light sanitizer for render output.
+ */
+
+const EVENT_ATTR_PATTERN = /(\son\w+\s*=\s*["'][^"']*["'])/gi;
+const SCRIPT_TAG_PATTERN = /<script[\s\S]*?<\/script\s*>/gi;
+
+function escapeXml(content) {
+  return content
+    .replace(/&/g, '&amp;')
+    .replace(/'/g, '&apos;')
+    .replace(/"/g, '&quot;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;');
+}
+
+/**
+ * Normalize an SVG string's width/height attributes to a target size.
+ * Leaves the viewBox untouched so the aspect ratio is preserved.
+ */
+function applySize(svg, size) {
+  if (size == null || size === '') return svg;
+  const value = typeof size === 'number' ? String(size) : String(size);
+  return svg
+    .replace(/(<svg[^>]*?)\swidth="[^"]*"/i, `$1 width="${escapeXml(value)}"`)
+    .replace(/(<svg[^>]*?)\sheight="[^"]*"/i, `$1 height="${escapeXml(value)}"`);
+}
+
+function svgToDataUri(svg) {
+  return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
+}
+
+/**
+ * Light sanitizer: removes <script> blocks and on* event handler attributes.
+ * Upstream assets are trusted (vendored and licensed), this is defense in
+ * depth for user-supplied seed strings that get interpolated into markup.
+ */
+function sanitizeSvg(svg) {
+  return svg
+    .replace(SCRIPT_TAG_PATTERN, '')
+    .replace(EVENT_ATTR_PATTERN, '');
+}
+
+/** Clean arbitrary user text down to a safe seed string. */
+function cleanText(value, maxLength = 128) {
+  if (value == null) return '';
+  const text = String(value).trim().slice(0, maxLength);
+  return text.replace(/[<>&"']/g, '');
+}
+
+/**
+ * Derive UI control descriptors from an upstream JSON-Schema.
+ *
+ * The generated controls are display metadata only — the actual parameter
+ * names, types, defaults and array semantics are never changed; the demo/docs
+ * layer renders widgets from these descriptors and writes values back into
+ * providerOptions verbatim.
+ *
+ *   array + items.enum            -> select (multi-choice)
+ *   array + items.pattern (color) -> color
+ *   integer + min/max             -> range
+ *   boolean                       -> switch
+ *   string + enum                 -> select (single)
+ */
+
+function buildControlsFromSchema(schema) {
+  const props = (schema && schema.properties) || {};
+  const controls = [];
+  for (const key of Object.keys(props)) {
+    const prop = props[key];
+    const label = toLabel(key);
+    const definition = prop.default;
+
+    if (prop.type === 'array' && prop.items) {
+      if (prop.items.enum) {
+        controls.push({
+          id: key,
+          label,
+          kind: 'select',
+          options: prop.items.enum,
+          default: definition !== undefined ? [...definition] : undefined
+        });
+        continue;
+      }
+      if (isColorArray(key, prop)) {
+        controls.push({
+          id: key,
+          label,
+          kind: 'color',
+          default: definition !== undefined ? definition[0] : undefined
+        });
+        continue;
+      }
+      controls.push({ id: key, label, kind: 'tags', default: definition });
+      continue;
+    }
+    if (prop.type === 'integer') {
+      controls.push({
+        id: key,
+        label,
+        kind: 'range',
+        min: prop.minimum !== undefined ? prop.minimum : 0,
+        max: prop.maximum !== undefined ? prop.maximum : 100,
+        step: 1,
+        default: definition !== undefined ? definition : undefined
+      });
+      continue;
+    }
+    if (prop.type === 'boolean') {
+      controls.push({
+        id: key,
+        label,
+        kind: 'switch',
+        default: definition !== undefined ? definition : undefined
+      });
+      continue;
+    }
+    if (prop.type === 'string' && prop.enum) {
+      controls.push({
+        id: key,
+        label,
+        kind: 'select',
+        options: prop.enum,
+        default: definition
+      });
+    }
+  }
+  // UI 简化标记：上游用 "<x>Probability"（0–100）控制“部位出现概率”。
+  // 这里把概率滑杆与对应的 "<x>" 下拉配对，渲染层可以把两者合并成
+  // 「无（不显示）/ 具体款式」二选一，避免让终端用户理解概率语义。
+  const selectsById = new Map(
+    controls.filter((c) => c.kind === 'select').map((c) => [c.id, c])
+  );
+  for (const control of controls) {
+    if (control.kind === 'range' && /Probability$/.test(control.id)) {
+      const baseId = control.id.slice(0, -'Probability'.length);
+      const base = selectsById.get(baseId);
+      if (base) {
+        base.probability = control.id;
+        control.probabilityOf = baseId;
+      }
+    }
+  }
+  return controls;
+}
+
+function toLabel(key) {
+  return key
+    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+    .replace(/^./, (c) => c.toUpperCase());
+}
+
+/** Color arrays in dicebear schemas: hex pattern with optional "transparent". */
+function isColorArray(key, prop) {
+  if (prop.items.type !== 'string' || !prop.items.pattern) return false;
+  return /transparent/.test(prop.items.pattern) || /[Cc]olor$/.test(key);
+}
+
+export { applySize as a, buildControlsFromSchema as b, cleanText as c, svgToDataUri as d, escapeXml as e, sanitizeSvg as s };

package/dist/chunks/copy-7J0XIj_0.mjs

@@ -0,0 +1,13 @@
+/**
+ * Internal accessibility labels and small UI text. Since the copy API was
+ * removed (slots own the text area), these are no longer user-overridable.
+ * Templates use {brand} {code} {name} placeholders.
+ */
+const COPY = {
+  brandName: '画境观屿',
+  valueSuffix: '%',
+  progressAria: '{brand} {code} 加载进度',
+  capsuleAria: '打开 {name} 沉浸预览'
+};
+
+export { COPY as C };