@eristack/percent 0.1.1 → 0.1.2

package/dist/chunk-MW4KRZDX.js

@@ -0,0 +1,83 @@
+// src/core/percent.ts
+import Decimal from "decimal.js";
+var PercentParseError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PercentParseError";
+  }
+};
+function normalizeRatio(ratio) {
+  if (ratio.isNegative()) {
+    throw new PercentParseError("Percent ratio cannot be negative");
+  }
+  return { ratio: ratio.toFixed() };
+}
+function parsePercent(input) {
+  if (typeof input === "string") {
+    const trimmed = input.trim();
+    if (!trimmed) {
+      throw new PercentParseError("Percent input cannot be empty");
+    }
+    try {
+      if (trimmed.endsWith("%")) {
+        const n = trimmed.slice(0, -1).trim();
+        if (!n) throw new PercentParseError('Percent symbol missing value before "%"');
+        return normalizeRatio(new Decimal(n).div(100));
+      }
+      return normalizeRatio(new Decimal(trimmed));
+    } catch (err) {
+      if (err instanceof PercentParseError) throw err;
+      throw new PercentParseError(`Invalid percent "${input}"`);
+    }
+  }
+  switch (input.kind) {
+    case "ratio":
+      return normalizeRatio(new Decimal(input.value));
+    case "percent":
+      return normalizeRatio(new Decimal(input.value).div(100));
+    case "basisPoints":
+      return normalizeRatio(new Decimal(input.value).div(1e4));
+    default: {
+      const _exhaustive = input;
+      throw new PercentParseError(`Unknown percent input ${String(_exhaustive)}`);
+    }
+  }
+}
+function fromBasisPoints(bps) {
+  return parsePercent({ kind: "basisPoints", value: bps });
+}
+function fromPercentSymbol(value) {
+  return parsePercent({ kind: "percent", value });
+}
+function toBasisPoints(p) {
+  return new Decimal(p.ratio).times(1e4).toFixed(0);
+}
+function toPercentSymbol(p) {
+  return `${new Decimal(p.ratio).times(100).toFixed()}%`;
+}
+function percentOf(amount, percent) {
+  return new Decimal(amount).times(percent.ratio).toFixed();
+}
+function plusPercent(amount, percent) {
+  return new Decimal(amount).times(new Decimal(1).plus(percent.ratio)).toFixed();
+}
+function minusPercent(amount, percent) {
+  return new Decimal(amount).times(new Decimal(1).minus(percent.ratio)).toFixed();
+}
+function addPercents(a, b) {
+  return { ratio: new Decimal(a.ratio).plus(b.ratio).toFixed() };
+}
+
+export {
+  PercentParseError,
+  parsePercent,
+  fromBasisPoints,
+  fromPercentSymbol,
+  toBasisPoints,
+  toPercentSymbol,
+  percentOf,
+  plusPercent,
+  minusPercent,
+  addPercents
+};
+//# sourceMappingURL=chunk-MW4KRZDX.js.map

