@secundus-studio/stift-format 0.0.0-stage → 0.4.2

package/CHANGELOG.md

@@ -0,0 +1,50 @@
+# @secundus-studio/stift-format
+
+## 0.4.2
+
+### Patch Changes
+
+- Republish 0.4.1 as 0.4.2 with installable tarballs: the 0.4.1 artifacts carried literal `workspace:*` dependency ranges and could not be installed by any package manager. No code changes.
+- Updated dependencies
+  - @secundus-studio/stift-core@0.4.2
+
+## 0.4.1
+
+### Patch Changes
+
+- Updated dependencies [ec4a6c1]
+  - @secundus-studio/stift-core@0.4.1
+
+## 0.4.0
+
+### Patch Changes
+
+- Updated dependencies [d60faf6]
+  - @secundus-studio/stift-core@0.4.0
+
+## 0.3.0
+
+### Minor Changes
+
+- 71e677d: Rename the library from l10n to Stift. Packages move to `@secundus-studio/stift-*`, the config file is `stift.config.ts`, the CLI is `stift`, and the API follows (`createStift`, `Stift`, `StiftProvider`, `StiftConfig`, `virtual:stift/runtime`). BREAKING (pre-1.0): update imports, the config filename, and pack tooling; old `.dat` packs (I18NKIT magic) are rejected by the new decoder and re-fetched, and renamed storage keys, cookie names, and devtools routes start fresh.
+
+### Patch Changes
+
+- Updated dependencies [71e677d]
+  - @secundus-studio/stift-core@0.3.0
+
+## 0.2.0
+
+### Patch Changes
+
+- Updated dependencies [13824b6]
+- Updated dependencies [1770b34]
+  - @secundus-studio/l10n-core@0.2.0
+
+## 0.1.0
+
+### Patch Changes
+
+- Updated dependencies [275184d]
+- Updated dependencies [275184d]
+  - @secundus-studio/l10n-core@0.1.0

package/LICENSE

@@ -0,0 +1,41 @@
+Copyright (c) 2026 Ali Alkhateeb. All rights reserved.
+
+SECUNDUS L10N — PROPRIETARY LICENSE
+
+The compiled software packages distributed under the @secundus-studio scope on
+the public npm registry (the "Software") are proprietary to Ali Alkhateeb. They
+are licensed, not sold.
+
+1. Grant. Subject to this license, Ali Alkhateeb grants you a non-exclusive,
+   non-transferable, royalty-free right to install and use the Software, in
+   object-code form, as a dependency of your own applications, including
+   commercial and closed-source applications.
+
+2. Restrictions. You may not:
+   (a) copy, publish, distribute, sublicense, or sell the Software, or make
+       it available to any third party, except as embedded in your own
+       application;
+   (b) modify, translate, reverse engineer, decompile, or disassemble the
+       Software, or attempt to derive its source code;
+   (c) remove or alter any copyright, license, or proprietary notices.
+
+3. No source code. This license grants no rights to the source code of the
+   Software. The source is confidential, is not distributed, and remains the
+   property of Ali Alkhateeb.
+
+4. Contributions. Any feedback, bug report, or suggestion you provide may be
+   used by Ali Alkhateeb without restriction or obligation.
+
+5. Termination. This license terminates automatically if you breach any of its
+   terms. On termination you must stop using the Software and delete all
+   copies in your possession or control.
+
+6. Disclaimer. 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.
+
+For licensing inquiries, contact hello@secundus.studio.

package/README.md

@@ -1,3 +1,44 @@
-# Temporary Holding Version
+# @secundus-studio/stift-format
 
