origam 2.3.0 → 2.5.0

package/dist/src/composables/NumberFormat/number-format.composable.cjs

@@ -0,0 +1,165 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.__clearNumberFormatCache = __clearNumberFormatCache;
+exports.useNumberFormat = useNumberFormat;
+var _vue = require("vue");
+var _numberFormat = require("../../consts/NumberFormat/number-format.const.cjs");
+const intlCache = /* @__PURE__ */new Map();
+function resolveLocale(locale) {
+  if (Array.isArray(locale) && locale.length > 0) return locale;
+  if (typeof locale === "string" && locale.length > 0 && locale !== "auto") return locale;
+  if (typeof document !== "undefined") {
+    const htmlLang = document.documentElement?.lang;
+    if (htmlLang) return htmlLang;
+  }
+  if (typeof navigator !== "undefined" && typeof navigator.language === "string" && navigator.language.length > 0) {
+    return navigator.language;
+  }
+  return _numberFormat.NUMBER_FORMAT_FALLBACK_LOCALE;
+}
+function resolveUseGrouping(value) {
+  if (value === void 0) return void 0;
+  if (typeof value === "boolean") return value;
+  return value;
+}
+function resolveStyleAndNotation(format) {
+  switch (format) {
+    case "currency":
+      return {
+        style: "currency"
+      };
+    case "percent":
+      return {
+        style: "percent"
+      };
+    case "unit":
+      return {
+        style: "unit"
+      };
+    case "compact":
+      return {
+        style: "decimal",
+        notation: "compact"
+      };
+    case "scientific":
+      return {
+        style: "decimal",
+        notation: "scientific"
+      };
+    case "engineering":
+      return {
+        style: "decimal",
+        notation: "engineering"
+      };
+    case "decimal":
+    case void 0:
+    default:
+      return {
+        style: "decimal"
+      };
+  }
+}
+function buildIntlOptions(options) {
+  const intl = {};
+  const base = resolveStyleAndNotation(options.format);
+  Object.assign(intl, base);
+  if (options.notation !== void 0) {
+    intl.notation = options.notation;
+  }
+  if (intl.style === "currency") {
+    intl.currency = options.currency || _numberFormat.NUMBER_FORMAT_DEFAULT_CURRENCY;
+    if (options.currencyDisplay !== void 0) {
+      intl.currencyDisplay = options.currencyDisplay;
+    }
+  }
+  if (intl.style === "unit") {
+    if (options.unit) {
+      intl.unit = options.unit;
+      if (options.unitDisplay !== void 0) {
+        intl.unitDisplay = options.unitDisplay;
+      }
+    } else {
+      if (typeof console !== "undefined") {
+        console.warn('[origam] useNumberFormat: format="unit" requires a `unit` option (e.g. "kilometer-per-hour"). Falling back to decimal.');
+      }
+      intl.style = "decimal";
+    }
+  }
+  if (intl.notation === "compact" && options.compactDisplay !== void 0) {
+    intl.compactDisplay = options.compactDisplay;
+  }
+  if (options.minimumFractionDigits !== void 0) intl.minimumFractionDigits = options.minimumFractionDigits;
+  if (options.maximumFractionDigits !== void 0) intl.maximumFractionDigits = options.maximumFractionDigits;
+  if (options.minimumSignificantDigits !== void 0) intl.minimumSignificantDigits = options.minimumSignificantDigits;
+  if (options.maximumSignificantDigits !== void 0) intl.maximumSignificantDigits = options.maximumSignificantDigits;
+  const grouping = resolveUseGrouping(options.useGrouping);
+  if (grouping !== void 0) {
+    intl.useGrouping = grouping;
+  }
+  if (options.signDisplay !== void 0) {
+    intl.signDisplay = options.signDisplay;
+  }
+  return intl;
+}
+function getIntl(locale, options) {
+  const cacheKey = JSON.stringify({
+    l: locale,
+    o: options
+  });
+  const hit = intlCache.get(cacheKey);
+  if (hit !== void 0) {
+    intlCache.delete(cacheKey);
+    intlCache.set(cacheKey, hit);
+    return hit;
+  }
+  const fresh = new Intl.NumberFormat(locale, options);
+  intlCache.set(cacheKey, fresh);
+  if (intlCache.size > _numberFormat.NUMBER_FORMAT_LRU_CAPACITY) {
+    const oldest = intlCache.keys().next().value;
+    if (oldest !== void 0) {
+      intlCache.delete(oldest);
+    }
+  }
+  return fresh;
+}
+function coerceValue(value) {
+  if (typeof value === "number") return value;
+  if (typeof value === "string" && value.length > 0) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+  }
+  return 0;
+}
+function __clearNumberFormatCache() {
+  intlCache.clear();
+}
+function useNumberFormat(options = {}) {
+  const normalisedOptions = (0, _vue.computed)(() => {
+    if ((0, _vue.isRef)(options) || typeof options === "function") {
+      return (0, _vue.toValue)(options) ?? {};
+    }
+    return options;
+  });
+  const intl = (0, _vue.computed)(() => {
+    const opts = normalisedOptions.value;
+    const locale = resolveLocale(opts.locale);
+    const intlOptions = buildIntlOptions(opts);
+    return getIntl(locale, intlOptions);
+  });
+  const format = value => {
+    const numeric = coerceValue(value);
+    return intl.value.format(numeric);
+  };
+  const formatToParts = value => {
+    const numeric = coerceValue(value);
+    return intl.value.formatToParts(numeric);
+  };
+  return {
+    intl,
+    format,
+    formatToParts
+  };
+}

