@rdicons/core 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 rdicons contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+The icon sets bundled at build time are third-party works under their own
+licenses (see THIRD_PARTY_NOTICES.md). The MIT license above covers this
+repository's source code only.

package/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# @rdicons/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The small, framework-free engine behind [rdicons](https://rdicons.vimalbhatt.com): recolor an icon, change its stroke and size, add padding or a background, convert SVG to a React component, and export PNG.
+
+```bash
+npm install @rdicons/core
+```
+
+```ts
+import { buildSvg, svgToJsx } from '@rdicons/core'
+
+const svg = buildSvg(
+  { set: 'lucide', name: 'house', width: 24, height: 24, body: '<path stroke="currentColor" d="…"/>' },
+  { color: '#4f46e5', strokeWidth: 1.5, size: 32 },
+)
+const jsx = svgToJsx(svg, 'House')
+```
+
+Browser-only helpers (PNG export, safe SVG upload cleaning) live in `@rdicons/core/browser`.
+
+Looking for ready-made icons? See [`@rdicons/react`](https://www.npmjs.com/package/@rdicons/react) and the `rdicons` CLI.
+
+MIT licensed. Docs: https://rdicons.vimalbhatt.com/docs

package/dist/browser.cjs

@@ -0,0 +1,214 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/browser.ts
+var browser_exports = {};
+__export(browser_exports, {
+  IMAGE_TYPES: () => IMAGE_TYPES,
+  MAX_IMAGE_BYTES: () => MAX_IMAGE_BYTES,
+  MAX_SVG_BYTES: () => MAX_SVG_BYTES,
+  copyText: () => copyText,
+  downloadFile: () => downloadFile,
+  prepareSvgUpload: () => prepareSvgUpload,
+  readImageSize: () => readImageSize,
+  resizeRasterToPng: () => resizeRasterToPng,
+  svgToPngBlob: () => svgToPngBlob
+});
+module.exports = __toCommonJS(browser_exports);
+var import_dompurify = __toESM(require("dompurify"), 1);
+var MAX_SVG_BYTES = 512 * 1024;
+var MAX_IMAGE_BYTES = 2 * 1024 * 1024;
+var IMAGE_TYPES = ["image/png", "image/jpeg", "image/webp", "image/gif"];
+var ROOT_PRESENTATION = ["fill", "stroke", "stroke-width", "stroke-linecap", "stroke-linejoin", "stroke-miterlimit", "fill-rule", "clip-rule", "opacity", "fill-opacity", "stroke-opacity"];
+function prepareSvgUpload(text, opts = {}) {
+  if (new Blob([text]).size > MAX_SVG_BYTES) throw new Error("SVG is larger than 512 KB");
+  if (!/<svg[\s>]/i.test(text)) throw new Error("This file is not an SVG");
+  const clean = import_dompurify.default.sanitize(text, {
+    USE_PROFILES: { svg: true, svgFilters: true },
+    ADD_TAGS: ["style"],
+    FORBID_TAGS: ["script", "foreignObject", "iframe", "object", "embed", "image", "a", "animate", "set", "animateTransform", "animateMotion"],
+    FORBID_ATTR: ["onload", "onclick", "onerror", "onmouseover", "onfocus", "onbegin", "onend"]
+  });
+  const doc = new DOMParser().parseFromString(clean, "image/svg+xml");
+  const svg = doc.documentElement;
+  if (!svg || svg.nodeName.toLowerCase() !== "svg" || doc.querySelector("parsererror")) throw new Error("Could not read this SVG");
+  let minX = 0;
+  let minY = 0;
+  let width = 24;
+  let height = 24;
+  const vb = svg.getAttribute("viewBox")?.trim().split(/[\s,]+/).map(Number);
+  if (vb && vb.length === 4 && vb.every((n) => Number.isFinite(n)) && vb[2] > 0 && vb[3] > 0) {
+    ;
+    [minX, minY, width, height] = vb;
+  } else {
+    const w = parseFloat(svg.getAttribute("width") ?? "");
+    const h = parseFloat(svg.getAttribute("height") ?? "");
+    if (w > 0 && h > 0) {
+      width = w;
+      height = h;
+    }
+  }
+  doc.querySelectorAll("*").forEach((el) => {
+    for (const attr of ["href", "xlink:href"]) {
+      const v = el.getAttribute(attr);
+      if (v != null && !v.startsWith("#")) el.removeAttribute(attr);
+    }
+    if (el.nodeName.toLowerCase() === "style" && el.textContent) {
+      el.textContent = el.textContent.replace(/@import[^;]*;?/gi, "").replace(/url\(\s*['"]?\s*(?!#)[^)]*\)/gi, "none");
+    }
+    const st = el.getAttribute("style");
+    if (st) el.setAttribute("style", st.replace(/url\(\s*['"]?\s*(?!#)[^)]*\)/gi, "none"));
+  });
+  const attrs = [];
+  for (const name of ROOT_PRESENTATION) {
+    const v = svg.getAttribute(name);
+    if (v != null) attrs.push(`${name}="${v.replace(/"/g, "&quot;")}"`);
+  }
+  if (opts.monochrome && !svg.hasAttribute("fill") && !svg.hasAttribute("stroke")) attrs.push('fill="currentColor"');
+  if (minX || minY) attrs.push(`transform="translate(${-minX} ${-minY})"`);
+  const ser = new XMLSerializer();
+  let body = Array.from(svg.childNodes).map((n) => ser.serializeToString(n)).join("").replace(/ xmlns(:\w+)?="[^"]*"/g, "").trim();
+  if (!body) throw new Error("This SVG is empty");
+  let wrapped = attrs.length ? `<g ${attrs.join(" ")}>${body}</g>` : body;
+  if (opts.monochrome) {
+    wrapped = wrapped.replace(/\b(fill|stroke)="(?!none|currentColor|url\()[^"]*"/gi, '$1="currentColor"');
+    wrapped = wrapped.replace(/\b(fill|stroke)\s*:\s*(?!none|currentColor|url\()[^;"}]+/gi, "$1:currentColor");
+  }
+  return { body: wrapped, width: Math.round(width * 100) / 100, height: Math.round(height * 100) / 100 };
+}
+async function readImageSize(file) {
+  const url = URL.createObjectURL(file);
+  try {
+    const img = new Image();
+    await new Promise((resolve, reject) => {
+      img.onload = () => resolve();
+      img.onerror = () => reject(new Error("Could not read this image"));
+      img.src = url;
+    });
+    return { width: img.naturalWidth, height: img.naturalHeight };
+  } finally {
+    URL.revokeObjectURL(url);
+  }
+}
+async function resizeRasterToPng(src, size, background) {
+  const url = typeof src === "string" ? src : URL.createObjectURL(src);
+  try {
+    const img = new Image();
+    img.crossOrigin = "anonymous";
+    await new Promise((resolve, reject) => {
+      img.onload = () => resolve();
+      img.onerror = () => reject(new Error("Could not load image"));
+      img.src = url;
+    });
+    const ratio = img.naturalWidth / img.naturalHeight || 1;
+    const w = ratio >= 1 ? size : Math.round(size * ratio);
+    const h = ratio >= 1 ? Math.round(size / ratio) : size;
+    const canvas = document.createElement("canvas");
+    canvas.width = w;
+    canvas.height = h;
+    const ctx = canvas.getContext("2d");
+    if (background) {
+      ctx.fillStyle = background;
+      ctx.fillRect(0, 0, w, h);
+    }
+    ctx.imageSmoothingQuality = "high";
+    ctx.drawImage(img, 0, 0, w, h);
+    return await new Promise((resolve, reject) => canvas.toBlob((b) => b ? resolve(b) : reject(new Error("PNG export failed")), "image/png"));
+  } finally {
+    if (typeof src !== "string") URL.revokeObjectURL(url);
+  }
+}
+async function svgToPngBlob(svg, size, background) {
+  const url = URL.createObjectURL(new Blob([svg], { type: "image/svg+xml;charset=utf-8" }));
+  try {
+    const img = new Image();
+    img.decoding = "async";
+    await new Promise((resolve, reject) => {
+      img.onload = () => resolve();
+      img.onerror = () => reject(new Error("Could not render SVG"));
+      img.src = url;
+    });
+    const ratio = img.naturalWidth && img.naturalHeight ? img.naturalWidth / img.naturalHeight : 1;
+    const w = ratio >= 1 ? size : Math.round(size * ratio);
+    const h = ratio >= 1 ? Math.round(size / ratio) : size;
+    const canvas = document.createElement("canvas");
+    canvas.width = w;
+    canvas.height = h;
+    const ctx = canvas.getContext("2d");
+    if (!ctx) throw new Error("Canvas not supported");
+    if (background) {
+      ctx.fillStyle = background;
+      ctx.fillRect(0, 0, w, h);
+    }
+    ctx.drawImage(img, 0, 0, w, h);
+    return await new Promise(
+      (resolve, reject) => canvas.toBlob((b) => b ? resolve(b) : reject(new Error("PNG export failed")), "image/png")
+    );
+  } finally {
+    URL.revokeObjectURL(url);
+  }
+}
+function downloadFile(data, filename, mime = "application/octet-stream") {
+  const blob = typeof data === "string" ? new Blob([data], { type: mime }) : data;
+  const a = document.createElement("a");
+  a.href = URL.createObjectURL(blob);
+  a.download = filename;
+  document.body.appendChild(a);
+  a.click();
+  a.remove();
+  setTimeout(() => URL.revokeObjectURL(a.href), 2e3);
+}
+async function copyText(text) {
+  try {
+    await navigator.clipboard.writeText(text);
+    return true;
+  } catch {
+    const ta = document.createElement("textarea");
+    ta.value = text;
+    ta.style.position = "fixed";
+    ta.style.opacity = "0";
+    document.body.appendChild(ta);
+    ta.select();
+    const ok = document.execCommand("copy");
+    ta.remove();
+    return ok;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IMAGE_TYPES,
+  MAX_IMAGE_BYTES,
+  MAX_SVG_BYTES,
+  copyText,
+  downloadFile,
+  prepareSvgUpload,
+  readImageSize,
+  resizeRasterToPng,
+  svgToPngBlob
+});

package/dist/browser.d.cts

@@ -0,0 +1,34 @@
+declare const MAX_SVG_BYTES: number;
+declare const MAX_IMAGE_BYTES: number;
+declare const IMAGE_TYPES: string[];
+interface PreparedSvg {
+    /** Safe inner markup in Iconify format (works with buildSvg and the grid) */
+    body: string;
+    width: number;
+    height: number;
+}
+/**
+ * Clean an uploaded SVG and turn it into {body,width,height}.
+ * - removes scripts, event handlers, foreign objects, remote images and external links
+ * - drops @import / remote url() from <style>
+ * - optionally converts every colour to currentColor so the icon can be recoloured
+ * Throws an Error with a user-readable message when the file is not a usable SVG.
+ */
+declare function prepareSvgUpload(text: string, opts?: {
+    monochrome?: boolean;
+}): PreparedSvg;
+/** Read the pixel size of a raster image file. */
+declare function readImageSize(file: Blob): Promise<{
+    width: number;
+    height: number;
+}>;
+/** Resize a raster image URL/blob to a PNG at the given longest side. */
+declare function resizeRasterToPng(src: Blob | string, size: number, background?: string | null): Promise<Blob>;
+/** Rasterise an SVG string to a PNG blob at the given pixel size. */
+declare function svgToPngBlob(svg: string, size: number, background?: string | null): Promise<Blob>;
+/** Trigger a file download for a Blob or string. */
+declare function downloadFile(data: Blob | string, filename: string, mime?: string): void;
+/** Copy text to the clipboard, with a fallback for older/insecure contexts. */
+declare function copyText(text: string): Promise<boolean>;
+
+export { IMAGE_TYPES, MAX_IMAGE_BYTES, MAX_SVG_BYTES, type PreparedSvg, copyText, downloadFile, prepareSvgUpload, readImageSize, resizeRasterToPng, svgToPngBlob };

package/dist/browser.d.ts

@@ -0,0 +1,34 @@
+declare const MAX_SVG_BYTES: number;
+declare const MAX_IMAGE_BYTES: number;
+declare const IMAGE_TYPES: string[];
+interface PreparedSvg {
+    /** Safe inner markup in Iconify format (works with buildSvg and the grid) */
+    body: string;
+    width: number;
+    height: number;
+}
+/**
+ * Clean an uploaded SVG and turn it into {body,width,height}.
+ * - removes scripts, event handlers, foreign objects, remote images and external links
+ * - drops @import / remote url() from <style>
+ * - optionally converts every colour to currentColor so the icon can be recoloured
+ * Throws an Error with a user-readable message when the file is not a usable SVG.
+ */
+declare function prepareSvgUpload(text: string, opts?: {
+    monochrome?: boolean;
+}): PreparedSvg;
+/** Read the pixel size of a raster image file. */
+declare function readImageSize(file: Blob): Promise<{
+    width: number;
+    height: number;
+}>;
+/** Resize a raster image URL/blob to a PNG at the given longest side. */
+declare function resizeRasterToPng(src: Blob | string, size: number, background?: string | null): Promise<Blob>;
+/** Rasterise an SVG string to a PNG blob at the given pixel size. */
+declare function svgToPngBlob(svg: string, size: number, background?: string | null): Promise<Blob>;
+/** Trigger a file download for a Blob or string. */
+declare function downloadFile(data: Blob | string, filename: string, mime?: string): void;
+/** Copy text to the clipboard, with a fallback for older/insecure contexts. */
+declare function copyText(text: string): Promise<boolean>;
+
+export { IMAGE_TYPES, MAX_IMAGE_BYTES, MAX_SVG_BYTES, type PreparedSvg, copyText, downloadFile, prepareSvgUpload, readImageSize, resizeRasterToPng, svgToPngBlob };

package/dist/browser.js

@@ -0,0 +1,171 @@
+// src/browser.ts
+import DOMPurify from "dompurify";
+var MAX_SVG_BYTES = 512 * 1024;
+var MAX_IMAGE_BYTES = 2 * 1024 * 1024;
+var IMAGE_TYPES = ["image/png", "image/jpeg", "image/webp", "image/gif"];
+var ROOT_PRESENTATION = ["fill", "stroke", "stroke-width", "stroke-linecap", "stroke-linejoin", "stroke-miterlimit", "fill-rule", "clip-rule", "opacity", "fill-opacity", "stroke-opacity"];
+function prepareSvgUpload(text, opts = {}) {
+  if (new Blob([text]).size > MAX_SVG_BYTES) throw new Error("SVG is larger than 512 KB");
+  if (!/<svg[\s>]/i.test(text)) throw new Error("This file is not an SVG");
+  const clean = DOMPurify.sanitize(text, {
+    USE_PROFILES: { svg: true, svgFilters: true },
+    ADD_TAGS: ["style"],
+    FORBID_TAGS: ["script", "foreignObject", "iframe", "object", "embed", "image", "a", "animate", "set", "animateTransform", "animateMotion"],
+    FORBID_ATTR: ["onload", "onclick", "onerror", "onmouseover", "onfocus", "onbegin", "onend"]
+  });
+  const doc = new DOMParser().parseFromString(clean, "image/svg+xml");
+  const svg = doc.documentElement;
+  if (!svg || svg.nodeName.toLowerCase() !== "svg" || doc.querySelector("parsererror")) throw new Error("Could not read this SVG");
+  let minX = 0;
+  let minY = 0;
+  let width = 24;
+  let height = 24;
+  const vb = svg.getAttribute("viewBox")?.trim().split(/[\s,]+/).map(Number);
+  if (vb && vb.length === 4 && vb.every((n) => Number.isFinite(n)) && vb[2] > 0 && vb[3] > 0) {
+    ;
+    [minX, minY, width, height] = vb;
+  } else {
+    const w = parseFloat(svg.getAttribute("width") ?? "");
+    const h = parseFloat(svg.getAttribute("height") ?? "");
+    if (w > 0 && h > 0) {
+      width = w;
+      height = h;
+    }
+  }
+  doc.querySelectorAll("*").forEach((el) => {
+    for (const attr of ["href", "xlink:href"]) {
+      const v = el.getAttribute(attr);
+      if (v != null && !v.startsWith("#")) el.removeAttribute(attr);
+    }
+    if (el.nodeName.toLowerCase() === "style" && el.textContent) {
+      el.textContent = el.textContent.replace(/@import[^;]*;?/gi, "").replace(/url\(\s*['"]?\s*(?!#)[^)]*\)/gi, "none");
+    }
+    const st = el.getAttribute("style");
+    if (st) el.setAttribute("style", st.replace(/url\(\s*['"]?\s*(?!#)[^)]*\)/gi, "none"));
+  });
+  const attrs = [];
+  for (const name of ROOT_PRESENTATION) {
+    const v = svg.getAttribute(name);
+    if (v != null) attrs.push(`${name}="${v.replace(/"/g, "&quot;")}"`);
+  }
+  if (opts.monochrome && !svg.hasAttribute("fill") && !svg.hasAttribute("stroke")) attrs.push('fill="currentColor"');
+  if (minX || minY) attrs.push(`transform="translate(${-minX} ${-minY})"`);
+  const ser = new XMLSerializer();
+  let body = Array.from(svg.childNodes).map((n) => ser.serializeToString(n)).join("").replace(/ xmlns(:\w+)?="[^"]*"/g, "").trim();
+  if (!body) throw new Error("This SVG is empty");
+  let wrapped = attrs.length ? `<g ${attrs.join(" ")}>${body}</g>` : body;
+  if (opts.monochrome) {
+    wrapped = wrapped.replace(/\b(fill|stroke)="(?!none|currentColor|url\()[^"]*"/gi, '$1="currentColor"');
+    wrapped = wrapped.replace(/\b(fill|stroke)\s*:\s*(?!none|currentColor|url\()[^;"}]+/gi, "$1:currentColor");
+  }
+  return { body: wrapped, width: Math.round(width * 100) / 100, height: Math.round(height * 100) / 100 };
+}
+async function readImageSize(file) {
+  const url = URL.createObjectURL(file);
+  try {
+    const img = new Image();
+    await new Promise((resolve, reject) => {
+      img.onload = () => resolve();
+      img.onerror = () => reject(new Error("Could not read this image"));
+      img.src = url;
+    });
+    return { width: img.naturalWidth, height: img.naturalHeight };
+  } finally {
+    URL.revokeObjectURL(url);
+  }
+}
+async function resizeRasterToPng(src, size, background) {
+  const url = typeof src === "string" ? src : URL.createObjectURL(src);
+  try {
+    const img = new Image();
+    img.crossOrigin = "anonymous";
+    await new Promise((resolve, reject) => {
+      img.onload = () => resolve();
+      img.onerror = () => reject(new Error("Could not load image"));
+      img.src = url;
+    });
+    const ratio = img.naturalWidth / img.naturalHeight || 1;
+    const w = ratio >= 1 ? size : Math.round(size * ratio);
+    const h = ratio >= 1 ? Math.round(size / ratio) : size;
+    const canvas = document.createElement("canvas");
+    canvas.width = w;
+    canvas.height = h;
+    const ctx = canvas.getContext("2d");
+    if (background) {
+      ctx.fillStyle = background;
+      ctx.fillRect(0, 0, w, h);
+    }
+    ctx.imageSmoothingQuality = "high";
+    ctx.drawImage(img, 0, 0, w, h);
+    return await new Promise((resolve, reject) => canvas.toBlob((b) => b ? resolve(b) : reject(new Error("PNG export failed")), "image/png"));
+  } finally {
+    if (typeof src !== "string") URL.revokeObjectURL(url);
+  }
+}
+async function svgToPngBlob(svg, size, background) {
+  const url = URL.createObjectURL(new Blob([svg], { type: "image/svg+xml;charset=utf-8" }));
+  try {
+    const img = new Image();
+    img.decoding = "async";
+    await new Promise((resolve, reject) => {
+      img.onload = () => resolve();
+      img.onerror = () => reject(new Error("Could not render SVG"));
+      img.src = url;
+    });
+    const ratio = img.naturalWidth && img.naturalHeight ? img.naturalWidth / img.naturalHeight : 1;
+    const w = ratio >= 1 ? size : Math.round(size * ratio);
+    const h = ratio >= 1 ? Math.round(size / ratio) : size;
+    const canvas = document.createElement("canvas");
+    canvas.width = w;
+    canvas.height = h;
+    const ctx = canvas.getContext("2d");
+    if (!ctx) throw new Error("Canvas not supported");
+    if (background) {
+      ctx.fillStyle = background;
+      ctx.fillRect(0, 0, w, h);
+    }
+    ctx.drawImage(img, 0, 0, w, h);
+    return await new Promise(
+      (resolve, reject) => canvas.toBlob((b) => b ? resolve(b) : reject(new Error("PNG export failed")), "image/png")
+    );
+  } finally {
+    URL.revokeObjectURL(url);
+  }
+}
+function downloadFile(data, filename, mime = "application/octet-stream") {
+  const blob = typeof data === "string" ? new Blob([data], { type: mime }) : data;
+  const a = document.createElement("a");
+  a.href = URL.createObjectURL(blob);
+  a.download = filename;
+  document.body.appendChild(a);
+  a.click();
+  a.remove();
+  setTimeout(() => URL.revokeObjectURL(a.href), 2e3);
+}
+async function copyText(text) {
+  try {
+    await navigator.clipboard.writeText(text);
+    return true;
+  } catch {
+    const ta = document.createElement("textarea");
+    ta.value = text;
+    ta.style.position = "fixed";
+    ta.style.opacity = "0";
+    document.body.appendChild(ta);
+    ta.select();
+    const ok = document.execCommand("copy");
+    ta.remove();
+    return ok;
+  }
+}
+export {
+  IMAGE_TYPES,
+  MAX_IMAGE_BYTES,
+  MAX_SVG_BYTES,
+  copyText,
+  downloadFile,
+  prepareSvgUpload,
+  readImageSize,
+  resizeRasterToPng,
+  svgToPngBlob
+};

package/dist/index.cjs

@@ -0,0 +1,273 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  BRAND: () => BRAND,
+  assignComponentNames: () => assignComponentNames,
+  buildSvg: () => buildSvg,
+  cliFlags: () => cliFlags,
+  componentName: () => componentName,
+  fileName: () => fileName,
+  hexToHsv: () => hexToHsv,
+  hsvToHex: () => hsvToHex,
+  importLines: () => importLines,
+  isLight: () => isLight,
+  libPackage: () => libPackage,
+  nativeStrokeWidth: () => nativeStrokeWidth,
+  normalizeHex: () => normalizeHex,
+  propsString: () => propsString,
+  snippetsFor: () => snippetsFor,
+  supportsStrokeWidth: () => supportsStrokeWidth,
+  svgToJsx: () => svgToJsx,
+  toPascalCase: () => toPascalCase
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/svg.ts
+var STROKE_WIDTH_RE = /stroke-width="[^"]*"/g;
+function supportsStrokeWidth(body) {
+  return /stroke-width="/.test(body);
+}
+function nativeStrokeWidth(body) {
+  const m = body.match(/stroke-width="([\d.]+)"/);
+  return m ? parseFloat(m[1]) : null;
+}
+function buildSvg(icon, opts = {}) {
+  const { color = "#000000", strokeWidth = null, size = 24, background = null, padding = 0, keepCurrentColor = false } = opts;
+  const w = icon.width || 24;
+  const h = icon.height || 24;
+  let body = icon.body;
+  if (!keepCurrentColor) body = body.replace(/currentColor/g, color);
+  if (strokeWidth != null && supportsStrokeWidth(body)) {
+    body = body.replace(STROKE_WIDTH_RE, `stroke-width="${strokeWidth}"`);
+  }
+  const vbX = -padding;
+  const vbY = -padding;
+  const vbW = w + padding * 2;
+  const vbH = h + padding * 2;
+  const px = Math.round(size * vbW / Math.max(vbW, vbH));
+  const py = Math.round(size * vbH / Math.max(vbW, vbH));
+  const bg = background ? `<rect x="${vbX}" y="${vbY}" width="${vbW}" height="${vbH}" fill="${background}"/>` : "";
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${px}" height="${py}" viewBox="${vbX} ${vbY} ${vbW} ${vbH}">${bg}${body}</svg>`;
+}
+var JSX_ATTRS = {
+  class: "className",
+  "stroke-width": "strokeWidth",
+  "stroke-linecap": "strokeLinecap",
+  "stroke-linejoin": "strokeLinejoin",
+  "stroke-miterlimit": "strokeMiterlimit",
+  "stroke-opacity": "strokeOpacity",
+  "stroke-dasharray": "strokeDasharray",
+  "stroke-dashoffset": "strokeDashoffset",
+  "fill-rule": "fillRule",
+  "fill-opacity": "fillOpacity",
+  "clip-rule": "clipRule",
+  "clip-path": "clipPath",
+  "stop-color": "stopColor",
+  "stop-opacity": "stopOpacity",
+  "xmlns:xlink": "xmlnsXlink",
+  "xlink:href": "xlinkHref"
+};
+function svgToJsx(svg, componentName2 = "Icon") {
+  const jsx = svg.replace(/\s([a-zA-Z:-]+)=/g, (_m, attr) => ` ${JSX_ATTRS[attr] ?? attr}=`);
+  return `export function ${componentName2}(props: React.SVGProps<SVGSVGElement>) {
+  return (
+    ${jsx.replace("<svg ", "<svg {...props} ")}
+  )
+}`;
+}
+function toPascalCase(name) {
+  const pascal = name.split(/[^a-zA-Z0-9]+/).filter(Boolean).map((p) => p[0].toUpperCase() + p.slice(1)).join("");
+  if (!pascal) return "Icon";
+  return /^[0-9]/.test(pascal) ? "Icon" + pascal : pascal;
+}
+function assignComponentNames(names) {
+  const used = /* @__PURE__ */ new Set();
+  return names.map((name) => {
+    const base = toPascalCase(name);
+    let comp = base;
+    for (let n = 2; used.has(comp); n++) comp = `${base}_${n}`;
+    used.add(comp);
+    return comp;
+  });
+}
+function fileName(icon, ext) {
+  return `${icon.set}-${icon.name}.${ext}`.replace(/[^a-zA-Z0-9._-]/g, "_");
+}
+
+// src/color.ts
+var clamp = (n, a = 0, b = 1) => Math.min(b, Math.max(a, n));
+function normalizeHex(input) {
+  const m = input.trim().match(/^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/);
+  if (!m) return null;
+  let h = m[1].toLowerCase();
+  if (h.length === 3) h = [...h].map((c) => c + c).join("");
+  return "#" + h;
+}
+function hexToHsv(hex) {
+  const n = normalizeHex(hex) ?? "#000000";
+  const r = parseInt(n.slice(1, 3), 16) / 255;
+  const g = parseInt(n.slice(3, 5), 16) / 255;
+  const b = parseInt(n.slice(5, 7), 16) / 255;
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const d = max - min;
+  let h = 0;
+  if (d) {
+    if (max === r) h = (g - b) / d % 6;
+    else if (max === g) h = (b - r) / d + 2;
+    else h = (r - g) / d + 4;
+    h *= 60;
+    if (h < 0) h += 360;
+  }
+  return { h, s: max === 0 ? 0 : d / max, v: max };
+}
+function hsvToHex({ h, s, v }) {
+  const hh = (h % 360 + 360) % 360;
+  const ss = clamp(s);
+  const vv = clamp(v);
+  const c = vv * ss;
+  const x = c * (1 - Math.abs(hh / 60 % 2 - 1));
+  const m = vv - c;
+  const [r, g, b] = hh < 60 ? [c, x, 0] : hh < 120 ? [x, c, 0] : hh < 180 ? [0, c, x] : hh < 240 ? [0, x, c] : hh < 300 ? [x, 0, c] : [c, 0, x];
+  const to = (n) => Math.round((n + m) * 255).toString(16).padStart(2, "0");
+  return `#${to(r)}${to(g)}${to(b)}`;
+}
+function isLight(hex) {
+  const n = normalizeHex(hex) ?? "#000000";
+  const r = parseInt(n.slice(1, 3), 16);
+  const g = parseInt(n.slice(3, 5), 16);
+  const b = parseInt(n.slice(5, 7), 16);
+  return (r * 299 + g * 587 + b * 114) / 1e3 > 160;
+}
+
+// src/brand.ts
+var BRAND = {
+  name: "rdicons",
+  tagline: "Free icons you can customise and export",
+  description: "Browse thousands of open-source icons, change colour, stroke and size, then copy or download them as SVG or PNG.",
+  /** Public address. Override with NEXT_PUBLIC_SITE_URL (for example http://localhost:3000 while developing). */
+  siteUrl: "https://rdicons.vimalbhatt.com",
+  repoUrl: "https://github.com/DevHydeOut/rdicons-lib",
+  keywords: ["free icons", "svg icons", "icon library", "icon customizer", "icon generator", "svg to png", "react icons", "figma icons", "open source icons", "lucide", "tabler icons", "heroicons", "material symbols"]
+};
+
+// src/snippets.ts
+var libPackage = (set) => `@rdicons/react-${set}`;
+function propsString(o = {}) {
+  const p = [];
+  if (o.size && o.size !== 24) p.push(`size={${o.size}}`);
+  if (o.color) p.push(`color="${o.color}"`);
+  if (o.strokeWidth != null) p.push(`strokeWidth={${o.strokeWidth}}`);
+  if (o.animate) p.push(o.animate === "hover" ? "animate" : `animate="${o.animate}"`);
+  return p.length ? " " + p.join(" ") : "";
+}
+function componentName(icon) {
+  if (icon.c) return icon.c;
+  const p = icon.n.split(/[^a-zA-Z0-9]+/).filter(Boolean).map((x) => x[0].toUpperCase() + x.slice(1)).join("");
+  return /^[0-9]/.test(p) ? "Icon" + p : p || "Icon";
+}
+function cliFlags(o = {}) {
+  const f = [];
+  if (o.color) f.push(`--color "${o.color}"`);
+  if (o.size && o.size !== 24) f.push(`--size ${o.size}`);
+  if (o.strokeWidth != null) f.push(`--stroke ${o.strokeWidth}`);
+  return f.length ? " " + f.join(" ") : "";
+}
+function snippetsFor(icon, o = {}) {
+  const C = componentName(icon);
+  const props = propsString(o);
+  const pkg = libPackage(icon.s);
+  return [
+    {
+      id: "lib",
+      title: `React: only ${icon.s}`,
+      note: "Smallest install: just this one library.",
+      install: `npm install ${pkg}`,
+      lang: "tsx",
+      code: `import { ${C} } from '${pkg}'
+
+export function Example() {
+  return <${C}${props} />
+}`
+    },
+    {
+      id: "all",
+      title: "React: all libraries",
+      note: "One package with every library. Only the icons you import are bundled.",
+      install: "npm install @rdicons/react",
+      lang: "tsx",
+      code: `import { ${C} } from '@rdicons/react/${icon.s}'
+
+export function Example() {
+  return <${C}${props} />
+}`
+    },
+    {
+      id: "cli",
+      title: "Just this one icon",
+      note: "Copies the icon into your project as a file. Nothing to install, works with any framework.",
+      install: `npx rdicons add ${icon.s}:${icon.n} --format tsx --out src/icons${cliFlags(o)}`,
+      lang: "tsx",
+      code: `import { ${C} } from './icons/${C}'
+
+export function Example() {
+  return <${C} />
+}`
+    }
+  ];
+}
+function importLines(icons) {
+  const bySet = /* @__PURE__ */ new Map();
+  for (const i of icons) {
+    const list = bySet.get(i.s) ?? [];
+    const c = componentName(i);
+    if (!list.includes(c)) list.push(c);
+    bySet.set(i.s, list);
+  }
+  return [...bySet.entries()].map(([set, names]) => ({
+    set,
+    pkg: libPackage(set),
+    names,
+    statement: `import { ${names.join(", ")} } from '${libPackage(set)}'`
+  }));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BRAND,
+  assignComponentNames,
+  buildSvg,
+  cliFlags,
+  componentName,
+  fileName,
+  hexToHsv,
+  hsvToHex,
+  importLines,
+  isLight,
+  libPackage,
+  nativeStrokeWidth,
+  normalizeHex,
+  propsString,
+  snippetsFor,
+  supportsStrokeWidth,
+  svgToJsx,
+  toPascalCase
+});

package/dist/index.d.cts

@@ -0,0 +1,125 @@
+/** Minimal icon shape shared by every product (web, Figma plugin, desktop). */
+interface IconData {
+    /** Icon set prefix, e.g. "lucide" */
+    set: string;
+    /** Icon name inside the set, e.g. "arrow-right" */
+    name: string;
+    /** Inner SVG markup (no <svg> wrapper) in Iconify format */
+    body: string;
+    /** viewBox width (default 24) */
+    width: number;
+    /** viewBox height (default 24) */
+    height: number;
+}
+interface CustomizeOptions {
+    /** Any CSS colour. Replaces `currentColor`. Default #000000 */
+    color?: string;
+    /** Replaces every stroke-width. null/undefined keeps the icon's own value */
+    strokeWidth?: number | null;
+    /** Output width/height in px. Default 24 */
+    size?: number;
+    /** Optional solid background rectangle behind the icon */
+    background?: string | null;
+    /** Extra space around the icon in viewBox units */
+    padding?: number;
+    /** Keep `currentColor` instead of replacing it (handy for code) */
+    keepCurrentColor?: boolean;
+}
+
+/** True when the icon has an explicit stroke width we can override. */
+declare function supportsStrokeWidth(body: string): boolean;
+/** Read the first stroke-width in the icon (its native value), if any. */
+declare function nativeStrokeWidth(body: string): number | null;
+/** Build a standalone, paste-anywhere SVG string with the user's customisations. */
+declare function buildSvg(icon: Pick<IconData, 'body' | 'width' | 'height'>, opts?: CustomizeOptions): string;
+/** Convert an SVG string into a React component snippet. */
+declare function svgToJsx(svg: string, componentName?: string): string;
+/**
+ * "arrow-right" -> "ArrowRight". The result is always a valid JavaScript identifier:
+ * a name that starts with a digit gets an "Icon" prefix ("24-hours" -> "Icon24Hours"), an empty name becomes "Icon".
+ */
+declare function toPascalCase(name: string): string;
+/**
+ * Component names for a whole icon library, in the same order as `names`.
+ * Two icons can map to the same PascalCase name ("arrow-down-01" and "arrow-down01"); the later one gets "_2", "_3"...
+ * The npm packages and the website both use this function, so the code the website shows always matches the package.
+ */
+declare function assignComponentNames(names: string[]): string[];
+/** Safe file name for downloads. */
+declare function fileName(icon: Pick<IconData, 'set' | 'name'>, ext: string): string;
+
+/** Small, dependency-free colour maths shared by the website and the Figma plugin pickers. */
+interface HSV {
+    /** hue 0-360 */
+    h: number;
+    /** saturation 0-1 */
+    s: number;
+    /** value (brightness) 0-1 */
+    v: number;
+}
+/** "#abc", "abc", "#AABBCC" -> "#aabbcc". Returns null when it is not a valid hex colour. */
+declare function normalizeHex(input: string): string | null;
+declare function hexToHsv(hex: string): HSV;
+declare function hsvToHex({ h, s, v }: HSV): string;
+/** True for light colours (useful to pick a readable outline). */
+declare function isLight(hex: string): boolean;
+
+/**
+ * Single place to rename the product. Change `name` (and the domain env var)
+ * and the whole site, metadata and logo text follow.
+ */
+declare const BRAND: {
+    readonly name: "rdicons";
+    readonly tagline: "Free icons you can customise and export";
+    readonly description: "Browse thousands of open-source icons, change colour, stroke and size, then copy or download them as SVG or PNG.";
+    /** Public address. Override with NEXT_PUBLIC_SITE_URL (for example http://localhost:3000 while developing). */
+    readonly siteUrl: "https://rdicons.vimalbhatt.com";
+    readonly repoUrl: "https://github.com/DevHydeOut/rdicons-lib";
+    readonly keywords: readonly ["free icons", "svg icons", "icon library", "icon customizer", "icon generator", "svg to png", "react icons", "figma icons", "open source icons", "lucide", "tabler icons", "heroicons", "material symbols"];
+};
+
+/** Minimal icon reference: library prefix, icon name and the React component name. */
+interface IconRef {
+    s: string;
+    n: string;
+    c?: string;
+}
+/**
+ * The code a developer needs to use one icon, for every way of installing rdicons.
+ * Used by the website ("Use in code"), the AI assistant and the docs, so they never disagree.
+ */
+interface UseOptions {
+    /** px; the component default is 24 */
+    size?: number;
+    /** any CSS color; omit to inherit the text color */
+    color?: string | null;
+    strokeWidth?: number | null;
+    /** when the icon has an animation: the trigger to show in the React snippet (hover is written as plain `animate`) */
+    animate?: 'hover' | 'parent' | 'play' | 'loop';
+}
+interface Snippet {
+    id: string;
+    title: string;
+    note?: string;
+    /** shell lines, shown first */
+    install?: string;
+    code: string;
+    lang: string;
+}
+declare const libPackage: (set: string) => string;
+/** JSX props for the current customization; defaults are left out so the snippet stays short. */
+declare function propsString(o?: UseOptions): string;
+/** Component name, e.g. "ArrowRight". Falls back to a PascalCase guess when the server did not send it. */
+declare function componentName(icon: Pick<IconRef, 'n' | 'c'>): string;
+declare function cliFlags(o?: UseOptions): string;
+/** The three ways to use ONE icon from a library, plus plain SVG. */
+declare function snippetsFor(icon: Pick<IconRef, 's' | 'n' | 'c'>, o?: UseOptions): Snippet[];
+/** One import statement per library for a list of icons (used for AI project suggestions). */
+declare function importLines(icons: Pick<IconRef, 's' | 'n' | 'c'>[]): {
+    set: string;
+    pkg: string;
+    names: string[];
+    statement: string;
+}[];
+
+export { BRAND, type CustomizeOptions, type HSV, type IconData, type IconRef, type Snippet, type UseOptions, assignComponentNames, buildSvg, cliFlags, componentName, fileName, hexToHsv, hsvToHex, importLines, isLight, libPackage, nativeStrokeWidth, normalizeHex, propsString, snippetsFor, supportsStrokeWidth, svgToJsx, toPascalCase };

package/dist/index.d.ts

@@ -0,0 +1,125 @@
+/** Minimal icon shape shared by every product (web, Figma plugin, desktop). */
+interface IconData {
+    /** Icon set prefix, e.g. "lucide" */
+    set: string;
+    /** Icon name inside the set, e.g. "arrow-right" */
+    name: string;
+    /** Inner SVG markup (no <svg> wrapper) in Iconify format */
+    body: string;
+    /** viewBox width (default 24) */
+    width: number;
+    /** viewBox height (default 24) */
+    height: number;
+}
+interface CustomizeOptions {
+    /** Any CSS colour. Replaces `currentColor`. Default #000000 */
+    color?: string;
+    /** Replaces every stroke-width. null/undefined keeps the icon's own value */
+    strokeWidth?: number | null;
+    /** Output width/height in px. Default 24 */
+    size?: number;
+    /** Optional solid background rectangle behind the icon */
+    background?: string | null;
+    /** Extra space around the icon in viewBox units */
+    padding?: number;
+    /** Keep `currentColor` instead of replacing it (handy for code) */
+    keepCurrentColor?: boolean;
+}
+
+/** True when the icon has an explicit stroke width we can override. */
+declare function supportsStrokeWidth(body: string): boolean;
+/** Read the first stroke-width in the icon (its native value), if any. */
+declare function nativeStrokeWidth(body: string): number | null;
+/** Build a standalone, paste-anywhere SVG string with the user's customisations. */
+declare function buildSvg(icon: Pick<IconData, 'body' | 'width' | 'height'>, opts?: CustomizeOptions): string;
+/** Convert an SVG string into a React component snippet. */
+declare function svgToJsx(svg: string, componentName?: string): string;
+/**
+ * "arrow-right" -> "ArrowRight". The result is always a valid JavaScript identifier:
+ * a name that starts with a digit gets an "Icon" prefix ("24-hours" -> "Icon24Hours"), an empty name becomes "Icon".
+ */
+declare function toPascalCase(name: string): string;
+/**
+ * Component names for a whole icon library, in the same order as `names`.
+ * Two icons can map to the same PascalCase name ("arrow-down-01" and "arrow-down01"); the later one gets "_2", "_3"...
+ * The npm packages and the website both use this function, so the code the website shows always matches the package.
+ */
+declare function assignComponentNames(names: string[]): string[];
+/** Safe file name for downloads. */
+declare function fileName(icon: Pick<IconData, 'set' | 'name'>, ext: string): string;
+
+/** Small, dependency-free colour maths shared by the website and the Figma plugin pickers. */
+interface HSV {
+    /** hue 0-360 */
+    h: number;
+    /** saturation 0-1 */
+    s: number;
+    /** value (brightness) 0-1 */
+    v: number;
+}
+/** "#abc", "abc", "#AABBCC" -> "#aabbcc". Returns null when it is not a valid hex colour. */
+declare function normalizeHex(input: string): string | null;
+declare function hexToHsv(hex: string): HSV;
+declare function hsvToHex({ h, s, v }: HSV): string;
+/** True for light colours (useful to pick a readable outline). */
+declare function isLight(hex: string): boolean;
+
+/**
+ * Single place to rename the product. Change `name` (and the domain env var)
+ * and the whole site, metadata and logo text follow.
+ */
+declare const BRAND: {
+    readonly name: "rdicons";
+    readonly tagline: "Free icons you can customise and export";
+    readonly description: "Browse thousands of open-source icons, change colour, stroke and size, then copy or download them as SVG or PNG.";
+    /** Public address. Override with NEXT_PUBLIC_SITE_URL (for example http://localhost:3000 while developing). */
+    readonly siteUrl: "https://rdicons.vimalbhatt.com";
+    readonly repoUrl: "https://github.com/DevHydeOut/rdicons-lib";
+    readonly keywords: readonly ["free icons", "svg icons", "icon library", "icon customizer", "icon generator", "svg to png", "react icons", "figma icons", "open source icons", "lucide", "tabler icons", "heroicons", "material symbols"];
+};
+
+/** Minimal icon reference: library prefix, icon name and the React component name. */
+interface IconRef {
+    s: string;
+    n: string;
+    c?: string;
+}
+/**
+ * The code a developer needs to use one icon, for every way of installing rdicons.
+ * Used by the website ("Use in code"), the AI assistant and the docs, so they never disagree.
+ */
+interface UseOptions {
+    /** px; the component default is 24 */
+    size?: number;
+    /** any CSS color; omit to inherit the text color */
+    color?: string | null;
+    strokeWidth?: number | null;
+    /** when the icon has an animation: the trigger to show in the React snippet (hover is written as plain `animate`) */
+    animate?: 'hover' | 'parent' | 'play' | 'loop';
+}
+interface Snippet {
+    id: string;
+    title: string;
+    note?: string;
+    /** shell lines, shown first */
+    install?: string;
+    code: string;
+    lang: string;
+}
+declare const libPackage: (set: string) => string;
+/** JSX props for the current customization; defaults are left out so the snippet stays short. */
+declare function propsString(o?: UseOptions): string;
+/** Component name, e.g. "ArrowRight". Falls back to a PascalCase guess when the server did not send it. */
+declare function componentName(icon: Pick<IconRef, 'n' | 'c'>): string;
+declare function cliFlags(o?: UseOptions): string;
+/** The three ways to use ONE icon from a library, plus plain SVG. */
+declare function snippetsFor(icon: Pick<IconRef, 's' | 'n' | 'c'>, o?: UseOptions): Snippet[];
+/** One import statement per library for a list of icons (used for AI project suggestions). */
+declare function importLines(icons: Pick<IconRef, 's' | 'n' | 'c'>[]): {
+    set: string;
+    pkg: string;
+    names: string[];
+    statement: string;
+}[];
+
+export { BRAND, type CustomizeOptions, type HSV, type IconData, type IconRef, type Snippet, type UseOptions, assignComponentNames, buildSvg, cliFlags, componentName, fileName, hexToHsv, hsvToHex, importLines, isLight, libPackage, nativeStrokeWidth, normalizeHex, propsString, snippetsFor, supportsStrokeWidth, svgToJsx, toPascalCase };

package/dist/index.js

@@ -0,0 +1,229 @@
+// src/svg.ts
+var STROKE_WIDTH_RE = /stroke-width="[^"]*"/g;
+function supportsStrokeWidth(body) {
+  return /stroke-width="/.test(body);
+}
+function nativeStrokeWidth(body) {
+  const m = body.match(/stroke-width="([\d.]+)"/);
+  return m ? parseFloat(m[1]) : null;
+}
+function buildSvg(icon, opts = {}) {
+  const { color = "#000000", strokeWidth = null, size = 24, background = null, padding = 0, keepCurrentColor = false } = opts;
+  const w = icon.width || 24;
+  const h = icon.height || 24;
+  let body = icon.body;
+  if (!keepCurrentColor) body = body.replace(/currentColor/g, color);
+  if (strokeWidth != null && supportsStrokeWidth(body)) {
+    body = body.replace(STROKE_WIDTH_RE, `stroke-width="${strokeWidth}"`);
+  }
+  const vbX = -padding;
+  const vbY = -padding;
+  const vbW = w + padding * 2;
+  const vbH = h + padding * 2;
+  const px = Math.round(size * vbW / Math.max(vbW, vbH));
+  const py = Math.round(size * vbH / Math.max(vbW, vbH));
+  const bg = background ? `<rect x="${vbX}" y="${vbY}" width="${vbW}" height="${vbH}" fill="${background}"/>` : "";
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${px}" height="${py}" viewBox="${vbX} ${vbY} ${vbW} ${vbH}">${bg}${body}</svg>`;
+}
+var JSX_ATTRS = {
+  class: "className",
+  "stroke-width": "strokeWidth",
+  "stroke-linecap": "strokeLinecap",
+  "stroke-linejoin": "strokeLinejoin",
+  "stroke-miterlimit": "strokeMiterlimit",
+  "stroke-opacity": "strokeOpacity",
+  "stroke-dasharray": "strokeDasharray",
+  "stroke-dashoffset": "strokeDashoffset",
+  "fill-rule": "fillRule",
+  "fill-opacity": "fillOpacity",
+  "clip-rule": "clipRule",
+  "clip-path": "clipPath",
+  "stop-color": "stopColor",
+  "stop-opacity": "stopOpacity",
+  "xmlns:xlink": "xmlnsXlink",
+  "xlink:href": "xlinkHref"
+};
+function svgToJsx(svg, componentName2 = "Icon") {
+  const jsx = svg.replace(/\s([a-zA-Z:-]+)=/g, (_m, attr) => ` ${JSX_ATTRS[attr] ?? attr}=`);
+  return `export function ${componentName2}(props: React.SVGProps<SVGSVGElement>) {
+  return (
+    ${jsx.replace("<svg ", "<svg {...props} ")}
+  )
+}`;
+}
+function toPascalCase(name) {
+  const pascal = name.split(/[^a-zA-Z0-9]+/).filter(Boolean).map((p) => p[0].toUpperCase() + p.slice(1)).join("");
+  if (!pascal) return "Icon";
+  return /^[0-9]/.test(pascal) ? "Icon" + pascal : pascal;
+}
+function assignComponentNames(names) {
+  const used = /* @__PURE__ */ new Set();
+  return names.map((name) => {
+    const base = toPascalCase(name);
+    let comp = base;
+    for (let n = 2; used.has(comp); n++) comp = `${base}_${n}`;
+    used.add(comp);
+    return comp;
+  });
+}
+function fileName(icon, ext) {
+  return `${icon.set}-${icon.name}.${ext}`.replace(/[^a-zA-Z0-9._-]/g, "_");
+}
+
+// src/color.ts
+var clamp = (n, a = 0, b = 1) => Math.min(b, Math.max(a, n));
+function normalizeHex(input) {
+  const m = input.trim().match(/^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/);
+  if (!m) return null;
+  let h = m[1].toLowerCase();
+  if (h.length === 3) h = [...h].map((c) => c + c).join("");
+  return "#" + h;
+}
+function hexToHsv(hex) {
+  const n = normalizeHex(hex) ?? "#000000";
+  const r = parseInt(n.slice(1, 3), 16) / 255;
+  const g = parseInt(n.slice(3, 5), 16) / 255;
+  const b = parseInt(n.slice(5, 7), 16) / 255;
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const d = max - min;
+  let h = 0;
+  if (d) {
+    if (max === r) h = (g - b) / d % 6;
+    else if (max === g) h = (b - r) / d + 2;
+    else h = (r - g) / d + 4;
+    h *= 60;
+    if (h < 0) h += 360;
+  }
+  return { h, s: max === 0 ? 0 : d / max, v: max };
+}
+function hsvToHex({ h, s, v }) {
+  const hh = (h % 360 + 360) % 360;
+  const ss = clamp(s);
+  const vv = clamp(v);
+  const c = vv * ss;
+  const x = c * (1 - Math.abs(hh / 60 % 2 - 1));
+  const m = vv - c;
+  const [r, g, b] = hh < 60 ? [c, x, 0] : hh < 120 ? [x, c, 0] : hh < 180 ? [0, c, x] : hh < 240 ? [0, x, c] : hh < 300 ? [x, 0, c] : [c, 0, x];
+  const to = (n) => Math.round((n + m) * 255).toString(16).padStart(2, "0");
+  return `#${to(r)}${to(g)}${to(b)}`;
+}
+function isLight(hex) {
+  const n = normalizeHex(hex) ?? "#000000";
+  const r = parseInt(n.slice(1, 3), 16);
+  const g = parseInt(n.slice(3, 5), 16);
+  const b = parseInt(n.slice(5, 7), 16);
+  return (r * 299 + g * 587 + b * 114) / 1e3 > 160;
+}
+
+// src/brand.ts
+var BRAND = {
+  name: "rdicons",
+  tagline: "Free icons you can customise and export",
+  description: "Browse thousands of open-source icons, change colour, stroke and size, then copy or download them as SVG or PNG.",
+  /** Public address. Override with NEXT_PUBLIC_SITE_URL (for example http://localhost:3000 while developing). */
+  siteUrl: "https://rdicons.vimalbhatt.com",
+  repoUrl: "https://github.com/DevHydeOut/rdicons-lib",
+  keywords: ["free icons", "svg icons", "icon library", "icon customizer", "icon generator", "svg to png", "react icons", "figma icons", "open source icons", "lucide", "tabler icons", "heroicons", "material symbols"]
+};
+
+// src/snippets.ts
+var libPackage = (set) => `@rdicons/react-${set}`;
+function propsString(o = {}) {
+  const p = [];
+  if (o.size && o.size !== 24) p.push(`size={${o.size}}`);
+  if (o.color) p.push(`color="${o.color}"`);
+  if (o.strokeWidth != null) p.push(`strokeWidth={${o.strokeWidth}}`);
+  if (o.animate) p.push(o.animate === "hover" ? "animate" : `animate="${o.animate}"`);
+  return p.length ? " " + p.join(" ") : "";
+}
+function componentName(icon) {
+  if (icon.c) return icon.c;
+  const p = icon.n.split(/[^a-zA-Z0-9]+/).filter(Boolean).map((x) => x[0].toUpperCase() + x.slice(1)).join("");
+  return /^[0-9]/.test(p) ? "Icon" + p : p || "Icon";
+}
+function cliFlags(o = {}) {
+  const f = [];
+  if (o.color) f.push(`--color "${o.color}"`);
+  if (o.size && o.size !== 24) f.push(`--size ${o.size}`);
+  if (o.strokeWidth != null) f.push(`--stroke ${o.strokeWidth}`);
+  return f.length ? " " + f.join(" ") : "";
+}
+function snippetsFor(icon, o = {}) {
+  const C = componentName(icon);
+  const props = propsString(o);
+  const pkg = libPackage(icon.s);
+  return [
+    {
+      id: "lib",
+      title: `React: only ${icon.s}`,
+      note: "Smallest install: just this one library.",
+      install: `npm install ${pkg}`,
+      lang: "tsx",
+      code: `import { ${C} } from '${pkg}'
+
+export function Example() {
+  return <${C}${props} />
+}`
+    },
+    {
+      id: "all",
+      title: "React: all libraries",
+      note: "One package with every library. Only the icons you import are bundled.",
+      install: "npm install @rdicons/react",
+      lang: "tsx",
+      code: `import { ${C} } from '@rdicons/react/${icon.s}'
+
+export function Example() {
+  return <${C}${props} />
+}`
+    },
+    {
+      id: "cli",
+      title: "Just this one icon",
+      note: "Copies the icon into your project as a file. Nothing to install, works with any framework.",
+      install: `npx rdicons add ${icon.s}:${icon.n} --format tsx --out src/icons${cliFlags(o)}`,
+      lang: "tsx",
+      code: `import { ${C} } from './icons/${C}'
+
+export function Example() {
+  return <${C} />
+}`
+    }
+  ];
+}
+function importLines(icons) {
+  const bySet = /* @__PURE__ */ new Map();
+  for (const i of icons) {
+    const list = bySet.get(i.s) ?? [];
+    const c = componentName(i);
+    if (!list.includes(c)) list.push(c);
+    bySet.set(i.s, list);
+  }
+  return [...bySet.entries()].map(([set, names]) => ({
+    set,
+    pkg: libPackage(set),
+    names,
+    statement: `import { ${names.join(", ")} } from '${libPackage(set)}'`
+  }));
+}
+export {
+  BRAND,
+  assignComponentNames,
+  buildSvg,
+  cliFlags,
+  componentName,
+  fileName,
+  hexToHsv,
+  hsvToHex,
+  importLines,
+  isLight,
+  libPackage,
+  nativeStrokeWidth,
+  normalizeHex,
+  propsString,
+  snippetsFor,
+  supportsStrokeWidth,
+  svgToJsx,
+  toPascalCase
+};

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@rdicons/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Framework-free helpers behind rdicons: recolor icons, change stroke and size, convert SVG to JSX, export PNG.",
+  "keywords": ["icons", "svg", "svg-to-jsx", "svg-to-png", "icon-customizer", "rdicons"],
+  "license": "MIT",
+  "author": "rdicons contributors",
+  "homepage": "https://rdicons.vimalbhatt.com/docs/core",
+  "repository": { "type": "git", "url": "git+https://github.com/DevHydeOut/rdicons-lib.git" },
+  "bugs": { "url": "https://github.com/DevHydeOut/rdicons-lib/issues" },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+      "require": { "types": "./dist/index.d.cts", "default": "./dist/index.cjs" }
+    },
+    "./browser": {
+      "import": { "types": "./dist/browser.d.ts", "default": "./dist/browser.js" },
+      "require": { "types": "./dist/browser.d.cts", "default": "./dist/browser.cjs" }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "engines": { "node": ">=18" },
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "build": "tsup",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "dompurify": "^3.4.17"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.0"
+  }
+}