-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.
+Tree-shakable `Intl` formatting helpers: numbers, currency, dates, lists, and units. No state, no React.
+
+## What it is
+
+The optional formatting companion to `@secundus-studio/stift-core`. Core owns messages (ICU select/plural in translations, locale state, detection); this package adds standalone, locale-aware formatting functions for everything around the message: currency amounts, dates and relative times, list joining, and unit conversion plus rendering. Every function takes `{ locale }` explicitly (pass the active locale to stay in sync), each module is standalone, and the package ships side-effect-free so bundlers drop what you don't import. Currency, unit, calendar, timezone, and numbering-system arguments are narrowed to your registered config sets when the typegen augmentation is present.
+
+```bash
+pnpm add @secundus-studio/stift-format
+```
+
+## Quick start
+
+```ts
+import { formatCurrency, formatDate, formatList, formatUnit } from '@secundus-studio/stift-format'
+
+formatCurrency(9.99, 'EUR', { locale: 'en' })                    // "€9.99"
+formatDate(new Date(), { locale: 'en', dateStyle: 'medium' })    // e.g. "Oct 9, 2026"
+formatList(['apples', 'bread', 'cheese'], { locale: 'en' })      // "apples, bread, and cheese"
+formatUnit(12000, { locale: 'en', unit: 'kilometer' })           // "12 km"
+```
+
+## API
+
+- `formatNumber(value, options)` — locale-aware number via `Intl.NumberFormat`.
+- `formatCurrency(value, currency, options)` — currency amount (`currency` second, style forced to `currency`).
+- `formatPercent(value, options)` — percent (e.g. `0.42` → `"42%"`).
+- `pluralCategory(value, locale)` — CLDR plural category (`"one"`/`"few"`/…) via `Intl.PluralRules`.
+- `formatDate(value, options)` / `formatTime(value, options)` / `formatDateTime(value, options)` — `Date | number | string` via `Intl.DateTimeFormat`; options pass through calendar, timezone, and numbering system.
+- `formatRelativeTime(value, unit, options)` — `"2 days ago"` via `Intl.RelativeTimeFormat`.
+- `formatList(list, options)` — localized joining (`"a, b, and c"`) via `Intl.ListFormat`.
+- `formatUnit(value, options)` — localized quantity; `value` is in the category base unit, target `unit` rides in options; falls back to a plain number (never throws) when the engine lacks the unit.
+- `convertUnit(value, from, to)` — pure base-aware conversion between named units.
+- `fromBase(value, unit)` / `toBase(value, unit)` — the two halves of a conversion, for custom pipelines.
+- `isEngineSupportedUnit(unit)` — whether the running engine can format `unit` (guards `formatUnit`).
+- `NumberFormatOptions`, `DateTimeFormatOptions`, `ListFormatOptions`, `UnitNumberFormatOptions` — option types (type-only).
+
+## Docs
+
+- Formatting reference — https://stift.secundus.studio/docs/latest/vanilla/api/format
+- Units (vanilla) — https://stift.secundus.studio/docs/latest/vanilla/units
+- Units (React) — https://stift.secundus.studio/docs/latest/react/units
+- `useFormatter` hook (wraps these functions) — https://stift.secundus.studio/docs/latest/react/api/use-formatter

package/dist/index.cjs