package/dist/src/composables/NumberFormat/number-format.composable.d.ts

@@ -0,0 +1,33 @@
+import { type ComputedRef, type MaybeRefOrGetter } from 'vue';
+import type { IUseNumberFormatOptions } from '../../interfaces';
+/**
+ * Test helper — clears the module-level LRU. Exposed for the unit-test
+ * suite (cache-hit assertion) and not advertised in the public docs.
+ */
+export declare function __clearNumberFormatCache(): void;
+/**
+ * Headless number-formatting composable. Wraps `Intl.NumberFormat` with
+ * an LRU cache, reactive locale resolution, and convenience format
+ * dialects (`currency` / `percent` / `unit` / `compact` / `scientific`
+ * / `engineering`).
+ *
+ * The composable accepts options as a plain object OR as ref-like
+ * sources (refs / getters), so the same primitive backs both the
+ * `<OrigamNumberFormat>` SFC and ad-hoc callers (e.g. a Pinia store
+ * that formats numbers for a non-Vue consumer).
+ *
+ * @example
+ * ```ts
+ * const { format, formatToParts } = useNumberFormat({
+ *     locale: 'fr-FR',
+ *     format: 'currency',
+ *     currency: 'EUR'
+ * })
+ * format(1234.5) // → "1 234,50 €"
+ * ```
+ */
+export declare function useNumberFormat(options?: MaybeRefOrGetter<IUseNumberFormatOptions>): {
+    intl: ComputedRef<Intl.NumberFormat>;
+    format: (value: number | string) => string;
+    formatToParts: (value: number | string) => Intl.NumberFormatPart[];
+};

package/dist/src/composables/NumberFormat/number-format.composable.js

