@myghf/ui 0.2.0 → 0.3.0

package/dist/lib/date.d.ts

@@ -7,4 +7,11 @@ export declare function clampTime(d: Date, time: string): Date;
 export declare function sortRange(a: Date, b: Date): [Date, Date];
 export declare function sortRange(a: Date | null, b: Date | null): [Date | null, Date | null];
 export declare function toISODate(d: Date): string;
+export declare function buildHourOptions(hourFormat: '12' | '24'): number[];
+export declare function buildMinuteOptions(minuteStep: number): number[];
+export declare function to12Hour(hour24: number): {
+    hour: number;
+    meridiem: 'am' | 'pm';
+};
+export declare function from12Hour(hour: number, meridiem: 'am' | 'pm'): number;
 //# sourceMappingURL=date.d.ts.map

package/dist/lib/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/lib/date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsC,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAE1G,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,GAAG,YAAY,CAEjD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAG9C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AACzD,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAA;AAMrF,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAIzC"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/lib/date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsC,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAE1G,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,GAAG,YAAY,CAEjD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAG9C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AACzD,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAA;AAMrF,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAIzC;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EAAE,CAGlE;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/D;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,CAKhF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAGtE"}

package/dist/lib/locale.d.ts

@@ -0,0 +1,6 @@
+export declare function getFirstDayOfWeek(locale: string): number;
+export declare function getWeekdayLabels(locale: string, weekStartsOn: number): string[];
+export declare function getMonthLabel(date: Date, locale: string): string;
+export declare function formatLocalizedDate(date: Date, locale: string): string;
+export declare function formatLocalizedTime(date: Date, locale: string, hourFormat: '12' | '24'): string;
+//# sourceMappingURL=locale.d.ts.map

package/dist/lib/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/lib/locale.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYxD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAO/E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAM/F"}

package/dist/lib/number.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Normalise a numeric field value: empty and non-finite inputs collapse to
+ * `null`, while `0` and every other finite number pass through unchanged.
+ */
+export declare function toNumberOrNull(value: number | null | undefined): number | null;
+/**
+ * Compose the `Intl.NumberFormatOptions` for a number field. Later sources win,
+ * so explicit `formatOptions` override the `currency` shorthand and `integer`
+ * forces zero fraction digits regardless of what came before.
+ */
+export declare function mergeFormatOptions(input: {
+    currency?: string;
+    formatOptions?: Intl.NumberFormatOptions;
+    integer?: boolean;
+}): Intl.NumberFormatOptions;
+//# sourceMappingURL=number.d.ts.map

package/dist/lib/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/lib/number.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAG9E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAA;IACxC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,IAAI,CAAC,mBAAmB,CAM3B"}

package/dist/lib/theme.d.ts

@@ -0,0 +1,36 @@
+import { ComputedRef, Ref } from 'vue';
+export type ThemeMode = 'light' | 'dark' | 'system';
+export type ThemeAttribute = 'both' | 'class' | 'data-theme';
+export interface UseThemeOptions {
+    /** localStorage key used to persist an explicit mode. Defaults to `'myghf-theme'`. */
+    storageKey?: string;
+    /** Which attribute(s) to write on `<html>`. Defaults to `'both'`. */
+    attribute?: ThemeAttribute;
+    /** Mode used when nothing is stored. Defaults to `'system'`. */
+    defaultMode?: ThemeMode;
+}
+export interface UseThemeReturn {
+    /** The user's chosen mode (`'system'` follows the OS). */
+    mode: Ref<ThemeMode>;
+    /** The effective mode after resolving `'system'` against the OS preference. */
+    resolved: ComputedRef<'light' | 'dark'>;
+    /** Convenience flag: `resolved === 'dark'`. */
+    isDark: ComputedRef<boolean>;
+    setMode(mode: ThemeMode): void;
+    toggle(): void;
+    enable(): void;
+    disable(): void;
+    reset(): void;
+}
+/**
+ * Builds an independent theme controller. Writes `.dark` and/or
+ * `data-theme="dark"` on `<html>` so the CSS dark token block activates.
+ * Safe to call during SSR: without a DOM it resolves to light and is a no-op.
+ */
+export declare function createTheme(options?: UseThemeOptions): UseThemeReturn;
+/**
+ * Returns a single shared theme controller, lazily created on first call.
+ * Later calls reuse it; in dev a mismatched options object logs a warning.
+ */
+export declare function useTheme(options?: UseThemeOptions): UseThemeReturn;
+//# sourceMappingURL=theme.d.ts.map

package/dist/lib/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/lib/theme.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAE3C,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AACnD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,CAAA;AAE5D,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qEAAqE;IACrE,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,gEAAgE;IAChE,WAAW,CAAC,EAAE,SAAS,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IACpB,+EAA+E;IAC/E,QAAQ,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,CAAC,CAAA;IACvC,+CAA+C;IAC/C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAC5B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC9B,MAAM,IAAI,IAAI,CAAA;IACd,MAAM,IAAI,IAAI,CAAA;IACd,OAAO,IAAI,IAAI,CAAA;IACf,KAAK,IAAI,IAAI,CAAA;CACd;AA4CD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CA4EzE;AAKD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,CAmBlE"}

package/dist/lib/tones.d.ts

@@ -0,0 +1,9 @@
+export type Tone = 'info' | 'success' | 'warning' | 'danger' | 'secondary';
+export interface ToneClasses {
+    soft: string;
+    outline: string;
+    icon: string;
+    role: 'alert' | 'status';
+}
+export declare const toneClasses: Record<Tone, ToneClasses>;
+//# sourceMappingURL=tones.d.ts.map

package/dist/lib/tones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tones.d.ts","sourceRoot":"","sources":["../../src/lib/tones.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE1E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;CACzB;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,CA+BjD,CAAA"}

package/dist/tailwindPreset.js

@@ -1,5 +1,6 @@
 /** @type {import('tailwindcss').Config} */
 export default {
+  darkMode: ['class', '.dark'],
   theme: {
     extend: {
       fontFamily: {

package/dist/tokens.css

@@ -79,3 +79,16 @@
   --myghf-info-800: 0 73 99;
   --myghf-info-900: 0 49 66;
 }
+
+[data-theme='dark'],
+.dark {
+  color-scheme: dark;
+
+  /* surfaces */
+  --myghf-background: 15 18 23;
+  --myghf-foreground: 243 244 246;
+  --myghf-surface: 26 30 37;
+  --myghf-surface-muted: 39 44 53;
+  --myghf-border: 55 61 71;
+  --myghf-muted: 156 163 175;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myghf/ui",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -36,6 +36,9 @@
     "typecheck": "vue-tsc --noEmit",
     "test": "vitest run",
     "changeset": "changeset",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
@@ -57,11 +60,14 @@
     "@vitejs/plugin-vue": "^6.0.7",
     "@vue/test-utils": "^2.5.1",
     "@vue/tsconfig": "^0.9.1",
+    "autoprefixer": "^10.6.1",
     "jsdom": "^30.1.1",
+    "postcss": "^8.5.28",
     "tailwindcss": "^3.4.19",
     "typescript": "~6.0.2",
     "vite": "^8.3.1",
     "vite-plugin-dts": "^4.5.4",
+    "vitepress": "^1.6.4",
     "vitest": "^4.1.10",
     "vue": "^3.5.39",
     "vue-tsc": "^3.3.5"