@@ -0,0 +1 @@
+'use strict';var F=Object.defineProperty;var o=(t,e)=>F(t,"name",{value:e,configurable:true});function c(t,e,r){let n=r?{...r}:{};return e&&(n.numberingSystem=e),new Intl.NumberFormat(t,n)}o(c,"number");function T(t,e){let{locale:r,numberingSystem:n,...i}=e;return c(r,n,i).format(t)}o(T,"formatNumber");function O(t,e,r){let{locale:n,numberingSystem:i,...a}=r;return c(n,i,{style:"currency",currency:e,...a}).format(t)}o(O,"formatCurrency");function S(t,e){let{locale:r,numberingSystem:n,...i}=e;return c(r,n,{style:"percent",...i}).format(t)}o(S,"formatPercent");function D(t,e){return new Intl.PluralRules(e).select(t)}o(D,"pluralCategory");function f(t){let{locale:e,numberingSystem:r,timeZone:n,calendar:i,...a}=t,m={...a};for(let s of Object.keys(m))m[s]===void 0&&delete m[s];return r&&(m.numberingSystem=r),n&&(m.timeZone=n),i&&(m.calendar=i),new Intl.DateTimeFormat(e,m)}o(f,"dateTime");function l(t){return t instanceof Date?t:typeof t=="number"?new Date(t):new Date(t)}o(l,"toDate");function I(t,e){return f(e).format(l(t))}o(I,"formatDate");function N(t,e){let r={...e,...e.timeStyle==null?{timeStyle:"short"}:{}};return f(r).format(l(t))}o(N,"formatTime");function x(t,e){let r={...e,dateStyle:e.dateStyle??"medium",timeStyle:e.timeStyle??"short"};return f(r).format(l(t))}o(x,"formatDateTime");function R(t,e,r){let{locale:n,numeric:i,style:a}=r;return new Intl.RelativeTimeFormat(n,{...i?{numeric:i}:{},...a?{style:a}:{}}).format(t,e)}o(R,"formatRelativeTime");function L(t,e){let{locale:r,type:n,style:i}=e;return new Intl.ListFormat(r,{...n?{type:n}:{},...i?{style:i}:{}}).format(Array.from(t))}o(L,"formatList");var p={millimeter:.001,centimeter:.01,meter:1,kilometer:1e3,inch:.0254,foot:.3048,yard:.9144,mile:1609.344,"mile-scandinavian":1e4,gram:.001,kilogram:1,ounce:.028349523125,pound:.45359237,stone:6.35029318,acre:.40468564224,hectare:1,celsius:1,bit:.125,byte:1,kilobit:125,kilobyte:1e3,megabit:125e3,megabyte:1e6,gigabit:125e6,gigabyte:1e9,terabit:125e9,terabyte:1e12,petabyte:1e15};function g(t,e){if(e==="fahrenheit")return t*(9/5)+32;let r=p[e];return r!==void 0?t/r:t}o(g,"fromBase");function d(t,e){if(e==="fahrenheit")return (t-32)*(5/9);let r=p[e];return r!==void 0?t*r:t}o(d,"toBase");function h(t,e,r){return e===r?t:g(d(t,e),r)}o(h,"convertUnit");var w=new Set([...Object.keys(p),"fahrenheit"]),b=(()=>{if(!(typeof Intl>"u"||typeof Intl.supportedValuesOf!="function"))try{return new Set(Intl.supportedValuesOf("unit"))}catch{return}})();function y(t){return b?b.has(t):w.has(t)}o(y,"isEngineSupportedUnit");function U(t,e){let{locale:r,numberingSystem:n,unit:i,unitDisplay:a,...m}=e;if(!i)return new Intl.NumberFormat(r,{...m,...n?{numberingSystem:n}:{}}).format(t);let s=g(t,i),u={...m,...n?{numberingSystem:n}:{}};return y(i)&&(u.style="unit",u.unit=i,a&&(u.unitDisplay=a)),new Intl.NumberFormat(r,u).format(s)}o(U,"formatUnit");exports.convertUnit=h;exports.formatCurrency=O;exports.formatDate=I;exports.formatDateTime=x;exports.formatList=L;exports.formatNumber=T;exports.formatPercent=S;exports.formatRelativeTime=R;exports.formatTime=N;exports.formatUnit=U;exports.fromBase=g;exports.isEngineSupportedUnit=y;exports.pluralCategory=D;exports.toBase=d;

package/dist/index.d.cts