@@ -0,0 +1,146 @@
+import {
+  computed,
+  isRef,
+  toValue
+} from "vue";
+import {
+  NUMBER_FORMAT_DEFAULT_CURRENCY,
+  NUMBER_FORMAT_FALLBACK_LOCALE,
+  NUMBER_FORMAT_LRU_CAPACITY
+} from "../../consts/NumberFormat/number-format.const.js";
+const intlCache = /* @__PURE__ */ new Map();
+function resolveLocale(locale) {
+  if (Array.isArray(locale) && locale.length > 0) return locale;
+  if (typeof locale === "string" && locale.length > 0 && locale !== "auto") return locale;
+  if (typeof document !== "undefined") {
+    const htmlLang = document.documentElement?.lang;
+    if (htmlLang) return htmlLang;
+  }
+  if (typeof navigator !== "undefined" && typeof navigator.language === "string" && navigator.language.length > 0) {
+    return navigator.language;
+  }
+  return NUMBER_FORMAT_FALLBACK_LOCALE;
+}
+function resolveUseGrouping(value) {
+  if (value === void 0) return void 0;
+  if (typeof value === "boolean") return value;
+  return value;
+}
+function resolveStyleAndNotation(format) {
+  switch (format) {
+    case "currency":
+      return { style: "currency" };
+    case "percent":
+      return { style: "percent" };
+    case "unit":
+      return { style: "unit" };
+    case "compact":
+      return { style: "decimal", notation: "compact" };
+    case "scientific":
+      return { style: "decimal", notation: "scientific" };
+    case "engineering":
+      return { style: "decimal", notation: "engineering" };
+    case "decimal":
+    case void 0:
+    default:
+      return { style: "decimal" };
+  }
+}
+function buildIntlOptions(options) {
+  const intl = {};
+  const base = resolveStyleAndNotation(options.format);
+  Object.assign(intl, base);
+  if (options.notation !== void 0) {
+    intl.notation = options.notation;
+  }
+  if (intl.style === "currency") {
+    intl.currency = options.currency || NUMBER_FORMAT_DEFAULT_CURRENCY;
+    if (options.currencyDisplay !== void 0) {
+      intl.currencyDisplay = options.currencyDisplay;
+    }
+  }
+  if (intl.style === "unit") {
+    if (options.unit) {
+      intl.unit = options.unit;
+      if (options.unitDisplay !== void 0) {
+        intl.unitDisplay = options.unitDisplay;
+      }
+    } else {
+      if (typeof console !== "undefined") {
+        console.warn('[origam] useNumberFormat: format="unit" requires a `unit` option (e.g. "kilometer-per-hour"). Falling back to decimal.');
+      }
+      intl.style = "decimal";
+    }
+  }
+  if (intl.notation === "compact" && options.compactDisplay !== void 0) {
+    intl.compactDisplay = options.compactDisplay;
+  }
+  if (options.minimumFractionDigits !== void 0) intl.minimumFractionDigits = options.minimumFractionDigits;
+  if (options.maximumFractionDigits !== void 0) intl.maximumFractionDigits = options.maximumFractionDigits;
+  if (options.minimumSignificantDigits !== void 0) intl.minimumSignificantDigits = options.minimumSignificantDigits;
+  if (options.maximumSignificantDigits !== void 0) intl.maximumSignificantDigits = options.maximumSignificantDigits;
+  const grouping = resolveUseGrouping(options.useGrouping);
+  if (grouping !== void 0) {
+    intl.useGrouping = grouping;
+  }
+  if (options.signDisplay !== void 0) {
+    intl.signDisplay = options.signDisplay;
+  }
+  return intl;
+}
+function getIntl(locale, options) {
+  const cacheKey = JSON.stringify({ l: locale, o: options });
+  const hit = intlCache.get(cacheKey);
+  if (hit !== void 0) {
+    intlCache.delete(cacheKey);
+    intlCache.set(cacheKey, hit);
+    return hit;
+  }
+  const fresh = new Intl.NumberFormat(locale, options);
+  intlCache.set(cacheKey, fresh);
+  if (intlCache.size > NUMBER_FORMAT_LRU_CAPACITY) {
+    const oldest = intlCache.keys().next().value;
+    if (oldest !== void 0) {
+      intlCache.delete(oldest);
+    }
+  }
+  return fresh;
+}
+function coerceValue(value) {
+  if (typeof value === "number") return value;
+  if (typeof value === "string" && value.length > 0) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+  }
+  return 0;
+}
+export function __clearNumberFormatCache() {
+  intlCache.clear();
+}
+export function useNumberFormat(options = {}) {
+  const normalisedOptions = computed(() => {
+    if (isRef(options) || typeof options === "function") {
+      return toValue(options) ?? {};
+    }
+    return options;
+  });
+  const intl = computed(() => {
+    const opts = normalisedOptions.value;
+    const locale = resolveLocale(opts.locale);
+    const intlOptions = buildIntlOptions(opts);
+    return getIntl(locale, intlOptions);
+  });
+  const format = (value) => {
+    const numeric = coerceValue(value);
+    return intl.value.format(numeric);
+  };
+  const formatToParts = (value) => {
+    const numeric = coerceValue(value);
+    return intl.value.formatToParts(numeric);
+  };
+  return {
+    intl,
+    format,
+    formatToParts
+  };
+}

package/dist/src/composables/QrCode/qr-code.composable.cjs