package/dist/chunk-MW4KRZDX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/percent.ts"],"sourcesContent":["import Decimal from \"decimal.js\";\nimport type { Percent, PercentInput } from \"./types.js\";\n\nexport class PercentParseError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"PercentParseError\";\n  }\n}\n\nfunction normalizeRatio(ratio: Decimal): Percent {\n  if (ratio.isNegative()) {\n    throw new PercentParseError(\"Percent ratio cannot be negative\");\n  }\n  return { ratio: ratio.toFixed() };\n}\n\n/** Parse \"11%\", \"0.11\", or basis points via PercentInput. */\nexport function parsePercent(input: PercentInput | string): Percent {\n  if (typeof input === \"string\") {\n    const trimmed = input.trim();\n    if (!trimmed) {\n      throw new PercentParseError(\"Percent input cannot be empty\");\n    }\n    try {\n      if (trimmed.endsWith(\"%\")) {\n        const n = trimmed.slice(0, -1).trim();\n        if (!n) throw new PercentParseError('Percent symbol missing value before \"%\"');\n        return normalizeRatio(new Decimal(n).div(100));\n      }\n      return normalizeRatio(new Decimal(trimmed));\n    } catch (err) {\n      if (err instanceof PercentParseError) throw err;\n      throw new PercentParseError(`Invalid percent \"${input}\"`);\n    }\n  }\n  switch (input.kind) {\n    case \"ratio\":\n      return normalizeRatio(new Decimal(input.value));\n    case \"percent\":\n      return normalizeRatio(new Decimal(input.value).div(100));\n    case \"basisPoints\":\n      return normalizeRatio(new Decimal(input.value).div(10_000));\n    default: {\n      const _exhaustive: never = input;\n      throw new PercentParseError(`Unknown percent input ${String(_exhaustive)}`);\n    }\n  }\n}\n\nexport function fromBasisPoints(bps: string): Percent {\n  return parsePercent({ kind: \"basisPoints\", value: bps });\n}\n\nexport function fromPercentSymbol(value: string): Percent {\n  return parsePercent({ kind: \"percent\", value });\n}\n\nexport function toBasisPoints(p: Percent): string {\n  return new Decimal(p.ratio).times(10_000).toFixed(0);\n}\n\nexport function toPercentSymbol(p: Percent): string {\n  return `${new Decimal(p.ratio).times(100).toFixed()}%`;\n}\n\n/** amount * ratio — both decimal strings. */\nexport function percentOf(amount: string, percent: Percent): string {\n  return new Decimal(amount).times(percent.ratio).toFixed();\n}\n\nexport function plusPercent(amount: string, percent: Percent): string {\n  return new Decimal(amount).times(new Decimal(1).plus(percent.ratio)).toFixed();\n}\n\nexport function minusPercent(amount: string, percent: Percent): string {\n  return new Decimal(amount).times(new Decimal(1).minus(percent.ratio)).toFixed();\n}\n\nexport function addPercents(a: Percent, b: Percent): Percent {\n  return { ratio: new Decimal(a.ratio).plus(b.ratio).toFixed() };\n}\n"],"mappings":";AAAA,OAAO,aAAa;AAGb,IAAM,oBAAN,cAAgC,MAAM;AAAA,EAC3C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEA,SAAS,eAAe,OAAyB;AAC/C,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,kBAAkB,kCAAkC;AAAA,EAChE;AACA,SAAO,EAAE,OAAO,MAAM,QAAQ,EAAE;AAClC;AAGO,SAAS,aAAa,OAAuC;AAClE,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,kBAAkB,+BAA+B;AAAA,IAC7D;AACA,QAAI;AACF,UAAI,QAAQ,SAAS,GAAG,GAAG;AACzB,cAAM,IAAI,QAAQ,MAAM,GAAG,EAAE,EAAE,KAAK;AACpC,YAAI,CAAC,EAAG,OAAM,IAAI,kBAAkB,yCAAyC;AAC7E,eAAO,eAAe,IAAI,QAAQ,CAAC,EAAE,IAAI,GAAG,CAAC;AAAA,MAC/C;AACA,aAAO,eAAe,IAAI,QAAQ,OAAO,CAAC;AAAA,IAC5C,SAAS,KAAK;AACZ,UAAI,eAAe,kBAAmB,OAAM;AAC5C,YAAM,IAAI,kBAAkB,oBAAoB,KAAK,GAAG;AAAA,IAC1D;AAAA,EACF;AACA,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO,eAAe,IAAI,QAAQ,MAAM,KAAK,CAAC;AAAA,IAChD,KAAK;AACH,aAAO,eAAe,IAAI,QAAQ,MAAM,KAAK,EAAE,IAAI,GAAG,CAAC;AAAA,IACzD,KAAK;AACH,aAAO,eAAe,IAAI,QAAQ,MAAM,KAAK,EAAE,IAAI,GAAM,CAAC;AAAA,IAC5D,SAAS;AACP,YAAM,cAAqB;AAC3B,YAAM,IAAI,kBAAkB,yBAAyB,OAAO,WAAW,CAAC,EAAE;AAAA,IAC5E;AAAA,EACF;AACF;AAEO,SAAS,gBAAgB,KAAsB;AACpD,SAAO,aAAa,EAAE,MAAM,eAAe,OAAO,IAAI,CAAC;AACzD;AAEO,SAAS,kBAAkB,OAAwB;AACxD,SAAO,aAAa,EAAE,MAAM,WAAW,MAAM,CAAC;AAChD;AAEO,SAAS,cAAc,GAAoB;AAChD,SAAO,IAAI,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAM,EAAE,QAAQ,CAAC;AACrD;AAEO,SAAS,gBAAgB,GAAoB;AAClD,SAAO,GAAG,IAAI,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,EAAE,QAAQ,CAAC;AACrD;AAGO,SAAS,UAAU,QAAgB,SAA0B;AAClE,SAAO,IAAI,QAAQ,MAAM,EAAE,MAAM,QAAQ,KAAK,EAAE,QAAQ;AAC1D;AAEO,SAAS,YAAY,QAAgB,SAA0B;AACpE,SAAO,IAAI,QAAQ,MAAM,EAAE,MAAM,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,KAAK,CAAC,EAAE,QAAQ;AAC/E;AAEO,SAAS,aAAa,QAAgB,SAA0B;AACrE,SAAO,IAAI,QAAQ,MAAM,EAAE,MAAM,IAAI,QAAQ,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE,QAAQ;AAChF;AAEO,SAAS,YAAY,GAAY,GAAqB;AAC3D,SAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE;AAC/D;","names":[]}