@@ -0,0 +1,112 @@
+import { LocaleTag, RegisteredNumberingSystems, RegisteredCurrencies, RegisteredCalendars, RegisteredTimezones, RegisteredUnit } from '@secundus-studio/stift-core';
+
+/**
+ * Numeric formatting helpers (docs/04-execution-plan.md Phase 3). Each is a
+ * thin, tree-shakable wrapper over `Intl.NumberFormat` with locale +
+ * numbering-system (and unit/currency) pass-through.
+ */
+interface NumberFormatOptions extends Intl.NumberFormatOptions {
+    /** BCP 47 locale tag of the active locale. */
+    locale: LocaleTag;
+    /** Override the numbering system (e.g. "arab", "latn") — narrowed to the
+     *  app's registered set when the typegen augmentation is present. */
+    numberingSystem?: RegisteredNumberingSystems;
+}
+
+/** Format a number using the locale's CLDR rules. */
+declare function formatNumber(value: number, options: NumberFormatOptions): string;
+/** Format a currency amount. */
+declare function formatCurrency(value: number, currency: RegisteredCurrencies, options: NumberFormatOptions): string;
+/** Format a percent value (e.g. 0.42 -> "42%"). */
+declare function formatPercent(value: number, options: NumberFormatOptions): string;
+/** Get the CLDR plural category for a value ("one"/"few"/"many"/…). */
+declare function pluralCategory(value: number, locale: LocaleTag): string;
+
+/**
+ * Date / time formatting helpers (docs/04-execution-plan.md Phase 3), thin
+ * `Intl.DateTimeFormat` wrappers with locale + timezone + numbering-system
+ * pass-through.
+ */
+interface DateTimeFormatOptions extends Intl.DateTimeFormatOptions {
+    /** BCP 47 locale tag of the active locale. */
+    locale: LocaleTag;
+    /** Override the numeric value's numbering system — narrowed to the app's
+     *  registered set when the typegen augmentation is present. */
+    numberingSystem?: RegisteredNumberingSystems;
+    /** Calendar to format in (e.g. "gregory", "islamic") — narrowed to the
+     *  app's registered set when the typegen augmentation is present. */
+    calendar?: RegisteredCalendars;
+    /** IANA time zone identifier, e.g. "Asia/Damascus". */
+    timeZone?: RegisteredTimezones;
+}
+
+/** Format a date (uses `dateStyle`/`year`… from options). */
+declare function formatDate(value: Date | number | string, options: DateTimeFormatOptions): string;
+/** Format a time-of-day value. */
+declare function formatTime(value: Date | number | string, options: DateTimeFormatOptions): string;
+/** Format a full date+time. */
+declare function formatDateTime(value: Date | number | string, options: DateTimeFormatOptions): string;
+/** Relative time via `Intl.RelativeTimeFormat` ("2 days ago"). */
+declare function formatRelativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, options: {
+    locale: LocaleTag;
+    numeric?: Intl.RelativeTimeFormatNumeric;
+    style?: Intl.RelativeTimeFormatStyle;
+}): string;
+
+/**
+ * List formatting (docs/04-execution-plan.md Phase 3) — `Intl.ListFormat`
+ * wrapper, locale-aware conjunction/disjunction.
+ */
+interface ListFormatOptions {
+    locale: LocaleTag;
+    type?: Intl.ListFormatType;
+    style?: Intl.ListFormatStyle;
+}
+
+/** Join a list of strings localized ("a, b, and c"). */
+declare function formatList(list: Iterable<string>, options: ListFormatOptions): string;
+
+/**
+ * Unit formatting helpers (docs/17-units.md). Tree-shakable, standalone —
+ * the sole dependency is `@secundus-studio/stift-core`'s types.
+ *
+ * Value contract: every `formatUnit`/`convertUnit` argument is expressed in
+ * the category's canonical base unit (length→meter, mass→kilogram,
+ * area→hectare, temperature→celsius, digital→byte). The helpers convert to
+ * the active `unit` and format with `Intl.NumberFormat`.
+ *
+ * Engine guard: the catalog is the ECMA-402-sanctioned set (stable across
+ * conforming engines), but an end-user engine may still lack a unit. When the
+ * active unit isn't supported by the running engine, `formatUnit` degrades to
+ * a plain number instead of throwing — the fallback is never a crash.
+ */
+
+interface UnitNumberFormatOptions extends Intl.NumberFormatOptions {
+    /** BCP 47 locale tag of the active locale. */
+    locale: LocaleTag;
+    /** Override the numbering system (e.g. "arab", "latn") — narrowed to the
+     *  app's registered set when the typegen augmentation is present. */
+    numberingSystem?: RegisteredNumberingSystems;
+    /** The active unit — the category's current unit (docs/17). */
+    unit?: RegisteredUnit;
+    /** How the unit is displayed. */
+    unitDisplay?: 'long' | 'short' | 'narrow';
+}
+/** Convert a value from its base unit into a target unit. */
+declare function fromBase(value: number, unit: string): number;
+/** Convert a value from a target unit into its base unit. */
+declare function toBase(value: number, unit: string): number;
+/** Convert `value` expressed in `from` to `to` (base-aware; both units must
+ *  share a base, or math is undefined). Identity for equal units. */
+declare function convertUnit(value: number, from: string, to: string): number;
+/** Whether the running engine can format `unit` (guards `formatUnit`). */
+declare function isEngineSupportedUnit(unit: string): boolean;
+/**
+ * Format `value` (expressed in the category base unit of `unit`) as a
+ * localized quantity, e.g. `formatUnit(12000, { locale: 'en', unit: 'kilometer' })`
+ * → "12 km". Falls back to a plain localized number when the engine lacks the
+ * unit.
+ */
+declare function formatUnit(value: number, options: UnitNumberFormatOptions): string;
+
+export { type DateTimeFormatOptions, type ListFormatOptions, type NumberFormatOptions, type UnitNumberFormatOptions, convertUnit, formatCurrency, formatDate, formatDateTime, formatList, formatNumber, formatPercent, formatRelativeTime, formatTime, formatUnit, fromBase, isEngineSupportedUnit, pluralCategory, toBase };