@@ -0,0 +1,111 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.__clearQrCodeCache = __clearQrCodeCache;
+exports.useQrCode = useQrCode;
+var _qrcodeGenerator = _interopRequireDefault(require("qrcode-generator"));
+var _vue = require("vue");
+var _qrCode = require("../../consts/QrCode/qr-code.const.cjs");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const matrixCache = /* @__PURE__ */new Map();
+function buildMatrix(value, ecc) {
+  const cacheKey = `${ecc}::${value}`;
+  const hit = matrixCache.get(cacheKey);
+  if (hit !== void 0) {
+    matrixCache.delete(cacheKey);
+    matrixCache.set(cacheKey, hit);
+    return hit;
+  }
+  const qr = (0, _qrcodeGenerator.default)(0, ecc);
+  qr.addData(value);
+  qr.make();
+  const count = qr.getModuleCount();
+  const matrix = [];
+  for (let row = 0; row < count; row++) {
+    const line = [];
+    for (let col = 0; col < count; col++) {
+      line.push(qr.isDark(row, col));
+    }
+    matrix.push(line);
+  }
+  matrixCache.set(cacheKey, matrix);
+  if (matrixCache.size > _qrCode.QR_CODE_LRU_CAPACITY) {
+    const oldest = matrixCache.keys().next().value;
+    if (oldest !== void 0) {
+      matrixCache.delete(oldest);
+    }
+  }
+  return matrix;
+}
+function escapeXmlAttr(raw) {
+  return raw.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function buildSvg(matrix, options) {
+  const count = matrix.length;
+  const viewSize = count + options.margin * 2;
+  const fg = escapeXmlAttr(options.foreground);
+  const bg = options.background;
+  const radiusAttr = options.cornerRadius > 0 ? ` rx="${options.cornerRadius}" ry="${options.cornerRadius}"` : "";
+  let rects = "";
+  for (let row = 0; row < count; row++) {
+    for (let col = 0; col < count; col++) {
+      if (matrix[row][col]) {
+        const x = col + options.margin;
+        const y = row + options.margin;
+        rects += `<rect x="${x}" y="${y}" width="1" height="1" fill="${fg}"${radiusAttr}/>`;
+      }
+    }
+  }
+  const backgroundRect = bg && bg !== "transparent" ? `<rect x="0" y="0" width="${viewSize}" height="${viewSize}" fill="${escapeXmlAttr(bg)}"/>` : "";
+  let logoMarkup = "";
+  if (options.logo && options.logo.src) {
+    const ratio = options.logo.size ?? _qrCode.QR_CODE_DEFAULT_LOGO_SIZE;
+    const padding = options.logo.padding ?? _qrCode.QR_CODE_DEFAULT_LOGO_PADDING;
+    const logoBg = options.logo.background ?? (bg && bg !== "transparent" ? bg : "#ffffff");
+    const logoBoxSize = count * ratio;
+    const logoX = options.margin + (count - logoBoxSize) / 2;
+    const logoY = options.margin + (count - logoBoxSize) / 2;
+    const paddingUnits = padding / 16;
+    const bdX = logoX - paddingUnits;
+    const bdY = logoY - paddingUnits;
+    const bdSize = logoBoxSize + paddingUnits * 2;
+    logoMarkup += `<rect x="${bdX}" y="${bdY}" width="${bdSize}" height="${bdSize}" fill="${escapeXmlAttr(logoBg)}"/>`;
+    logoMarkup += `<image href="${escapeXmlAttr(options.logo.src)}" x="${logoX}" y="${logoY}" width="${logoBoxSize}" height="${logoBoxSize}" preserveAspectRatio="xMidYMid meet"/>`;
+  }
+  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${viewSize} ${viewSize}" shape-rendering="crispEdges" preserveAspectRatio="xMidYMid meet">${backgroundRect}${rects}${logoMarkup}</svg>`;
+}
+function __clearQrCodeCache() {
+  matrixCache.clear();
+}
+function useQrCode(value, options = {}) {
+  const normalisedValue = (0, _vue.computed)(() => {
+    const resolved = (0, _vue.isRef)(value) || typeof value === "function" ? (0, _vue.toValue)(value) : value;
+    return typeof resolved === "string" ? resolved : String(resolved ?? "");
+  });
+  const normalisedOptions = (0, _vue.computed)(() => {
+    const raw = (0, _vue.isRef)(options) || typeof options === "function" ? (0, _vue.toValue)(options) : options;
+    const opts = raw ?? {};
+    const ratio = opts.logo?.size ?? _qrCode.QR_CODE_DEFAULT_LOGO_SIZE;
+    if (opts.logo?.src && ratio > _qrCode.QR_CODE_OVERLAY_MAX_RATIO && typeof console !== "undefined") {
+      console.warn(`[origam] useQrCode: logo size ${ratio} exceeds the recommended max (${_qrCode.QR_CODE_OVERLAY_MAX_RATIO}). Scanners may fail to decode the matrix; consider increasing error-correction to "H" or shrinking the logo.`);
+    }
+    return {
+      errorCorrectionLevel: opts.errorCorrectionLevel ?? _qrCode.QR_CODE_DEFAULT_ECC,
+      foreground: opts.foreground ?? "currentColor",
+      background: opts.background ?? "transparent",
+      margin: typeof opts.margin === "number" ? opts.margin : _qrCode.QR_CODE_DEFAULT_MARGIN,
+      cornerRadius: typeof opts.cornerRadius === "number" ? opts.cornerRadius : 0,
+      logo: opts.logo
+    };
+  });
+  const modules = (0, _vue.computed)(() => buildMatrix(normalisedValue.value, normalisedOptions.value.errorCorrectionLevel));
+  const size = (0, _vue.computed)(() => modules.value.length);
+  const svg = (0, _vue.computed)(() => buildSvg(modules.value, normalisedOptions.value));
+  return {
+    svg,
+    modules,
+    size
+  };
+}

package/dist/src/composables/QrCode/qr-code.composable.d.ts

@@ -0,0 +1,31 @@
+import { type ComputedRef, type MaybeRefOrGetter } from 'vue';
+import type { IUseQrCodeOptions } from '../../interfaces';
+/**
+ * Test helper — clears the module-level matrix LRU. Exposed for the
+ * unit-test suite and not advertised publicly.
+ */
+export declare function __clearQrCodeCache(): void;
+/**
+ * Headless QR-code composable. Encodes `value` through
+ * `qrcode-generator` (Reed-Solomon + matrix masking handled by the
+ * library) and rebuilds an SVG fragment on every reactive change.
+ *
+ * The composable is SSR-safe — no DOM API is touched, the encoder is
+ * pure JS, and the SVG string is suitable for `v-html` on both client
+ * and server.
+ *
+ * @example
+ * ```ts
+ * const value = ref('https://origam.dev')
+ * const { svg, modules, size } = useQrCode(value, {
+ *     errorCorrectionLevel: 'M',
+ *     foreground: '#000',
+ *     background: '#fff'
+ * })
+ * ```
+ */
+export declare function useQrCode(value: MaybeRefOrGetter<string>, options?: MaybeRefOrGetter<IUseQrCodeOptions>): {
+    svg: ComputedRef<string>;
+    modules: ComputedRef<boolean[][]>;
+    size: ComputedRef<number>;
+};

package/dist/src/composables/QrCode/qr-code.composable.js

@@ -0,0 +1,120 @@
+import qrcode from "qrcode-generator";
+import {
+  computed,
+  isRef,
+  toValue
+} from "vue";
+import {
+  QR_CODE_DEFAULT_ECC,
+  QR_CODE_DEFAULT_LOGO_PADDING,
+  QR_CODE_DEFAULT_LOGO_SIZE,
+  QR_CODE_DEFAULT_MARGIN,
+  QR_CODE_LRU_CAPACITY,
+  QR_CODE_OVERLAY_MAX_RATIO
+} from "../../consts/QrCode/qr-code.const.js";
+const matrixCache = /* @__PURE__ */ new Map();
+function buildMatrix(value, ecc) {
+  const cacheKey = `${ecc}::${value}`;
+  const hit = matrixCache.get(cacheKey);
+  if (hit !== void 0) {
+    matrixCache.delete(cacheKey);
+    matrixCache.set(cacheKey, hit);
+    return hit;
+  }
+  const qr = qrcode(0, ecc);
+  qr.addData(value);
+  qr.make();
+  const count = qr.getModuleCount();
+  const matrix = [];
+  for (let row = 0; row < count; row++) {
+    const line = [];
+    for (let col = 0; col < count; col++) {
+      line.push(qr.isDark(row, col));
+    }
+    matrix.push(line);
+  }
+  matrixCache.set(cacheKey, matrix);
+  if (matrixCache.size > QR_CODE_LRU_CAPACITY) {
+    const oldest = matrixCache.keys().next().value;
+    if (oldest !== void 0) {
+      matrixCache.delete(oldest);
+    }
+  }
+  return matrix;
+}
+function escapeXmlAttr(raw) {
+  return raw.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function buildSvg(matrix, options) {
+  const count = matrix.length;
+  const viewSize = count + options.margin * 2;
+  const fg = escapeXmlAttr(options.foreground);
+  const bg = options.background;
+  const radiusAttr = options.cornerRadius > 0 ? ` rx="${options.cornerRadius}" ry="${options.cornerRadius}"` : "";
+  let rects = "";
+  for (let row = 0; row < count; row++) {
+    for (let col = 0; col < count; col++) {
+      if (matrix[row][col]) {
+        const x = col + options.margin;
+        const y = row + options.margin;
+        rects += `<rect x="${x}" y="${y}" width="1" height="1" fill="${fg}"${radiusAttr}/>`;
+      }
+    }
+  }
+  const backgroundRect = bg && bg !== "transparent" ? `<rect x="0" y="0" width="${viewSize}" height="${viewSize}" fill="${escapeXmlAttr(bg)}"/>` : "";
+  let logoMarkup = "";
+  if (options.logo && options.logo.src) {
+    const ratio = options.logo.size ?? QR_CODE_DEFAULT_LOGO_SIZE;
+    const padding = options.logo.padding ?? QR_CODE_DEFAULT_LOGO_PADDING;
+    const logoBg = options.logo.background ?? (bg && bg !== "transparent" ? bg : "#ffffff");
+    const logoBoxSize = count * ratio;
+    const logoX = options.margin + (count - logoBoxSize) / 2;
+    const logoY = options.margin + (count - logoBoxSize) / 2;
+    const paddingUnits = padding / 16;
+    const bdX = logoX - paddingUnits;
+    const bdY = logoY - paddingUnits;
+    const bdSize = logoBoxSize + paddingUnits * 2;
+    logoMarkup += `<rect x="${bdX}" y="${bdY}" width="${bdSize}" height="${bdSize}" fill="${escapeXmlAttr(logoBg)}"/>`;
+    logoMarkup += `<image href="${escapeXmlAttr(options.logo.src)}" x="${logoX}" y="${logoY}" width="${logoBoxSize}" height="${logoBoxSize}" preserveAspectRatio="xMidYMid meet"/>`;
+  }
+  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${viewSize} ${viewSize}" shape-rendering="crispEdges" preserveAspectRatio="xMidYMid meet">${backgroundRect}${rects}${logoMarkup}</svg>`;
+}
+export function __clearQrCodeCache() {
+  matrixCache.clear();
+}
+export function useQrCode(value, options = {}) {
+  const normalisedValue = computed(() => {
+    const resolved = isRef(value) || typeof value === "function" ? toValue(value) : value;
+    return typeof resolved === "string" ? resolved : String(resolved ?? "");
+  });
+  const normalisedOptions = computed(() => {
+    const raw = isRef(options) || typeof options === "function" ? toValue(options) : options;
+    const opts = raw ?? {};
+    const ratio = opts.logo?.size ?? QR_CODE_DEFAULT_LOGO_SIZE;
+    if (opts.logo?.src && ratio > QR_CODE_OVERLAY_MAX_RATIO && typeof console !== "undefined") {
+      console.warn(
+        `[origam] useQrCode: logo size ${ratio} exceeds the recommended max (${QR_CODE_OVERLAY_MAX_RATIO}). Scanners may fail to decode the matrix; consider increasing error-correction to "H" or shrinking the logo.`
+      );
+    }
+    return {
+      errorCorrectionLevel: opts.errorCorrectionLevel ?? QR_CODE_DEFAULT_ECC,
+      foreground: opts.foreground ?? "currentColor",
+      background: opts.background ?? "transparent",
+      margin: typeof opts.margin === "number" ? opts.margin : QR_CODE_DEFAULT_MARGIN,
+      cornerRadius: typeof opts.cornerRadius === "number" ? opts.cornerRadius : 0,
+      logo: opts.logo
+    };
+  });
+  const modules = computed(
+    () => buildMatrix(normalisedValue.value, normalisedOptions.value.errorCorrectionLevel)
+  );
+  const size = computed(() => modules.value.length);
+  const svg = computed(
+    () => buildSvg(modules.value, normalisedOptions.value)
+  );
+  return {
+    svg,
+    modules,
+    size
+  };
+}

package/dist/src/composables/Sheet/sheetSwipe.composable.cjs

@@ -6,13 +6,13 @@ Object.defineProperty(exports, "__esModule", {
 Object.defineProperty(exports, "DEFAULT_SHEET_SNAP_POINTS", {
   enumerable: true,
   get: function () {
-    return _consts.DEFAULT_SHEET_SNAP_POINTS;
+    return _sheetSnapPoints.DEFAULT_SHEET_SNAP_POINTS;
   }
 });
 exports.useSheetSwipe = useSheetSwipe;
 var _vue = require("vue");
-var _consts = require("../../consts/index.cjs");
-const FAST_FLICK_THRESHOLD = 0.5;
+var _sheetSnapPoints = require("../../consts/Sheet/sheet-snap-points.const.cjs");
+var _sheetSwipe = require("../../consts/Sheet/sheet-swipe.const.cjs");
 function resolveHeightPx(height) {
   if (typeof height === "number") return height;
   if (typeof window === "undefined") return 0;
@@ -54,7 +54,7 @@ function useSheetSwipe(options) {
     persistent
   } = options;
   const sortedSnaps = (0, _vue.computed)(() => {
-    const src = snapPoints?.value ?? _consts.DEFAULT_SHEET_SNAP_POINTS;
+    const src = snapPoints?.value ?? _sheetSnapPoints.DEFAULT_SHEET_SNAP_POINTS;
     return [...src].sort((a, b) => resolveHeightPx(a.height) - resolveHeightPx(b.height));
   });
   const currentSnap = (0, _vue.ref)(defaultSnap?.value ?? "half");
@@ -78,7 +78,7 @@ function useSheetSwipe(options) {
     const goingUp = velocity > 0;
     const goingDown = velocity < 0;
     const speed = Math.abs(velocity);
-    if (speed >= FAST_FLICK_THRESHOLD) {
+    if (speed >= _sheetSwipe.SHEET_FAST_FLICK_THRESHOLD) {
       const nextIdx = goingUp ? Math.min(snaps.length - 1, currentIdx + 1) : goingDown ? Math.max(0, currentIdx - 1) : currentIdx;
       const candidate = snaps[nextIdx];
       return enforcePersistent(candidate.id, snaps);

package/dist/src/composables/Sheet/sheetSwipe.composable.d.ts

@@ -1,5 +1,5 @@
 import type { ISheetSwipeOptions, ISheetSwipeReturn } from '../../interfaces';
-export { DEFAULT_SHEET_SNAP_POINTS } from '../../consts';
+export { DEFAULT_SHEET_SNAP_POINTS } from '../../consts/Sheet/sheet-snap-points.const';
 /**
  * Bottom-sheet swipe gesture composable.
  *

package/dist/src/composables/Sheet/sheetSwipe.composable.js

@@ -6,9 +6,9 @@ import {
   shallowRef,
   watch
 } from "vue";
-import { DEFAULT_SHEET_SNAP_POINTS } from "../../consts/index.js";
-export { DEFAULT_SHEET_SNAP_POINTS } from "../../consts/index.js";
-const FAST_FLICK_THRESHOLD = 0.5;
+import { DEFAULT_SHEET_SNAP_POINTS } from "../../consts/Sheet/sheet-snap-points.const.js";
+import { SHEET_FAST_FLICK_THRESHOLD as FAST_FLICK_THRESHOLD } from "../../consts/Sheet/sheet-swipe.const.js";
+export { DEFAULT_SHEET_SNAP_POINTS } from "../../consts/Sheet/sheet-snap-points.const.js";
 function resolveHeightPx(height) {
   if (typeof height === "number") return height;
   if (typeof window === "undefined") return 0;