package/dist/index.js

@@ -1,72 +1,15 @@
-// src/core/percent.ts
-import Decimal from "decimal.js";
-var PercentParseError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "PercentParseError";
-  }
-};
-function normalizeRatio(ratio) {
-  if (ratio.isNegative()) {
-    throw new PercentParseError("Percent ratio cannot be negative");
-  }
-  return { ratio: ratio.toFixed() };
-}
-function parsePercent(input) {
-  if (typeof input === "string") {
-    const trimmed = input.trim();
-    if (!trimmed) {
-      throw new PercentParseError("Percent input cannot be empty");
-    }
-    try {
-      if (trimmed.endsWith("%")) {
-        const n = trimmed.slice(0, -1).trim();
-        if (!n) throw new PercentParseError('Percent symbol missing value before "%"');
-        return normalizeRatio(new Decimal(n).div(100));
-      }
-      return normalizeRatio(new Decimal(trimmed));
-    } catch (err) {
-      if (err instanceof PercentParseError) throw err;
-      throw new PercentParseError(`Invalid percent "${input}"`);
-    }
-  }
-  switch (input.kind) {
-    case "ratio":
-      return normalizeRatio(new Decimal(input.value));
-    case "percent":
-      return normalizeRatio(new Decimal(input.value).div(100));
-    case "basisPoints":
-      return normalizeRatio(new Decimal(input.value).div(1e4));
-    default: {
-      const _exhaustive = input;
-      throw new PercentParseError(`Unknown percent input ${String(_exhaustive)}`);
-    }
-  }
-}
-function fromBasisPoints(bps) {
-  return parsePercent({ kind: "basisPoints", value: bps });
-}
-function fromPercentSymbol(value) {
-  return parsePercent({ kind: "percent", value });
-}
-function toBasisPoints(p) {
-  return new Decimal(p.ratio).times(1e4).toFixed(0);
-}
-function toPercentSymbol(p) {
-  return `${new Decimal(p.ratio).times(100).toFixed()}%`;
-}
-function percentOf(amount, percent) {
-  return new Decimal(amount).times(percent.ratio).toFixed();
-}
-function plusPercent(amount, percent) {
-  return new Decimal(amount).times(new Decimal(1).plus(percent.ratio)).toFixed();
-}
-function minusPercent(amount, percent) {
-  return new Decimal(amount).times(new Decimal(1).minus(percent.ratio)).toFixed();
-}
-function addPercents(a, b) {
-  return { ratio: new Decimal(a.ratio).plus(b.ratio).toFixed() };
-}
+import {
+  PercentParseError,
+  addPercents,
+  fromBasisPoints,
+  fromPercentSymbol,
+  minusPercent,
+  parsePercent,
+  percentOf,
+  plusPercent,
+  toBasisPoints,
+  toPercentSymbol
+} from "./chunk-MW4KRZDX.js";
 export {
   PercentParseError,
   addPercents,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/percent.ts"],"sourcesContent":["import Decimal from \"decimal.js\";\nimport type { Percent, PercentInput } from \"./types.js\";\n\nexport class PercentParseError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"PercentParseError\";\n  }\n}\n\nfunction normalizeRatio(ratio: Decimal): Percent {\n  if (ratio.isNegative()) {\n    throw new PercentParseError(\"Percent ratio cannot be negative\");\n  }\n  return { ratio: ratio.toFixed() };\n}\n\n/** Parse \"11%\", \"0.11\", or basis points via PercentInput. */\nexport function parsePercent(input: PercentInput | string): Percent {\n  if (typeof input === \"string\") {\n    const trimmed = input.trim();\n    if (!trimmed) {\n      throw new PercentParseError(\"Percent input cannot be empty\");\n    }\n    try {\n      if (trimmed.endsWith(\"%\")) {\n        const n = trimmed.slice(0, -1).trim();\n        if (!n) throw new PercentParseError('Percent symbol missing value before \"%\"');\n        return normalizeRatio(new Decimal(n).div(100));\n      }\n      return normalizeRatio(new Decimal(trimmed));\n    } catch (err) {\n      if (err instanceof PercentParseError) throw err;\n      throw new PercentParseError(`Invalid percent \"${input}\"`);\n    }\n  }\n  switch (input.kind) {\n    case \"ratio\":\n      return normalizeRatio(new Decimal(input.value));\n    case \"percent\":\n      return normalizeRatio(new Decimal(input.value).div(100));\n    case \"basisPoints\":\n      return normalizeRatio(new Decimal(input.value).div(10_000));\n    default: {\n      const _exhaustive: never = input;\n      throw new PercentParseError(`Unknown percent input ${String(_exhaustive)}`);\n    }\n  }\n}\n\nexport function fromBasisPoints(bps: string): Percent {\n  return parsePercent({ kind: \"basisPoints\", value: bps });\n}\n\nexport function fromPercentSymbol(value: string): Percent {\n  return parsePercent({ kind: \"percent\", value });\n}\n\nexport function toBasisPoints(p: Percent): string {\n  return new Decimal(p.ratio).times(10_000).toFixed(0);\n}\n\nexport function toPercentSymbol(p: Percent): string {\n  return `${new Decimal(p.ratio).times(100).toFixed()}%`;\n}\n\n/** amount * ratio — both decimal strings. */\nexport function percentOf(amount: string, percent: Percent): string {\n  return new Decimal(amount).times(percent.ratio).toFixed();\n}\n\nexport function plusPercent(amount: string, percent: Percent): string {\n  return new Decimal(amount).times(new Decimal(1).plus(percent.ratio)).toFixed();\n}\n\nexport function minusPercent(amount: string, percent: Percent): string {\n  return new Decimal(amount).times(new Decimal(1).minus(percent.ratio)).toFixed();\n}\n\nexport function addPercents(a: Percent, b: Percent): Percent {\n  return { ratio: new Decimal(a.ratio).plus(b.ratio).toFixed() };\n}\n"],"mappings":";AAAA,OAAO,aAAa;AAGb,IAAM,oBAAN,cAAgC,MAAM;AAAA,EAC3C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEA,SAAS,eAAe,OAAyB;AAC/C,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,kBAAkB,kCAAkC;AAAA,EAChE;AACA,SAAO,EAAE,OAAO,MAAM,QAAQ,EAAE;AAClC;AAGO,SAAS,aAAa,OAAuC;AAClE,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,kBAAkB,+BAA+B;AAAA,IAC7D;AACA,QAAI;AACF,UAAI,QAAQ,SAAS,GAAG,GAAG;AACzB,cAAM,IAAI,QAAQ,MAAM,GAAG,EAAE,EAAE,KAAK;AACpC,YAAI,CAAC,EAAG,OAAM,IAAI,kBAAkB,yCAAyC;AAC7E,eAAO,eAAe,IAAI,QAAQ,CAAC,EAAE,IAAI,GAAG,CAAC;AAAA,MAC/C;AACA,aAAO,eAAe,IAAI,QAAQ,OAAO,CAAC;AAAA,IAC5C,SAAS,KAAK;AACZ,UAAI,eAAe,kBAAmB,OAAM;AAC5C,YAAM,IAAI,kBAAkB,oBAAoB,KAAK,GAAG;AAAA,IAC1D;AAAA,EACF;AACA,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO,eAAe,IAAI,QAAQ,MAAM,KAAK,CAAC;AAAA,IAChD,KAAK;AACH,aAAO,eAAe,IAAI,QAAQ,MAAM,KAAK,EAAE,IAAI,GAAG,CAAC;AAAA,IACzD,KAAK;AACH,aAAO,eAAe,IAAI,QAAQ,MAAM,KAAK,EAAE,IAAI,GAAM,CAAC;AAAA,IAC5D,SAAS;AACP,YAAM,cAAqB;AAC3B,YAAM,IAAI,kBAAkB,yBAAyB,OAAO,WAAW,CAAC,EAAE;AAAA,IAC5E;AAAA,EACF;AACF;AAEO,SAAS,gBAAgB,KAAsB;AACpD,SAAO,aAAa,EAAE,MAAM,eAAe,OAAO,IAAI,CAAC;AACzD;AAEO,SAAS,kBAAkB,OAAwB;AACxD,SAAO,aAAa,EAAE,MAAM,WAAW,MAAM,CAAC;AAChD;AAEO,SAAS,cAAc,GAAoB;AAChD,SAAO,IAAI,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAM,EAAE,QAAQ,CAAC;AACrD;AAEO,SAAS,gBAAgB,GAAoB;AAClD,SAAO,GAAG,IAAI,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,EAAE,QAAQ,CAAC;AACrD;AAGO,SAAS,UAAU,QAAgB,SAA0B;AAClE,SAAO,IAAI,QAAQ,MAAM,EAAE,MAAM,QAAQ,KAAK,EAAE,QAAQ;AAC1D;AAEO,SAAS,YAAY,QAAgB,SAA0B;AACpE,SAAO,IAAI,QAAQ,MAAM,EAAE,MAAM,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,KAAK,CAAC,EAAE,QAAQ;AAC/E;AAEO,SAAS,aAAa,QAAgB,SAA0B;AACrE,SAAO,IAAI,QAAQ,MAAM,EAAE,MAAM,IAAI,QAAQ,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE,QAAQ;AAChF;AAEO,SAAS,YAAY,GAAY,GAAqB;AAC3D,SAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE;AAC/D;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/react/fields/use-percent-field.d.ts