package/dist/index.d.ts

@@ -0,0 +1,112 @@
+import { LocaleTag, RegisteredNumberingSystems, RegisteredCurrencies, RegisteredCalendars, RegisteredTimezones, RegisteredUnit } from '@secundus-studio/stift-core';
+
+/**
+ * Numeric formatting helpers (docs/04-execution-plan.md Phase 3). Each is a
+ * thin, tree-shakable wrapper over `Intl.NumberFormat` with locale +
+ * numbering-system (and unit/currency) pass-through.
+ */
+interface NumberFormatOptions extends Intl.NumberFormatOptions {
+    /** BCP 47 locale tag of the active locale. */
+    locale: LocaleTag;
+    /** Override the numbering system (e.g. "arab", "latn") — narrowed to the
+     *  app's registered set when the typegen augmentation is present. */
+    numberingSystem?: RegisteredNumberingSystems;
+}
+
+/** Format a number using the locale's CLDR rules. */
+declare function formatNumber(value: number, options: NumberFormatOptions): string;
+/** Format a currency amount. */
+declare function formatCurrency(value: number, currency: RegisteredCurrencies, options: NumberFormatOptions): string;
+/** Format a percent value (e.g. 0.42 -> "42%"). */
+declare function formatPercent(value: number, options: NumberFormatOptions): string;
+/** Get the CLDR plural category for a value ("one"/"few"/"many"/…). */
+declare function pluralCategory(value: number, locale: LocaleTag): string;
+
+/**
+ * Date / time formatting helpers (docs/04-execution-plan.md Phase 3), thin
+ * `Intl.DateTimeFormat` wrappers with locale + timezone + numbering-system
+ * pass-through.
+ */
+interface DateTimeFormatOptions extends Intl.DateTimeFormatOptions {
+    /** BCP 47 locale tag of the active locale. */
+    locale: LocaleTag;
+    /** Override the numeric value's numbering system — narrowed to the app's
+     *  registered set when the typegen augmentation is present. */
+    numberingSystem?: RegisteredNumberingSystems;
+    /** Calendar to format in (e.g. "gregory", "islamic") — narrowed to the
+     *  app's registered set when the typegen augmentation is present. */
+    calendar?: RegisteredCalendars;
+    /** IANA time zone identifier, e.g. "Asia/Damascus". */
+    timeZone?: RegisteredTimezones;
+}
+
+/** Format a date (uses `dateStyle`/`year`… from options). */
+declare function formatDate(value: Date | number | string, options: DateTimeFormatOptions): string;
+/** Format a time-of-day value. */
+declare function formatTime(value: Date | number | string, options: DateTimeFormatOptions): string;
+/** Format a full date+time. */
+declare function formatDateTime(value: Date | number | string, options: DateTimeFormatOptions): string;
+/** Relative time via `Intl.RelativeTimeFormat` ("2 days ago"). */
+declare function formatRelativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, options: {
+    locale: LocaleTag;
+    numeric?: Intl.RelativeTimeFormatNumeric;
+    style?: Intl.RelativeTimeFormatStyle;
+}): string;
+
+/**
+ * List formatting (docs/04-execution-plan.md Phase 3) — `Intl.ListFormat`
+ * wrapper, locale-aware conjunction/disjunction.
+ */
+interface ListFormatOptions {
+    locale: LocaleTag;
+    type?: Intl.ListFormatType;
+    style?: Intl.ListFormatStyle;
+}
+
+/** Join a list of strings localized ("a, b, and c"). */
+declare function formatList(list: Iterable<string>, options: ListFormatOptions): string;
+
+/**
+ * Unit formatting helpers (docs/17-units.md). Tree-shakable, standalone —
+ * the sole dependency is `@secundus-studio/stift-core`'s types.
+ *
+ * Value contract: every `formatUnit`/`convertUnit` argument is expressed in
+ * the category's canonical base unit (length→meter, mass→kilogram,
+ * area→hectare, temperature→celsius, digital→byte). The helpers convert to
+ * the active `unit` and format with `Intl.NumberFormat`.
+ *
+ * Engine guard: the catalog is the ECMA-402-sanctioned set (stable across
+ * conforming engines), but an end-user engine may still lack a unit. When the
+ * active unit isn't supported by the running engine, `formatUnit` degrades to
+ * a plain number instead of throwing — the fallback is never a crash.
+ */
+
+interface UnitNumberFormatOptions extends Intl.NumberFormatOptions {
+    /** BCP 47 locale tag of the active locale. */
+    locale: LocaleTag;
+    /** Override the numbering system (e.g. "arab", "latn") — narrowed to the
+     *  app's registered set when the typegen augmentation is present. */
+    numberingSystem?: RegisteredNumberingSystems;
+    /** The active unit — the category's current unit (docs/17). */
+    unit?: RegisteredUnit;
+    /** How the unit is displayed. */
+    unitDisplay?: 'long' | 'short' | 'narrow';
+}
+/** Convert a value from its base unit into a target unit. */
+declare function fromBase(value: number, unit: string): number;
+/** Convert a value from a target unit into its base unit. */
+declare function toBase(value: number, unit: string): number;
+/** Convert `value` expressed in `from` to `to` (base-aware; both units must
+ *  share a base, or math is undefined). Identity for equal units. */
+declare function convertUnit(value: number, from: string, to: string): number;
+/** Whether the running engine can format `unit` (guards `formatUnit`). */
+declare function isEngineSupportedUnit(unit: string): boolean;
+/**
+ * Format `value` (expressed in the category base unit of `unit`) as a
+ * localized quantity, e.g. `formatUnit(12000, { locale: 'en', unit: 'kilometer' })`
+ * → "12 km". Falls back to a plain localized number when the engine lacks the
+ * unit.
+ */
+declare function formatUnit(value: number, options: UnitNumberFormatOptions): string;
+
+export { type DateTimeFormatOptions, type ListFormatOptions, type NumberFormatOptions, type UnitNumberFormatOptions, convertUnit, formatCurrency, formatDate, formatDateTime, formatList, formatNumber, formatPercent, formatRelativeTime, formatTime, formatUnit, fromBase, isEngineSupportedUnit, pluralCategory, toBase };

