@jirawatpyk/aura-react 4.16.0 → 4.17.0

package/dist/server/index.d.ts

@@ -0,0 +1,171 @@
+import * as React$1 from 'react';
+
+export type StatusTone = "neutral" | "progress" | "ready" | "blocked";
+/** ISO date string, `YYYY-MM-DD` (Gregorian — the era is display only). */
+export type ISODate = string;
+export interface DateDisplayOptions {
+	/** Components: the AuraProvider's locale, else `en`. `formatDate()` (no provider to read): `th` unless given. */
+	locale?: "th" | "en" | "sv" | undefined;
+	/** `buddhist` (พ.ศ.; default for th) or `gregory` (ค.ศ.; default for en and sv). */
+	calendar?: "buddhist" | "gregory" | undefined;
+}
+export interface ThemeOptions {
+	/** The project's brand colour, #rgb or #rrggbb. Replaces AURA violet (links, focus ring, selection, info, progress, creative shadow in dark, mesh). */
+	brand: string;
+	/** Optional signal colour; replaces AURA lime in the accent dot and mesh only (success/ready stay green). */
+	signal?: string | undefined;
+	/** ink (default): primary buttons stay zinc ink. brand: primary buttons use the brand colour. */
+	primary?: "ink" | "brand" | undefined;
+	name?: string | undefined;
+}
+export interface ThemeCheck {
+	theme: "light" | "dark";
+	pair: string;
+	ratio: number;
+	target: number;
+	pass: boolean;
+}
+export interface Theme {
+	name: string | null;
+	brand: Record<50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900, string>;
+	signal: Record<50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900, string> | null;
+	light: Record<string, string>;
+	dark: Record<string, string>;
+	checks: ThemeCheck[];
+	ok: boolean;
+	/** CSS overriding the tokens. No selector: the whole page. A selector (".tenant-acme") scopes it. Load after aura.css. */
+	css(selector?: string): string;
+}
+/** Options for formatDate: locale/calendar plus a preset or any Intl.DateTimeFormat options. */
+export type FormatDateOptions = DateDisplayOptions & {
+	format?: "short" | "long" | "numeric" | Intl.DateTimeFormatOptions | undefined;
+};
+export declare function toISO(d: Date | null | undefined): ISODate | null;
+export declare function fromISO(s: ISODate | null | undefined): Date | null;
+/** Parse typed text: dd/mm/yyyy (Buddhist years ≥ 2400 are converted), d-m-yyyy, d.m.yyyy, yyyy-mm-dd or '18 ก.ย. 2569' / '18 Sep 2026'. */
+export declare function parseDate(text: string | null | undefined): ISODate | null;
+/** 1536 → "1.5 KB". */
+export declare function formatBytes(n: number | null | undefined): string;
+/** Parse typed time: 9 · 09 · 930 · 0930 · 9:30 · 9.30 · 09.30 น. · 9:30 pm → "HH:mm" (24-hour) or null. */
+export declare function parseTime(text: string | null | undefined): string | null;
+/** The tone the pill would pick for a status word. */
+declare function toneFor(status: unknown): StatusTone;
+/** Every built-in label. Function entries build the text from their arguments. */
+export interface AuraStrings {
+	close: string;
+	dismiss: string;
+	dismissToast: string;
+	showPassword: string;
+	filters: string;
+	search: string;
+	clearFilters: string;
+	results: (n: number) => string;
+	commandMenu: string;
+	commandPlaceholder: string;
+	commandHint: string;
+	errorSummary: (n: number) => string;
+	notifications: string;
+	mainNav: string;
+	breadcrumb: string;
+	navigation: string;
+	openNav: string;
+	collapseNav: string;
+	expandNav: string;
+	searching: string;
+	noMatches: string;
+	clear: (what?: string) => string;
+	keepTyping: (total: number) => string;
+	sortAsc: string;
+	sortDesc: string;
+	pin: string;
+	unpin: string;
+	moveLeft: string;
+	moveRight: string;
+	hideColumn: string;
+	resetColumns: string;
+	selectRows: string;
+	selectAllRows: string;
+	deselectAllRows: string;
+	selectAll: string;
+	selectRow: (k: React$1.ReactNode) => string;
+	selectedCount: (c: number) => string;
+	pinned: string;
+	columnOptions: (label?: string) => string;
+	column: (label?: string) => string;
+	columns: string;
+	showHideColumns: string;
+	empty: string;
+	loading: string;
+	loadingRows: string;
+	range: (a: number | string, b: number | string, total: number) => string;
+	page: (p: number, total: number) => string;
+	prevPage: string;
+	nextPage: string;
+	rowCount: (c: number) => string;
+	actions: string;
+	optional: string;
+	timePlaceholder: string;
+	timeInvalid: string;
+	timeOutOfRange: (a: number | string, b: number | string) => string;
+	dropFiles: string;
+	browse: string;
+	browseOne: string;
+	remove: (n: number | string) => string;
+	fileTooBig: (max?: number | string) => string;
+	fileWrongType: string;
+	tooManyFiles: (n: number | string) => string;
+	colorScheme: string;
+	increase: string;
+	decrease: string;
+	stepDone: string;
+	stepOf: (i: number, total: number) => string;
+	schemeLight: string;
+	schemeDark: string;
+	schemeSystem: string;
+	uploading: string;
+	images: string;
+	pagination: string;
+	pageN: (p: number) => string;
+	accepts: (list?: string, max?: number | string) => string;
+}
+export declare const STRINGS: {
+	en: AuraStrings;
+	th: AuraStrings;
+	sv: AuraStrings;
+};
+/** WCAG contrast ratio of two #hex colours. */
+export declare function contrast(a: string, b: string): number;
+/** A 50–900 scale around one colour: same hue, AURA's lightness steps, chroma kept in gamut. */
+declare function scale(hex: string): Theme["brand"];
+/**
+ * createTheme({ brand, signal?, primary?: 'ink' | 'brand', name? })
+ * → { name, brand: {50…900}, signal: {50…900}|null, light: {token: #hex}, dark: {…}, checks: [{pair, ratio, target, pass}], ok, css(selector?) }
+ */
+export declare function createTheme(opts: ThemeOptions): Theme;
+/** `system` follows the operating system and changes with it. */
+export type ColorScheme = "light" | "dark" | "system";
+export interface ColorSchemeOptions {
+	/** localStorage key for the choice. Default `aura-color-scheme`. */
+	storageKey?: string | undefined;
+	/** Used when nothing is saved. Default `system`. */
+	defaultScheme?: ColorScheme | undefined;
+}
+/** The script ColorSchemeScript renders, as a string — for frameworks that want it in a raw <head> template. */
+export declare function colorSchemeScript(options?: ColorSchemeOptions): string;
+/** Min-width breakpoints in px, mirroring the aura-bp-* tokens. */
+export declare const breakpoints: {
+	sm: 640;
+	md: 768;
+	lg: 1024;
+	xl: 1280;
+};
+/** Format an ISO date for display: "24 Sept 2026" by default (English, Gregorian); `{ locale: 'th' }` gives
+ * "24 ก.ย. 2569", `{ locale: 'sv' }` "24 sep. 2026". Options as in the package root's formatDate. */
+export declare function formatDate(iso: ISODate | null | undefined, opts?: FormatDateOptions): string;
+
+export {
+	scale as brandScale,
+	toneFor as statusTone,
+};
+
+export {};