@@ -0,0 +1,16 @@
+import { type ChangeEvent } from "react";
+export type UsePercentFieldOptions = {
+    value: string;
+    onChange: (next: string) => void;
+    required?: boolean;
+};
+export declare function usePercentField(options: UsePercentFieldOptions): {
+    error: string | undefined;
+    inputProps: {
+        value: string;
+        onChange: (e: ChangeEvent<HTMLInputElement>) => void;
+        onBlur: () => void;
+    };
+    clearError: () => void;
+};
+//# sourceMappingURL=use-percent-field.d.ts.map

package/dist/react/fields/use-percent-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-percent-field.d.ts","sourceRoot":"","sources":["../../../src/react/fields/use-percent-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AAGhE,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB;;;;sBAsB7C,WAAW,CAAC,gBAAgB,CAAC;;;;EAS9C"}

package/dist/react/index.cjs

@@ -0,0 +1,120 @@
+"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/react/index.ts
+var react_exports = {};
+__export(react_exports, {
+  usePercentField: () => usePercentField
+});
+module.exports = __toCommonJS(react_exports);
+
+// src/react/fields/use-percent-field.ts
+var import_react = require("react");
+
+// src/core/percent.ts
+var import_decimal = __toESM(require("decimal.js"), 1);
+var PercentParseError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PercentParseError";
+  }
+};
+function normalizeRatio(ratio) {
+  if (ratio.isNegative()) {
+    throw new PercentParseError("Percent ratio cannot be negative");
+  }
+  return { ratio: ratio.toFixed() };
+}
+function parsePercent(input) {
+  if (typeof input === "string") {
+    const trimmed = input.trim();
+    if (!trimmed) {
+      throw new PercentParseError("Percent input cannot be empty");
+    }
+    try {
+      if (trimmed.endsWith("%")) {
+        const n = trimmed.slice(0, -1).trim();
+        if (!n) throw new PercentParseError('Percent symbol missing value before "%"');
+        return normalizeRatio(new import_decimal.default(n).div(100));
+      }
+      return normalizeRatio(new import_decimal.default(trimmed));
+    } catch (err) {
+      if (err instanceof PercentParseError) throw err;
+      throw new PercentParseError(`Invalid percent "${input}"`);
+    }
+  }
+  switch (input.kind) {
+    case "ratio":
+      return normalizeRatio(new import_decimal.default(input.value));
+    case "percent":
+      return normalizeRatio(new import_decimal.default(input.value).div(100));
+    case "basisPoints":
+      return normalizeRatio(new import_decimal.default(input.value).div(1e4));
+    default: {
+      const _exhaustive = input;
+      throw new PercentParseError(`Unknown percent input ${String(_exhaustive)}`);
+    }
+  }
+}
+
+// src/react/fields/use-percent-field.ts
+function usePercentField(options) {
+  const { value, onChange, required } = options;
+  const [error, setError] = (0, import_react.useState)();
+  const validate = (0, import_react.useCallback)(
+    (raw) => {
+      if (!raw.trim()) {
+        if (required) return "Rate is required";
+        return void 0;
+      }
+      try {
+        parsePercent(raw);
+        return void 0;
+      } catch (e) {
+        return e instanceof PercentParseError ? e.message : "Invalid rate";
+      }
+    },
+    [required]
+  );
+  const inputProps = {
+    value,
+    onChange: (e) => {
+      const next = e.target.value;
+      onChange(next);
+      setError(validate(next));
+    },
+    onBlur: () => setError(validate(value))
+  };
+  return { error, inputProps, clearError: () => setError(void 0) };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  usePercentField
+});
+//# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/index.ts","../../src/react/fields/use-percent-field.ts","../../src/core/percent.ts"],"sourcesContent":["export { usePercentField } from \"./fields/use-percent-field.js\";\nexport type { UsePercentFieldOptions } from \"./fields/use-percent-field.js\";\n","import { useCallback, useState, type ChangeEvent } from \"react\";\nimport { parsePercent, PercentParseError } from \"../../core/percent.js\";\n\nexport type UsePercentFieldOptions = {\n  value: string;\n  onChange: (next: string) => void;\n  required?: boolean;\n};\n\nexport function usePercentField(options: UsePercentFieldOptions) {\n  const { value, onChange, required } = options;\n  const [error, setError] = useState<string | undefined>();\n\n  const validate = useCallback(\n    (raw: string) => {\n      if (!raw.trim()) {\n        if (required) return \"Rate is required\";\n        return undefined;\n      }\n      try {\n        parsePercent(raw);\n        return undefined;\n      } catch (e) {\n        return e instanceof PercentParseError ? e.message : \"Invalid rate\";\n      }\n    },\n    [required],\n  );\n\n  const inputProps = {\n    value,\n    onChange: (e: ChangeEvent<HTMLInputElement>) => {\n      const next = e.target.value;\n      onChange(next);\n      setError(validate(next));\n    },\n    onBlur: () => setError(validate(value)),\n  };\n\n  return { error, inputProps, clearError: () => setError(undefined) };\n}\n","import Decimal from \"decimal.js\";\nimport type { Percent, PercentInput } from \"./types.js\";\n\nexport class PercentParseError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"PercentParseError\";\n  }\n}\n\nfunction normalizeRatio(ratio: Decimal): Percent {\n  if (ratio.isNegative()) {\n    throw new PercentParseError(\"Percent ratio cannot be negative\");\n  }\n  return { ratio: ratio.toFixed() };\n}\n\n/** Parse \"11%\", \"0.11\", or basis points via PercentInput. */\nexport function parsePercent(input: PercentInput | string): Percent {\n  if (typeof input === \"string\") {\n    const trimmed = input.trim();\n    if (!trimmed) {\n      throw new PercentParseError(\"Percent input cannot be empty\");\n    }\n    try {\n      if (trimmed.endsWith(\"%\")) {\n        const n = trimmed.slice(0, -1).trim();\n        if (!n) throw new PercentParseError('Percent symbol missing value before \"%\"');\n        return normalizeRatio(new Decimal(n).div(100));\n      }\n      return normalizeRatio(new Decimal(trimmed));\n    } catch (err) {\n      if (err instanceof PercentParseError) throw err;\n      throw new PercentParseError(`Invalid percent \"${input}\"`);\n    }\n  }\n  switch (input.kind) {\n    case \"ratio\":\n      return normalizeRatio(new Decimal(input.value));\n    case \"percent\":\n      return normalizeRatio(new Decimal(input.value).div(100));\n    case \"basisPoints\":\n      return normalizeRatio(new Decimal(input.value).div(10_000));\n    default: {\n      const _exhaustive: never = input;\n      throw new PercentParseError(`Unknown percent input ${String(_exhaustive)}`);\n    }\n  }\n}\n\nexport function fromBasisPoints(bps: string): Percent {\n  return parsePercent({ kind: \"basisPoints\", value: bps });\n}\n\nexport function fromPercentSymbol(value: string): Percent {\n  return parsePercent({ kind: \"percent\", value });\n}\n\nexport function toBasisPoints(p: Percent): string {\n  return new Decimal(p.ratio).times(10_000).toFixed(0);\n}\n\nexport function toPercentSymbol(p: Percent): string {\n  return `${new Decimal(p.ratio).times(100).toFixed()}%`;\n}\n\n/** amount * ratio — both decimal strings. */\nexport function percentOf(amount: string, percent: Percent): string {\n  return new Decimal(amount).times(percent.ratio).toFixed();\n}\n\nexport function plusPercent(amount: string, percent: Percent): string {\n  return new Decimal(amount).times(new Decimal(1).plus(percent.ratio)).toFixed();\n}\n\nexport function minusPercent(amount: string, percent: Percent): string {\n  return new Decimal(amount).times(new Decimal(1).minus(percent.ratio)).toFixed();\n}\n\nexport function addPercents(a: Percent, b: Percent): Percent {\n  return { ratio: new Decimal(a.ratio).plus(b.ratio).toFixed() };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAAwD;;;ACAxD,qBAAoB;AAGb,IAAM,oBAAN,cAAgC,MAAM;AAAA,EAC3C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEA,SAAS,eAAe,OAAyB;AAC/C,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,IAAI,kBAAkB,kCAAkC;AAAA,EAChE;AACA,SAAO,EAAE,OAAO,MAAM,QAAQ,EAAE;AAClC;AAGO,SAAS,aAAa,OAAuC;AAClE,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI,kBAAkB,+BAA+B;AAAA,IAC7D;AACA,QAAI;AACF,UAAI,QAAQ,SAAS,GAAG,GAAG;AACzB,cAAM,IAAI,QAAQ,MAAM,GAAG,EAAE,EAAE,KAAK;AACpC,YAAI,CAAC,EAAG,OAAM,IAAI,kBAAkB,yCAAyC;AAC7E,eAAO,eAAe,IAAI,eAAAA,QAAQ,CAAC,EAAE,IAAI,GAAG,CAAC;AAAA,MAC/C;AACA,aAAO,eAAe,IAAI,eAAAA,QAAQ,OAAO,CAAC;AAAA,IAC5C,SAAS,KAAK;AACZ,UAAI,eAAe,kBAAmB,OAAM;AAC5C,YAAM,IAAI,kBAAkB,oBAAoB,KAAK,GAAG;AAAA,IAC1D;AAAA,EACF;AACA,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO,eAAe,IAAI,eAAAA,QAAQ,MAAM,KAAK,CAAC;AAAA,IAChD,KAAK;AACH,aAAO,eAAe,IAAI,eAAAA,QAAQ,MAAM,KAAK,EAAE,IAAI,GAAG,CAAC;AAAA,IACzD,KAAK;AACH,aAAO,eAAe,IAAI,eAAAA,QAAQ,MAAM,KAAK,EAAE,IAAI,GAAM,CAAC;AAAA,IAC5D,SAAS;AACP,YAAM,cAAqB;AAC3B,YAAM,IAAI,kBAAkB,yBAAyB,OAAO,WAAW,CAAC,EAAE;AAAA,IAC5E;AAAA,EACF;AACF;;;ADvCO,SAAS,gBAAgB,SAAiC;AAC/D,QAAM,EAAE,OAAO,UAAU,SAAS,IAAI;AACtC,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAA6B;AAEvD,QAAM,eAAW;AAAA,IACf,CAAC,QAAgB;AACf,UAAI,CAAC,IAAI,KAAK,GAAG;AACf,YAAI,SAAU,QAAO;AACrB,eAAO;AAAA,MACT;AACA,UAAI;AACF,qBAAa,GAAG;AAChB,eAAO;AAAA,MACT,SAAS,GAAG;AACV,eAAO,aAAa,oBAAoB,EAAE,UAAU;AAAA,MACtD;AAAA,IACF;AAAA,IACA,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,aAAa;AAAA,IACjB;AAAA,IACA,UAAU,CAAC,MAAqC;AAC9C,YAAM,OAAO,EAAE,OAAO;AACtB,eAAS,IAAI;AACb,eAAS,SAAS,IAAI,CAAC;AAAA,IACzB;AAAA,IACA,QAAQ,MAAM,SAAS,SAAS,KAAK,CAAC;AAAA,EACxC;AAEA,SAAO,EAAE,OAAO,YAAY,YAAY,MAAM,SAAS,MAAS,EAAE;AACpE;","names":["Decimal"]}