package/dist/index.js

@@ -0,0 +1 @@
+var F=Object.defineProperty;var o=(t,e)=>F(t,"name",{value:e,configurable:true});function c(t,e,r){let n=r?{...r}:{};return e&&(n.numberingSystem=e),new Intl.NumberFormat(t,n)}o(c,"number");function T(t,e){let{locale:r,numberingSystem:n,...i}=e;return c(r,n,i).format(t)}o(T,"formatNumber");function O(t,e,r){let{locale:n,numberingSystem:i,...a}=r;return c(n,i,{style:"currency",currency:e,...a}).format(t)}o(O,"formatCurrency");function S(t,e){let{locale:r,numberingSystem:n,...i}=e;return c(r,n,{style:"percent",...i}).format(t)}o(S,"formatPercent");function D(t,e){return new Intl.PluralRules(e).select(t)}o(D,"pluralCategory");function f(t){let{locale:e,numberingSystem:r,timeZone:n,calendar:i,...a}=t,m={...a};for(let s of Object.keys(m))m[s]===void 0&&delete m[s];return r&&(m.numberingSystem=r),n&&(m.timeZone=n),i&&(m.calendar=i),new Intl.DateTimeFormat(e,m)}o(f,"dateTime");function l(t){return t instanceof Date?t:typeof t=="number"?new Date(t):new Date(t)}o(l,"toDate");function I(t,e){return f(e).format(l(t))}o(I,"formatDate");function N(t,e){let r={...e,...e.timeStyle==null?{timeStyle:"short"}:{}};return f(r).format(l(t))}o(N,"formatTime");function x(t,e){let r={...e,dateStyle:e.dateStyle??"medium",timeStyle:e.timeStyle??"short"};return f(r).format(l(t))}o(x,"formatDateTime");function R(t,e,r){let{locale:n,numeric:i,style:a}=r;return new Intl.RelativeTimeFormat(n,{...i?{numeric:i}:{},...a?{style:a}:{}}).format(t,e)}o(R,"formatRelativeTime");function L(t,e){let{locale:r,type:n,style:i}=e;return new Intl.ListFormat(r,{...n?{type:n}:{},...i?{style:i}:{}}).format(Array.from(t))}o(L,"formatList");var p={millimeter:.001,centimeter:.01,meter:1,kilometer:1e3,inch:.0254,foot:.3048,yard:.9144,mile:1609.344,"mile-scandinavian":1e4,gram:.001,kilogram:1,ounce:.028349523125,pound:.45359237,stone:6.35029318,acre:.40468564224,hectare:1,celsius:1,bit:.125,byte:1,kilobit:125,kilobyte:1e3,megabit:125e3,megabyte:1e6,gigabit:125e6,gigabyte:1e9,terabit:125e9,terabyte:1e12,petabyte:1e15};function g(t,e){if(e==="fahrenheit")return t*(9/5)+32;let r=p[e];return r!==void 0?t/r:t}o(g,"fromBase");function d(t,e){if(e==="fahrenheit")return (t-32)*(5/9);let r=p[e];return r!==void 0?t*r:t}o(d,"toBase");function h(t,e,r){return e===r?t:g(d(t,e),r)}o(h,"convertUnit");var w=new Set([...Object.keys(p),"fahrenheit"]),b=(()=>{if(!(typeof Intl>"u"||typeof Intl.supportedValuesOf!="function"))try{return new Set(Intl.supportedValuesOf("unit"))}catch{return}})();function y(t){return b?b.has(t):w.has(t)}o(y,"isEngineSupportedUnit");function U(t,e){let{locale:r,numberingSystem:n,unit:i,unitDisplay:a,...m}=e;if(!i)return new Intl.NumberFormat(r,{...m,...n?{numberingSystem:n}:{}}).format(t);let s=g(t,i),u={...m,...n?{numberingSystem:n}:{}};return y(i)&&(u.style="unit",u.unit=i,a&&(u.unitDisplay=a)),new Intl.NumberFormat(r,u).format(s)}o(U,"formatUnit");export{h as convertUnit,O as formatCurrency,I as formatDate,x as formatDateTime,L as formatList,T as formatNumber,S as formatPercent,R as formatRelativeTime,N as formatTime,U as formatUnit,g as fromBase,y as isEngineSupportedUnit,D as pluralCategory,d as toBase};

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@secundus-studio/stift-format",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.2",
+  "license": "SEE LICENSE IN LICENSE",
+  "description": "Optional tree-shakable formatting: currency, units, ordinals, collation, calendars, segmentation, rich text, input parsing.",
+  "keywords": [
+    "stift",
+    "format",
+    "tanstack-intent"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "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"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@secundus-studio/stift-core": "0.4.2"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.10"
+  },
+  "homepage": "https://stift.secundus.studio",
+  "author": "Ali Alkhateeb",
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  }
 }