@stisocial/ui 0.0.0-stage → 0.2.0

package/dist/fonts/NOTICE

@@ -0,0 +1,28 @@
+STI Numeric
+===========
+
+STI Numeric is a Modified Version of Inter, the typeface by Rasmus Andersson and
+The Inter Project Authors (https://github.com/rsms/inter), distributed under the
+SIL Open Font License, Version 1.1. The full licence text is in OFL.txt, copied
+unchanged from the source below. STI Numeric is distributed under the same licence.
+
+Source:  google/fonts, commit 86aced91de05cd4f96a06838124cca45be337b2b,
+         ofl/inter/Inter[opsz,wght].ttf ("Version 4.001;git-66647c0bb")
+         sha256 29160a80ff49ddcab2c97711247e08b1fab27a484a329ce8b813d820dc559031
+
+Changes made by stisocial (build_numeric.py):
+- Static instances at opsz 14 and wght 330, 510, 735 and 885, published as the
+  weights 400, 500, 600 and 700 of the family "STI Numeric". Inter declares no
+  Reserved Font Name, so the new name is permitted (OFL section 3 does not apply).
+- Only the ten digits U+0030-0039 are kept. The tabular forms are the default
+  glyphs; all OpenType layout tables (GSUB, GPOS, GDEF) and hinting are removed,
+  and overlapping contours are merged.
+- 6 and 9 use Inter's tabular "open digits" forms. The 1 is redrawn without a
+  foot and with a horizontal flag, from Inter's own stem and stroke thickness.
+- Outlines are scaled by 0.92916 (digit height 0.676 em), each weight has its
+  own tabular advance, and the vertical metrics were changed.
+- Name table: family and style names, version and description changed. The
+  copyright notice (name ID 0) and licence (name IDs 13 and 14) are kept.
+
+The STI Numeric files may be used, studied, modified and redistributed under the
+SIL Open Font License 1.1. They may not be sold by themselves.

package/dist/fonts/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/format/context.d.ts

@@ -0,0 +1,13 @@
+import { Locale } from "../provider/locale.js";
+/**
+ * Biçimlendirmenin bağlamı: dil ve saat dilimi. Sunucu hangi saat diliminde çalışırsa çalışsın aynı
+ * an herkese aynı metinle yazılır; sunucu ile tarayıcı aynı metni ürettiğinden sayfa canlanırken
+ * (hydration) uyuşmazlık olmaz. Saat dilimi verilmezse Türkiye.
+ */
+export interface FormatContext {
+  locale: Locale;
+  timeZone: string;
+}
+export declare const DEFAULT_TIME_ZONE = "Europe/Istanbul";
+/** Bağlam parçalarını varsayılanlarla tamamlar. */
+export declare const contextOf: (ctx?: Partial<FormatContext>) => FormatContext;

package/dist/format/context.js

@@ -0,0 +1,23 @@
+// src/format/context.ts
+const DEFAULT_TIME_ZONE = "Europe/Istanbul";
+const DEFAULT_CONTEXT = {
+	locale: "tr-TR",
+	timeZone: DEFAULT_TIME_ZONE
+};
+/** Bağlam parçalarını varsayılanlarla tamamlar. */
+const contextOf = (ctx) => ({
+	locale: ctx?.locale ?? DEFAULT_CONTEXT.locale,
+	timeZone: ctx?.timeZone ?? DEFAULT_CONTEXT.timeZone
+});
+/** Aynı ayarlı biçimlendiriciyi tekrar tekrar kurmamak için küçük önbellek. */
+function memo(make) {
+	const cache = /* @__PURE__ */ new Map();
+	return (key) => {
+		const hit = cache.get(key);
+		if (hit !== void 0) return hit;
+		const created = make(key);
+		cache.set(key, created);
+		return created;
+	};
+}
+export { DEFAULT_CONTEXT, DEFAULT_TIME_ZONE, contextOf, memo };

package/dist/format/dates.d.ts

@@ -0,0 +1,53 @@
+import { FormatContext } from "./context.js";
+type DateInput = Date | number;
+export type DateStyle = "long" | "short" | "numeric";
+/** "6 Kasım 2026" · kısa: "6 Kas 2026" · sayısal: "06.11.2026" */
+export declare function formatDate(date: DateInput, ctx?: Partial<FormatContext>, style?: DateStyle): string;
+/**
+ * "6 Kasım 2026 14:05" · "November 6, 2026 at 2:05 PM"; yılsız: "6 Kasım 14:05" ·
+ * "November 6 at 2:05 PM" (dilin kendi tarih-saat kalıbıyla).
+ */
+export declare function formatDateTime(date: DateInput, ctx?: Partial<FormatContext>, { withYear }?: {
+  withYear?: boolean;
+}): string;
+/** "14:05"; saniyeli: "14:05:09" */
+export declare function formatTime(date: DateInput, ctx?: Partial<FormatContext>, { seconds }?: {
+  seconds?: boolean;
+}): string;
+/** "Kasım 2026" */
+export declare function formatMonthYear(date: DateInput, ctx?: Partial<FormatContext>): string;
+/** Aralık, tekrarsız: "6–8 Kasım 2026", "30 Kasım – 2 Aralık 2026". */
+export declare function formatDateRange(start: DateInput, end: DateInput, ctx?: Partial<FormatContext>): string;
+/** Saat dilimindeki gün: "2026-11-06". Aynı güne düşen anlar aynı anahtarı alır. */
+export declare function dayKey(date: DateInput, timeZone?: string): string;
+/**
+ * Takvim günü ("1990-03-12"; doğum tarihi gibi saati olmayan): "12 Mart 1990". Saat dilimi
+ * uygulanmaz: gün her yerde aynı gündür.
+ */
+export declare function formatCalendarDate(isoDay: string, ctx?: Partial<FormatContext>, { withYear }?: {
+  withYear?: boolean;
+}): string;
+/**
+ * Göreli zaman: "şimdi", "3 dakika önce", "dün", "2 gün sonra", "geçen hafta". 45 saniyenin
+ * altı "şimdi"dir; birim, değerin en okunur olduğu birimdir. `now` sunucu ile tarayıcının aynı
+ * metni üretmesi için dışarıdan verilir.
+ */
+export declare function formatRelativeTime(date: DateInput, now: DateInput, ctx?: Partial<FormatContext>): string;
+export interface DayLabels {
+  today: string;
+  yesterday: string;
+  tomorrow: string;
+}
+/**
+ * Kısa an: "Bugün 14:05", "Dün 09:10", "Yarın 10:00", "3 Kas 14:05"; başka yıldaysa
+ * "3 Kasım 2025 14:05". Günler bağlamın saat diliminde hesaplanır.
+ */
+export declare function formatCalendarDateTime(date: DateInput, now: DateInput, labels: DayLabels, ctx?: Partial<FormatContext>): string;
+/**
+ * Süre: kısa "2 sa. 5 dk.", uzun "2 saat 5 dakika"; saniye cinsinden verilir. `Intl.DurationFormat`
+ * bilerek kullanılmaz: her tarayıcıda yok, sunucu ile tarayıcı farklı metin üretirdi.
+ */
+export declare function formatDuration(totalSeconds: number, ctx?: Partial<FormatContext>, { style }?: {
+  style?: "short" | "long";
+}): string;
+export {};

package/dist/format/dates.js

@@ -0,0 +1,213 @@
+import { contextOf, memo } from "./context.js";
+// src/format/dates.ts
+/**
+* Tarih ve saat biçimleri (Türkçe öncelikli, İngilizce). Saatler bağlamın saat diliminde yazılır.
+* Örnekler (tr-TR, Europe/Istanbul): "6 Kasım 2026", "6 Kasım 2026 14:05", "14:05",
+* "6–8 Kasım 2026", "3 dakika önce", "Bugün 14:05".
+*/
+const toDate = (d) => d instanceof Date ? d : new Date(d);
+const assertValid = (d) => {
+	if (Number.isNaN(d.getTime())) throw new RangeError("Geçersiz tarih");
+	return d;
+};
+const key = (ctx, kind) => `${kind}|${ctx.locale}|${ctx.timeZone}`;
+const split = (k) => {
+	const [kind = "", locale = "tr-TR", timeZone = "UTC"] = k.split("|");
+	return {
+		kind,
+		locale,
+		timeZone
+	};
+};
+const OPTIONS = {
+	date: { dateStyle: "long" },
+	dateShort: {
+		day: "numeric",
+		month: "short",
+		year: "numeric"
+	},
+	dateNumeric: {
+		day: "2-digit",
+		month: "2-digit",
+		year: "numeric"
+	},
+	dateTime: {
+		dateStyle: "long",
+		timeStyle: "short"
+	},
+	time: { timeStyle: "short" },
+	timeSeconds: { timeStyle: "medium" },
+	weekday: {
+		weekday: "long",
+		day: "numeric",
+		month: "long"
+	},
+	weekdayYear: {
+		weekday: "long",
+		day: "numeric",
+		month: "long",
+		year: "numeric"
+	},
+	shortDay: {
+		day: "numeric",
+		month: "short"
+	},
+	monthYear: {
+		month: "long",
+		year: "numeric"
+	}
+};
+/**
+* Yılsız tarih ve saat ("6 Kasım 14:05", "November 6 at 2:05 PM"). `dateStyle`/`timeStyle` yıl
+* düşürmeye izin vermez; tek tek alanlarla yazılır. Saat, dilin kısa saat yazımıyla aynı olsun diye
+* (tr "08:05", en "8:05 AM") saatin iki haneli olup olmadığı dilin kendi kısa saatinden okunur.
+*/
+const dateTimeNoYearOptions = (locale) => {
+	return {
+		day: "numeric",
+		month: "long",
+		hour: new Intl.DateTimeFormat(locale, {
+			timeStyle: "short",
+			timeZone: "UTC"
+		}).formatToParts(Date.UTC(2e3, 0, 1, 5)).find((p) => p.type === "hour")?.value.length === 2 ? "2-digit" : "numeric",
+		minute: "2-digit"
+	};
+};
+const dtf = memo((k) => {
+	const { kind, locale, timeZone } = split(k);
+	const options = kind === "dateTimeNoYear" ? dateTimeNoYearOptions(locale) : OPTIONS[kind];
+	return new Intl.DateTimeFormat(locale, {
+		...options,
+		timeZone
+	});
+});
+const dayKeyFormat = memo((timeZone) => new Intl.DateTimeFormat("en-CA", {
+	year: "numeric",
+	month: "2-digit",
+	day: "2-digit",
+	timeZone
+}));
+/** "6 Kasım 2026" · kısa: "6 Kas 2026" · sayısal: "06.11.2026" */
+function formatDate(date, ctx, style = "long") {
+	const kind = style === "long" ? "date" : style === "short" ? "dateShort" : "dateNumeric";
+	return dtf(key(contextOf(ctx), kind)).format(assertValid(toDate(date)));
+}
+/**
+* "6 Kasım 2026 14:05" · "November 6, 2026 at 2:05 PM"; yılsız: "6 Kasım 14:05" ·
+* "November 6 at 2:05 PM" (dilin kendi tarih-saat kalıbıyla).
+*/
+function formatDateTime(date, ctx, { withYear = true } = {}) {
+	const kind = withYear ? "dateTime" : "dateTimeNoYear";
+	return dtf(key(contextOf(ctx), kind)).format(assertValid(toDate(date)));
+}
+/** "14:05"; saniyeli: "14:05:09" */
+function formatTime(date, ctx, { seconds = false } = {}) {
+	return dtf(key(contextOf(ctx), seconds ? "timeSeconds" : "time")).format(assertValid(toDate(date)));
+}
+/** "Kasım 2026" */
+function formatMonthYear(date, ctx) {
+	return dtf(key(contextOf(ctx), "monthYear")).format(assertValid(toDate(date)));
+}
+/** Aralık, tekrarsız: "6–8 Kasım 2026", "30 Kasım – 2 Aralık 2026". */
+function formatDateRange(start, end, ctx) {
+	const a = assertValid(toDate(start));
+	const b = assertValid(toDate(end));
+	if (a.getTime() > b.getTime()) throw new RangeError("Aralığın başı sonundan sonra olamaz");
+	return dtf(key(contextOf(ctx), "date")).formatRange(a, b);
+}
+/** Saat dilimindeki gün: "2026-11-06". Aynı güne düşen anlar aynı anahtarı alır. */
+function dayKey(date, timeZone = contextOf().timeZone) {
+	return dayKeyFormat(timeZone).format(assertValid(toDate(date)));
+}
+/**
+* Takvim günü ("1990-03-12"; doğum tarihi gibi saati olmayan): "12 Mart 1990". Saat dilimi
+* uygulanmaz: gün her yerde aynı gündür.
+*/
+function formatCalendarDate(isoDay, ctx, { withYear = true } = {}) {
+	const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(isoDay);
+	if (!m) throw new RangeError(`Takvim günü YYYY-AA-GG olmalı: ${isoDay}`);
+	const [y, mo, d] = [
+		Number(m[1]),
+		Number(m[2]),
+		Number(m[3])
+	];
+	const date = new Date(Date.UTC(y, mo - 1, d));
+	if (date.getUTCMonth() !== mo - 1 || date.getUTCDate() !== d) throw new RangeError(`Takvimde olmayan gün: ${isoDay}`);
+	const { locale } = contextOf(ctx);
+	return new Intl.DateTimeFormat(locale, {
+		day: "numeric",
+		month: "long",
+		...withYear && { year: "numeric" },
+		timeZone: "UTC"
+	}).format(date);
+}
+const rtf = memo((locale) => new Intl.RelativeTimeFormat(locale, { numeric: "auto" }));
+const STEPS = [
+	["second", 60],
+	["minute", 60],
+	["hour", 24],
+	["day", 7],
+	["week", 4.345],
+	["month", 12],
+	["year", Number.POSITIVE_INFINITY]
+];
+/**
+* Göreli zaman: "şimdi", "3 dakika önce", "dün", "2 gün sonra", "geçen hafta". 45 saniyenin
+* altı "şimdi"dir; birim, değerin en okunur olduğu birimdir. `now` sunucu ile tarayıcının aynı
+* metni üretmesi için dışarıdan verilir.
+*/
+function formatRelativeTime(date, now, ctx) {
+	const { locale } = contextOf(ctx);
+	let value = (assertValid(toDate(date)).getTime() - assertValid(toDate(now)).getTime()) / 1e3;
+	if (Math.abs(value) < 45) return rtf(locale).format(0, "second");
+	for (const [unit, size] of STEPS) {
+		if (Math.abs(Math.round(value)) < size) return rtf(locale).format(Math.round(value), unit);
+		value /= size;
+	}
+	return rtf(locale).format(Math.round(value), "year");
+}
+/**
+* Takvim gününe gün ekler ("2026-03-29" + 1 → "2026-03-30"). Milisaniye eklemek yaz saati
+* geçişinde (23 ya da 25 saatlik gün) yanlış güne düşer; hesap UTC takvim günüyle yapılır.
+*/
+function addDays(isoDay, days) {
+	const [y, m, d] = isoDay.split("-").map(Number);
+	return new Date(Date.UTC(y, m - 1, d + days)).toISOString().slice(0, 10);
+}
+/**
+* Kısa an: "Bugün 14:05", "Dün 09:10", "Yarın 10:00", "3 Kas 14:05"; başka yıldaysa
+* "3 Kasım 2025 14:05". Günler bağlamın saat diliminde hesaplanır.
+*/
+function formatCalendarDateTime(date, now, labels, ctx) {
+	const c = contextOf(ctx);
+	const d = assertValid(toDate(date));
+	const n = assertValid(toDate(now));
+	const day = dayKey(d, c.timeZone);
+	const time = formatTime(d, c);
+	const today = dayKey(n, c.timeZone);
+	if (day === today) return `${labels.today} ${time}`;
+	if (day === addDays(today, -1)) return `${labels.yesterday} ${time}`;
+	if (day === addDays(today, 1)) return `${labels.tomorrow} ${time}`;
+	return day.slice(0, 4) === today.slice(0, 4) ? `${dtf(key(c, "shortDay")).format(d)} ${time}` : formatDateTime(d, c);
+}
+/**
+* Süre: kısa "2 sa. 5 dk.", uzun "2 saat 5 dakika"; saniye cinsinden verilir. `Intl.DurationFormat`
+* bilerek kullanılmaz: her tarayıcıda yok, sunucu ile tarayıcı farklı metin üretirdi.
+*/
+function formatDuration(totalSeconds, ctx, { style = "short" } = {}) {
+	if (!Number.isFinite(totalSeconds) || totalSeconds < 0) throw new RangeError("Geçersiz süre");
+	const s = Math.round(totalSeconds);
+	const parts = [
+		["hour", Math.floor(s / 3600)],
+		["minute", Math.floor(s % 3600 / 60)],
+		["second", s % 60]
+	];
+	const shown = s === 0 ? [parts[2]] : parts.filter(([, v]) => v > 0);
+	const { locale } = contextOf(ctx);
+	return shown.map(([unit, v]) => new Intl.NumberFormat(locale, {
+		style: "unit",
+		unit,
+		unitDisplay: style
+	}).format(v)).join(" ");
+}
+export { dayKey, formatCalendarDate, formatCalendarDateTime, formatDate, formatDateRange, formatDateTime, formatDuration, formatMonthYear, formatRelativeTime, formatTime };

package/dist/format/formatter.d.ts

@@ -0,0 +1,37 @@
+import { FormatContext } from "./context.js";
+import { DateStyle, DayLabels } from "./dates.js";
+import { CurrencyOptions } from "./numbers.js";
+type D = Date | number;
+export declare function createFormatter(ctx?: Partial<FormatContext>): {
+  context: FormatContext;
+  date: (d: D, style?: DateStyle) => string;
+  dateTime: (d: D, opts?: {
+    withYear?: boolean;
+  }) => string;
+  time: (d: D, opts?: {
+    seconds?: boolean;
+  }) => string;
+  monthYear: (d: D) => string;
+  dateRange: (a: D, b: D) => string;
+  calendarDate: (iso: string, opts?: {
+    withYear?: boolean;
+  }) => string;
+  relative: (d: D, now: D) => string;
+  calendarDateTime: (d: D, now: D, labels: DayLabels) => string;
+  duration: (seconds: number, opts?: {
+    style?: "short" | "long";
+  }) => string;
+  number: (v: number, opts?: Intl.NumberFormatOptions) => string;
+  currency: (v: number, opts?: CurrencyOptions) => string;
+  percent: (ratio: number, opts?: {
+    digits?: number;
+  }) => string;
+  compact: (v: number) => string;
+  list: (items: readonly string[], opts?: {
+    or?: boolean;
+  }) => string;
+  fileSize: (bytes: number) => string;
+  parseNumber: (text: string) => number | null;
+};
+export type Formatter = ReturnType<typeof createFormatter>;
+export {};

package/dist/format/formatter.js

@@ -0,0 +1,31 @@
+import { contextOf } from "./context.js";
+import { formatCalendarDate, formatCalendarDateTime, formatDate, formatDateRange, formatDateTime, formatDuration, formatMonthYear, formatRelativeTime, formatTime } from "./dates.js";
+import { formatCompact, formatCurrency, formatFileSize, formatList, formatNumber, formatPercent, parseNumber } from "./numbers.js";
+// src/format/formatter.ts
+/**
+* Bağlama bağlanmış biçimlendirici: sunucuda `createFormatter({ locale, timeZone })`, istemcide
+* `useFormatter()` aynı nesneyi verir. Bileşenler ve uygulama her yerde aynı metni üretir.
+*/
+function createFormatter(ctx) {
+	const c = contextOf(ctx);
+	return {
+		context: c,
+		date: (d, style) => formatDate(d, c, style),
+		dateTime: (d, opts) => formatDateTime(d, c, opts),
+		time: (d, opts) => formatTime(d, c, opts),
+		monthYear: (d) => formatMonthYear(d, c),
+		dateRange: (a, b) => formatDateRange(a, b, c),
+		calendarDate: (iso, opts) => formatCalendarDate(iso, c, opts),
+		relative: (d, now) => formatRelativeTime(d, now, c),
+		calendarDateTime: (d, now, labels) => formatCalendarDateTime(d, now, labels, c),
+		duration: (seconds, opts) => formatDuration(seconds, c, opts),
+		number: (v, opts) => formatNumber(v, c, opts),
+		currency: (v, opts) => formatCurrency(v, c, opts),
+		percent: (ratio, opts) => formatPercent(ratio, c, opts),
+		compact: (v) => formatCompact(v, c),
+		list: (items, opts) => formatList(items, c, opts),
+		fileSize: (bytes) => formatFileSize(bytes, c),
+		parseNumber: (text) => parseNumber(text, c)
+	};
+}
+export { createFormatter };

package/dist/format/numbers.d.ts

@@ -0,0 +1,35 @@
+import { FormatContext } from "./context.js";
+/** "1.234.567" · "1,234,567"; ondalık basamak sınırı verilebilir. */
+export declare function formatNumber(value: number, ctx?: Partial<FormatContext>, options?: Intl.NumberFormatOptions): string;
+export interface CurrencyOptions {
+  /** ISO 4217 para birimi; varsayılan TRY. */
+  currency?: string;
+  /** Kuruşsuz göster (tam sayıya yuvarlar). */
+  whole?: boolean;
+}
+/**
+ * Para: "₺1.234,56" · "₺1,234.56"; dar simge her dilde aynıdır (İngilizcede "TRY 1,234.56"
+ * yerine "₺1,234.56"). Kuruş her zaman iki basamaktır; `whole` ile yuvarlanır.
+ */
+export declare function formatCurrency(value: number, ctx?: Partial<FormatContext>, { currency, whole }?: CurrencyOptions): string;
+/** Oran (0,42) → "%42" · "42%"; basamak sayısı verilebilir. */
+export declare function formatPercent(ratio: number, ctx?: Partial<FormatContext>, { digits }?: {
+  digits?: number;
+}): string;
+/** Kısa büyük sayı: "1,2 Mn", "12 B" · "1.2M", "12K". */
+export declare function formatCompact(value: number, ctx?: Partial<FormatContext>): string;
+/** "a, b ve c" · "a, b, and c"; `or` ile "a, b veya c". */
+export declare function formatList(items: readonly string[], ctx?: Partial<FormatContext>, { or }?: {
+  or?: boolean;
+}): string;
+/**
+ * Dosya boyutu (1000 tabanlı, işletim sistemlerinin gösterdiği gibi): "850 bayt", "1,5 MB".
+ */
+export declare function formatFileSize(bytes: number, ctx?: Partial<FormatContext>): string;
+/**
+ * Kullanıcının yazdığı sayıyı okur: "1.234,56" (tr) → 1234.56, "1,234.56" (en) → 1234.56,
+ * "-₺1.234,50" → -1234.5. Baştaki ya da sondaki para simgesi yok sayılır; boşluk yalnız basamak
+ * ayracı olarak ("1 234 567") kabul edilir. Yüzde kabul edilmez ("%42" 42 mi 0,42 mi belirsizdir).
+ * Okunamazsa `null`.
+ */
+export declare function parseNumber(text: string, ctx?: Partial<FormatContext>): number | null;

package/dist/format/numbers.js

@@ -0,0 +1,110 @@
+import { contextOf, memo } from "./context.js";
+// src/format/numbers.ts
+const nf = memo((k) => {
+	const [locale = "tr-TR", json = "{}"] = k.split("\0");
+	return new Intl.NumberFormat(locale, JSON.parse(json));
+});
+const numberFormat = (locale, options) => nf(`${locale}\u0000${JSON.stringify(options)}`);
+const finite = (v) => {
+	if (!Number.isFinite(v)) throw new RangeError("Sayı sonlu olmalı");
+	return v;
+};
+/** "1.234.567" · "1,234,567"; ondalık basamak sınırı verilebilir. */
+function formatNumber(value, ctx, options = {}) {
+	return numberFormat(contextOf(ctx).locale, options).format(finite(value));
+}
+/**
+* Para: "₺1.234,56" · "₺1,234.56"; dar simge her dilde aynıdır (İngilizcede "TRY 1,234.56"
+* yerine "₺1,234.56"). Kuruş her zaman iki basamaktır; `whole` ile yuvarlanır.
+*/
+function formatCurrency(value, ctx, { currency = "TRY", whole = false } = {}) {
+	return numberFormat(contextOf(ctx).locale, {
+		style: "currency",
+		currency,
+		currencyDisplay: "narrowSymbol",
+		...whole ? {
+			minimumFractionDigits: 0,
+			maximumFractionDigits: 0
+		} : {}
+	}).format(finite(value));
+}
+/** Oran (0,42) → "%42" · "42%"; basamak sayısı verilebilir. */
+function formatPercent(ratio, ctx, { digits = 0 } = {}) {
+	return numberFormat(contextOf(ctx).locale, {
+		style: "percent",
+		minimumFractionDigits: 0,
+		maximumFractionDigits: digits
+	}).format(finite(ratio));
+}
+/** Kısa büyük sayı: "1,2 Mn", "12 B" · "1.2M", "12K". */
+function formatCompact(value, ctx) {
+	return numberFormat(contextOf(ctx).locale, {
+		notation: "compact",
+		maximumFractionDigits: 1
+	}).format(finite(value));
+}
+const lf = memo((locale) => new Intl.ListFormat(locale, {
+	style: "long",
+	type: "conjunction"
+}));
+const lfOr = memo((locale) => new Intl.ListFormat(locale, {
+	style: "long",
+	type: "disjunction"
+}));
+/** "a, b ve c" · "a, b, and c"; `or` ile "a, b veya c". */
+function formatList(items, ctx, { or = false } = {}) {
+	const { locale } = contextOf(ctx);
+	return (or ? lfOr(locale) : lf(locale)).format(items);
+}
+const SIZE_UNITS = [
+	"byte",
+	"kilobyte",
+	"megabyte",
+	"gigabyte",
+	"terabyte"
+];
+/**
+* Dosya boyutu (1000 tabanlı, işletim sistemlerinin gösterdiği gibi): "850 bayt", "1,5 MB".
+*/
+function formatFileSize(bytes, ctx) {
+	if (!Number.isFinite(bytes) || bytes < 0) throw new RangeError("Geçersiz boyut");
+	let value = bytes;
+	let i = 0;
+	const rounded = () => {
+		const f = i === 0 ? 1 : 10;
+		return Math.round(value * f) / f;
+	};
+	while (rounded() >= 1e3 && i < SIZE_UNITS.length - 1) {
+		value /= 1e3;
+		i++;
+	}
+	return numberFormat(contextOf(ctx).locale, {
+		style: "unit",
+		unit: SIZE_UNITS[i],
+		unitDisplay: i === 0 ? "long" : "short",
+		maximumFractionDigits: i === 0 ? 0 : 1
+	}).format(value);
+}
+/**
+* Kullanıcının yazdığı sayıyı okur: "1.234,56" (tr) → 1234.56, "1,234.56" (en) → 1234.56,
+* "-₺1.234,50" → -1234.5. Baştaki ya da sondaki para simgesi yok sayılır; boşluk yalnız basamak
+* ayracı olarak ("1 234 567") kabul edilir. Yüzde kabul edilmez ("%42" 42 mi 0,42 mi belirsizdir).
+* Okunamazsa `null`.
+*/
+function parseNumber(text, ctx) {
+	const { locale } = contextOf(ctx);
+	const parts = numberFormat(locale, {}).formatToParts(12345.6);
+	const group = parts.find((p) => p.type === "group")?.value ?? ".";
+	const decimal = parts.find((p) => p.type === "decimal")?.value ?? ",";
+	let body = text.trim().replace(/^[−–]/, "-");
+	const negative = body.startsWith("-");
+	if (negative) body = body.slice(1).trimStart();
+	body = body.replace(/^[₺$€£]\s*/, "").replace(/\s*[₺$€£]$/, "");
+	const esc = (c) => c.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	const G = `(?:${esc(group)}|[ \\u00a0\\u202f])`;
+	const D = esc(decimal);
+	if (!new RegExp(`^(\\d+|\\d{1,3}(${G}\\d{3})+)(${D}\\d+)?$`).test(body)) return null;
+	const n = Number(body.replace(new RegExp(G, "g"), "").replace(decimal, "."));
+	return negative && n !== 0 ? -n : n;
+}
+export { formatCompact, formatCurrency, formatFileSize, formatList, formatNumber, formatPercent, parseNumber };