package/dist/react/index.d.ts

@@ -0,0 +1,3 @@
+export { usePercentField } from "./fields/use-percent-field.js";
+export type { UsePercentFieldOptions } from "./fields/use-percent-field.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,YAAY,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,40 @@
+import {
+  PercentParseError,
+  parsePercent
+} from "../chunk-MW4KRZDX.js";
+
+// src/react/fields/use-percent-field.ts
+import { useCallback, useState } from "react";
+function usePercentField(options) {
+  const { value, onChange, required } = options;
+  const [error, setError] = useState();
+  const validate = useCallback(
+    (raw) => {
+      if (!raw.trim()) {
+        if (required) return "Rate is required";
+        return void 0;
+      }
+      try {
+        parsePercent(raw);
+        return void 0;
+      } catch (e) {
+        return e instanceof PercentParseError ? e.message : "Invalid rate";
+      }
+    },
+    [required]
+  );
+  const inputProps = {
+    value,
+    onChange: (e) => {
+      const next = e.target.value;
+      onChange(next);
+      setError(validate(next));
+    },
+    onBlur: () => setError(validate(value))
+  };
+  return { error, inputProps, clearError: () => setError(void 0) };
+}
+export {
+  usePercentField
+};
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/fields/use-percent-field.ts"],"sourcesContent":["import { useCallback, useState, type ChangeEvent } from \"react\";\nimport { parsePercent, PercentParseError } from \"../../core/percent.js\";\n\nexport type UsePercentFieldOptions = {\n  value: string;\n  onChange: (next: string) => void;\n  required?: boolean;\n};\n\nexport function usePercentField(options: UsePercentFieldOptions) {\n  const { value, onChange, required } = options;\n  const [error, setError] = useState<string | undefined>();\n\n  const validate = useCallback(\n    (raw: string) => {\n      if (!raw.trim()) {\n        if (required) return \"Rate is required\";\n        return undefined;\n      }\n      try {\n        parsePercent(raw);\n        return undefined;\n      } catch (e) {\n        return e instanceof PercentParseError ? e.message : \"Invalid rate\";\n      }\n    },\n    [required],\n  );\n\n  const inputProps = {\n    value,\n    onChange: (e: ChangeEvent<HTMLInputElement>) => {\n      const next = e.target.value;\n      onChange(next);\n      setError(validate(next));\n    },\n    onBlur: () => setError(validate(value)),\n  };\n\n  return { error, inputProps, clearError: () => setError(undefined) };\n}\n"],"mappings":";;;;;;AAAA,SAAS,aAAa,gBAAkC;AASjD,SAAS,gBAAgB,SAAiC;AAC/D,QAAM,EAAE,OAAO,UAAU,SAAS,IAAI;AACtC,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA6B;AAEvD,QAAM,WAAW;AAAA,IACf,CAAC,QAAgB;AACf,UAAI,CAAC,IAAI,KAAK,GAAG;AACf,YAAI,SAAU,QAAO;AACrB,eAAO;AAAA,MACT;AACA,UAAI;AACF,qBAAa,GAAG;AAChB,eAAO;AAAA,MACT,SAAS,GAAG;AACV,eAAO,aAAa,oBAAoB,EAAE,UAAU;AAAA,MACtD;AAAA,IACF;AAAA,IACA,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,aAAa;AAAA,IACjB;AAAA,IACA,UAAU,CAAC,MAAqC;AAC9C,YAAM,OAAO,EAAE,OAAO;AACtB,eAAS,IAAI;AACb,eAAS,SAAS,IAAI,CAAC;AAAA,IACzB;AAAA,IACA,QAAQ,MAAM,SAAS,SAAS,KAAK,CAAC;AAAA,EACxC;AAEA,SAAO,EAAE,OAAO,YAAY,YAAY,MAAM,SAAS,MAAS,EAAE;AACpE;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eristack/percent",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Percent and basis-point ratios as strings — tax, discount, markup without float literals",
   "repository": {
     "type": "git",
@@ -32,6 +32,16 @@
         "types": "./dist/zod/index.d.ts",
         "default": "./dist/zod/index.cjs"
       }
+    },
+    "./react": {
+      "import": {
+        "types": "./dist/react/index.d.ts",
+        "default": "./dist/react/index.js"
+      },
+      "require": {
+        "types": "./dist/react/index.d.ts",
+        "default": "./dist/react/index.cjs"
+      }
     }
   },
   "files": [
@@ -56,16 +66,22 @@
     "decimal.js": "^10.6.0"
   },
   "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
     "zod": "^4.0.0"
   },
   "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
     "zod": {
       "optional": true
     }
   },
   "devDependencies": {
     "@tanstack/intent": "^0.3.6",
+    "@types/react": "^19.0.12",
     "@types/node": "^22.15.29",
+    "react": "^19.0.0",
     "tsup": "^8.5.0",
     "typescript": "^7.0.0",
     "vitest": "^4.1.10",