@octans/ui 1.0.0

package/dist/utils/tokens.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The design token registry.
+ *
+ * This is the machine-readable companion to `styles/tokens.scss` — it drives
+ * the Theme Builder, and is exported so applications can build their own
+ * theming UI without hardcoding a token list.
+ *
+ * Keep it in sync when adding a token. `tokens.test.ts` fails if the stylesheet
+ * and this registry drift apart, so it cannot rot silently.
+ */
+export type TokenKind = 'color' | 'shadow' | 'radius' | 'font';
+export interface TokenDefinition {
+    /** Token name without the `--octans-` prefix. */
+    name: string;
+    kind: TokenKind;
+    /** What it's for. Shown in the Theme Builder. */
+    description?: string;
+    /**
+     * Set when the stylesheet computes this token from others (via `var()`
+     * chains or `color-mix()`). A theming UI can hide these by default — they
+     * follow the tokens they are derived from, and only need touching to break
+     * the derivation on purpose.
+     */
+    derived?: boolean;
+}
+export interface TokenGroup {
+    title: string;
+    description?: string;
+    /** Primitives are the raw palette; components should only use semantic. */
+    tier: 'primitive' | 'semantic';
+    tokens: TokenDefinition[];
+}
+export interface TokenRamp {
+    /** Token prefix. `neutral` covers `neutral-0`, `neutral-50`, and so on. */
+    prefix: string;
+    /** Human label, for a theming UI. */
+    title: string;
+    /**
+     * The step numbers, ascending.
+     *
+     * They are positions, not indices — 500 sits halfway along a 0–1000 ramp
+     * whether or not there is a step either side of it. A generator that treats
+     * them as evenly spaced indices produces a ramp that no longer matches the
+     * hand-authored one it replaced.
+     */
+    steps: number[];
+}
+/**
+ * The primitive ramps, declared once so a theming UI can offer to generate a
+ * whole ramp rather than twelve separate colour pickers. `TOKEN_GROUPS` below
+ * is built from these, so the two cannot disagree about which steps exist.
+ */
+export declare const TOKEN_RAMPS: TokenRamp[];
+/** Lookup by prefix, e.g. `TOKEN_RAMP_BY_PREFIX['primary']`. */
+export declare const TOKEN_RAMP_BY_PREFIX: Record<string, TokenRamp>;
+export declare const TOKEN_GROUPS: TokenGroup[];
+/** Every token name, flattened. */
+export declare const TOKEN_NAMES: string[];
+/** Lookup by name, e.g. `TOKEN_BY_NAME['surface-sunken']`. */
+export declare const TOKEN_BY_NAME: Record<string, TokenDefinition>;
+/** `surface-sunken` → `--octans-surface-sunken` */
+export declare function tokenVar(name: string): string;

package/dist/utils/translate.d.ts

@@ -0,0 +1,27 @@
+export type TranslationDictionary = Record<string, string>;
+/**
+ * Replaces every registered string for `locale`.
+ *
+ * ```ts
+ * setTranslations('fr', { 'ui.modal.close': 'Fermer' })
+ * ```
+ */
+export declare function setTranslations(locale: string, dictionary: TranslationDictionary): void;
+/** Merges `dictionary` into whatever is already registered for `locale`. */
+export declare function addTranslations(locale: string, dictionary: TranslationDictionary): void;
+/**
+ * Switches the active locale. Unknown locales are still accepted — lookups
+ * simply fall through to English until a dictionary is registered for them.
+ */
+export declare function setTranslationLocale(locale: string): void;
+export declare function getTranslationLocale(): string;
+export declare function getAvailableLocales(): string[];
+/**
+ * Looks up `key` in the active locale, falling back to English and finally to
+ * the key itself, then interpolates any `{placeholder}` values from `args`.
+ *
+ * Returning the key on a miss is deliberate: a missing translation shows up as
+ * a visible, greppable string instead of an empty element.
+ */
+export declare function translate(key: string, args?: Record<string, any>): string;
+export declare const $t: typeof translate;

package/dist/zoneCountries-CWZGMHyp.js

@@ -0,0 +1,353 @@
+//#region src/components/TimezonePicker/zoneCountries.ts
+var e = {
+	"Africa/Abidjan": "CI",
+	"Africa/Accra": "GH",
+	"Africa/Algiers": "DZ",
+	"Africa/Bissau": "GW",
+	"Africa/Cairo": "EG",
+	"Africa/Casablanca": "MA",
+	"Africa/Ceuta": "ES",
+	"Africa/El_Aaiun": "EH",
+	"Africa/Johannesburg": "ZA",
+	"Africa/Juba": "SS",
+	"Africa/Khartoum": "SD",
+	"Africa/Lagos": "NG",
+	"Africa/Maputo": "MZ",
+	"Africa/Monrovia": "LR",
+	"Africa/Nairobi": "KE",
+	"Africa/Ndjamena": "TD",
+	"Africa/Sao_Tome": "ST",
+	"Africa/Tripoli": "LY",
+	"Africa/Tunis": "TN",
+	"Africa/Windhoek": "NA",
+	"America/Adak": "US",
+	"America/Anchorage": "US",
+	"America/Araguaina": "BR",
+	"America/Argentina/Buenos_Aires": "AR",
+	"America/Argentina/Catamarca": "AR",
+	"America/Argentina/Cordoba": "AR",
+	"America/Argentina/Jujuy": "AR",
+	"America/Argentina/La_Rioja": "AR",
+	"America/Argentina/Mendoza": "AR",
+	"America/Argentina/Rio_Gallegos": "AR",
+	"America/Argentina/Salta": "AR",
+	"America/Argentina/San_Juan": "AR",
+	"America/Argentina/San_Luis": "AR",
+	"America/Argentina/Tucuman": "AR",
+	"America/Argentina/Ushuaia": "AR",
+	"America/Asuncion": "PY",
+	"America/Atikokan": "CA",
+	"America/Bahia": "BR",
+	"America/Bahia_Banderas": "MX",
+	"America/Barbados": "BB",
+	"America/Belem": "BR",
+	"America/Belize": "BZ",
+	"America/Blanc-Sablon": "CA",
+	"America/Boa_Vista": "BR",
+	"America/Bogota": "CO",
+	"America/Boise": "US",
+	"America/Cambridge_Bay": "CA",
+	"America/Campo_Grande": "BR",
+	"America/Cancun": "MX",
+	"America/Caracas": "VE",
+	"America/Cayenne": "GF",
+	"America/Chicago": "US",
+	"America/Chihuahua": "MX",
+	"America/Costa_Rica": "CR",
+	"America/Creston": "CA",
+	"America/Cuiaba": "BR",
+	"America/Curacao": "CW",
+	"America/Danmarkshavn": "GL",
+	"America/Dawson": "CA",
+	"America/Dawson_Creek": "CA",
+	"America/Denver": "US",
+	"America/Detroit": "US",
+	"America/Edmonton": "CA",
+	"America/Eirunepe": "BR",
+	"America/El_Salvador": "SV",
+	"America/Fort_Nelson": "CA",
+	"America/Fortaleza": "BR",
+	"America/Glace_Bay": "CA",
+	"America/Godthab": "GL",
+	"America/Goose_Bay": "CA",
+	"America/Grand_Turk": "TC",
+	"America/Guatemala": "GT",
+	"America/Guayaquil": "EC",
+	"America/Guyana": "GY",
+	"America/Halifax": "CA",
+	"America/Havana": "CU",
+	"America/Hermosillo": "MX",
+	"America/Indiana/Indianapolis": "US",
+	"America/Indiana/Knox": "US",
+	"America/Indiana/Marengo": "US",
+	"America/Indiana/Petersburg": "US",
+	"America/Indiana/Tell_City": "US",
+	"America/Indiana/Vevay": "US",
+	"America/Indiana/Vincennes": "US",
+	"America/Indiana/Winamac": "US",
+	"America/Inuvik": "CA",
+	"America/Iqaluit": "CA",
+	"America/Jamaica": "JM",
+	"America/Juneau": "US",
+	"America/Kentucky/Louisville": "US",
+	"America/Kentucky/Monticello": "US",
+	"America/La_Paz": "BO",
+	"America/Lima": "PE",
+	"America/Los_Angeles": "US",
+	"America/Maceio": "BR",
+	"America/Managua": "NI",
+	"America/Manaus": "BR",
+	"America/Martinique": "MQ",
+	"America/Matamoros": "MX",
+	"America/Mazatlan": "MX",
+	"America/Menominee": "US",
+	"America/Merida": "MX",
+	"America/Metlakatla": "US",
+	"America/Mexico_City": "MX",
+	"America/Miquelon": "PM",
+	"America/Moncton": "CA",
+	"America/Monterrey": "MX",
+	"America/Montevideo": "UY",
+	"America/Nassau": "BS",
+	"America/New_York": "US",
+	"America/Nipigon": "CA",
+	"America/Nome": "US",
+	"America/Noronha": "BR",
+	"America/North_Dakota/Beulah": "US",
+	"America/North_Dakota/Center": "US",
+	"America/North_Dakota/New_Salem": "US",
+	"America/Ojinaga": "MX",
+	"America/Panama": "PA",
+	"America/Pangnirtung": "CA",
+	"America/Paramaribo": "SR",
+	"America/Phoenix": "US",
+	"America/Port_of_Spain": "TT",
+	"America/Port-au-Prince": "HT",
+	"America/Porto_Velho": "BR",
+	"America/Puerto_Rico": "PR",
+	"America/Punta_Arenas": "CL",
+	"America/Rainy_River": "CA",
+	"America/Rankin_Inlet": "CA",
+	"America/Recife": "BR",
+	"America/Regina": "CA",
+	"America/Resolute": "CA",
+	"America/Rio_Branco": "BR",
+	"America/Santarem": "BR",
+	"America/Santiago": "CL",
+	"America/Santo_Domingo": "DO",
+	"America/Sao_Paulo": "BR",
+	"America/Scoresbysund": "GL",
+	"America/Sitka": "US",
+	"America/St_Johns": "CA",
+	"America/Swift_Current": "CA",
+	"America/Tegucigalpa": "HN",
+	"America/Thule": "GL",
+	"America/Thunder_Bay": "CA",
+	"America/Tijuana": "MX",
+	"America/Toronto": "CA",
+	"America/Vancouver": "CA",
+	"America/Whitehorse": "CA",
+	"America/Winnipeg": "CA",
+	"America/Yakutat": "US",
+	"America/Yellowknife": "CA",
+	"Antarctica/Casey": "AQ",
+	"Antarctica/Davis": "AQ",
+	"Antarctica/DumontDUrville": "AQ",
+	"Antarctica/Macquarie": "AU",
+	"Antarctica/Mawson": "AQ",
+	"Antarctica/Palmer": "AQ",
+	"Antarctica/Rothera": "AQ",
+	"Antarctica/Syowa": "AQ",
+	"Antarctica/Troll": "AQ",
+	"Antarctica/Vostok": "AQ",
+	"Asia/Almaty": "KZ",
+	"Asia/Amman": "JO",
+	"Asia/Anadyr": "RU",
+	"Asia/Aqtau": "KZ",
+	"Asia/Aqtobe": "KZ",
+	"Asia/Ashgabat": "TM",
+	"Asia/Atyrau": "KZ",
+	"Asia/Baghdad": "IQ",
+	"Asia/Baku": "AZ",
+	"Asia/Bangkok": "TH",
+	"Asia/Barnaul": "RU",
+	"Asia/Beirut": "LB",
+	"Asia/Bishkek": "KG",
+	"Asia/Brunei": "BN",
+	"Asia/Chita": "RU",
+	"Asia/Choibalsan": "MN",
+	"Asia/Colombo": "LK",
+	"Asia/Damascus": "SY",
+	"Asia/Dhaka": "BD",
+	"Asia/Dili": "TL",
+	"Asia/Dubai": "AE",
+	"Asia/Dushanbe": "TJ",
+	"Asia/Famagusta": "CY",
+	"Asia/Gaza": "PS",
+	"Asia/Hebron": "PS",
+	"Asia/Ho_Chi_Minh": "VN",
+	"Asia/Hong_Kong": "HK",
+	"Asia/Hovd": "MN",
+	"Asia/Irkutsk": "RU",
+	"Asia/Jakarta": "ID",
+	"Asia/Jayapura": "ID",
+	"Asia/Jerusalem": "IL",
+	"Asia/Kabul": "AF",
+	"Asia/Kamchatka": "RU",
+	"Asia/Karachi": "PK",
+	"Asia/Kathmandu": "NP",
+	"Asia/Khandyga": "RU",
+	"Asia/Kolkata": "IN",
+	"Asia/Krasnoyarsk": "RU",
+	"Asia/Kuala_Lumpur": "MY",
+	"Asia/Kuching": "MY",
+	"Asia/Macau": "MO",
+	"Asia/Magadan": "RU",
+	"Asia/Makassar": "ID",
+	"Asia/Manila": "PH",
+	"Asia/Nicosia": "CY",
+	"Asia/Novokuznetsk": "RU",
+	"Asia/Novosibirsk": "RU",
+	"Asia/Omsk": "RU",
+	"Asia/Oral": "KZ",
+	"Asia/Pontianak": "ID",
+	"Asia/Pyongyang": "KP",
+	"Asia/Qatar": "QA",
+	"Asia/Qostanay": "KZ",
+	"Asia/Qyzylorda": "KZ",
+	"Asia/Riyadh": "SA",
+	"Asia/Sakhalin": "RU",
+	"Asia/Samarkand": "UZ",
+	"Asia/Seoul": "KR",
+	"Asia/Shanghai": "CN",
+	"Asia/Singapore": "SG",
+	"Asia/Srednekolymsk": "RU",
+	"Asia/Taipei": "TW",
+	"Asia/Tashkent": "UZ",
+	"Asia/Tbilisi": "GE",
+	"Asia/Tehran": "IR",
+	"Asia/Thimphu": "BT",
+	"Asia/Tokyo": "JP",
+	"Asia/Tomsk": "RU",
+	"Asia/Ulaanbaatar": "MN",
+	"Asia/Urumqi": "CN",
+	"Asia/Ust-Nera": "RU",
+	"Asia/Vladivostok": "RU",
+	"Asia/Yakutsk": "RU",
+	"Asia/Yangon": "MM",
+	"Asia/Yekaterinburg": "RU",
+	"Asia/Yerevan": "AM",
+	"Atlantic/Azores": "PT",
+	"Atlantic/Bermuda": "BM",
+	"Atlantic/Canary": "ES",
+	"Atlantic/Cape_Verde": "CV",
+	"Atlantic/Faroe": "FO",
+	"Atlantic/Madeira": "PT",
+	"Atlantic/Reykjavik": "IS",
+	"Atlantic/South_Georgia": "GS",
+	"Atlantic/Stanley": "FK",
+	"Australia/Adelaide": "AU",
+	"Australia/Brisbane": "AU",
+	"Australia/Broken_Hill": "AU",
+	"Australia/Currie": "AU",
+	"Australia/Darwin": "AU",
+	"Australia/Eucla": "AU",
+	"Australia/Hobart": "AU",
+	"Australia/Lindeman": "AU",
+	"Australia/Lord_Howe": "AU",
+	"Australia/Melbourne": "AU",
+	"Australia/Perth": "AU",
+	"Australia/Sydney": "AU",
+	"Europe/Amsterdam": "NL",
+	"Europe/Andorra": "AD",
+	"Europe/Astrakhan": "RU",
+	"Europe/Athens": "GR",
+	"Europe/Belgrade": "RS",
+	"Europe/Berlin": "DE",
+	"Europe/Brussels": "BE",
+	"Europe/Bucharest": "RO",
+	"Europe/Budapest": "HU",
+	"Europe/Chisinau": "MD",
+	"Europe/Copenhagen": "DK",
+	"Europe/Dublin": "IE",
+	"Europe/Gibraltar": "GI",
+	"Europe/Helsinki": "FI",
+	"Europe/Istanbul": "TR",
+	"Europe/Kaliningrad": "RU",
+	"Europe/Kiev": "UA",
+	"Europe/Kirov": "RU",
+	"Europe/Lisbon": "PT",
+	"Europe/London": "GB",
+	"Europe/Luxembourg": "LU",
+	"Europe/Madrid": "ES",
+	"Europe/Malta": "MT",
+	"Europe/Minsk": "BY",
+	"Europe/Monaco": "MC",
+	"Europe/Moscow": "RU",
+	"Europe/Oslo": "NO",
+	"Europe/Paris": "FR",
+	"Europe/Prague": "CZ",
+	"Europe/Riga": "LV",
+	"Europe/Rome": "IT",
+	"Europe/Samara": "RU",
+	"Europe/Saratov": "RU",
+	"Europe/Simferopol": "RU",
+	"Europe/Sofia": "BG",
+	"Europe/Stockholm": "SE",
+	"Europe/Tallinn": "EE",
+	"Europe/Tirane": "AL",
+	"Europe/Ulyanovsk": "RU",
+	"Europe/Uzhgorod": "UA",
+	"Europe/Vienna": "AT",
+	"Europe/Vilnius": "LT",
+	"Europe/Volgograd": "RU",
+	"Europe/Warsaw": "PL",
+	"Europe/Zaporozhye": "UA",
+	"Europe/Zurich": "CH",
+	"Indian/Chagos": "IO",
+	"Indian/Christmas": "CX",
+	"Indian/Cocos": "CC",
+	"Indian/Kerguelen": "TF",
+	"Indian/Mahe": "SC",
+	"Indian/Maldives": "MV",
+	"Indian/Mauritius": "MU",
+	"Indian/Reunion": "RE",
+	"Pacific/Apia": "WS",
+	"Pacific/Auckland": "NZ",
+	"Pacific/Bougainville": "PG",
+	"Pacific/Chatham": "NZ",
+	"Pacific/Chuuk": "FM",
+	"Pacific/Easter": "CL",
+	"Pacific/Efate": "VU",
+	"Pacific/Enderbury": "KI",
+	"Pacific/Fakaofo": "TK",
+	"Pacific/Fiji": "FJ",
+	"Pacific/Funafuti": "TV",
+	"Pacific/Galapagos": "EC",
+	"Pacific/Gambier": "PF",
+	"Pacific/Guadalcanal": "SB",
+	"Pacific/Guam": "GU",
+	"Pacific/Honolulu": "US",
+	"Pacific/Kiritimati": "KI",
+	"Pacific/Kosrae": "FM",
+	"Pacific/Kwajalein": "MH",
+	"Pacific/Majuro": "MH",
+	"Pacific/Marquesas": "PF",
+	"Pacific/Nauru": "NR",
+	"Pacific/Niue": "NU",
+	"Pacific/Norfolk": "NF",
+	"Pacific/Noumea": "NC",
+	"Pacific/Pago_Pago": "AS",
+	"Pacific/Palau": "PW",
+	"Pacific/Pitcairn": "PN",
+	"Pacific/Pohnpei": "FM",
+	"Pacific/Port_Moresby": "PG",
+	"Pacific/Rarotonga": "CK",
+	"Pacific/Tahiti": "PF",
+	"Pacific/Tarawa": "KI",
+	"Pacific/Tongatapu": "TO",
+	"Pacific/Wake": "UM",
+	"Pacific/Wallis": "WF"
+};
+//#endregion
+export { e as ZONE_COUNTRIES, e as default };

package/package.json

@@ -0,0 +1,120 @@
+{
+  "name": "@octans/ui",
+  "version": "1.0.0",
+  "description": "A Vue 3 component library — accessible, themeable UI primitives and application shell components.",
+  "keywords": [
+    "vue",
+    "vue3",
+    "components",
+    "component-library",
+    "design-system",
+    "ui",
+    "octans"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tarwin/octans-ui.git"
+  },
+  "homepage": "https://octans.dev",
+  "bugs": {
+    "url": "https://github.com/tarwin/octans-ui/issues"
+  },
+  "type": "module",
+  "main": "./dist/ui.js",
+  "module": "./dist/ui.js",
+  "types": "./dist/lib.d.ts",
+  "bin": {
+    "octans-icons": "./bin/octans-icons.mjs"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/lib.d.ts",
+      "import": "./dist/ui.js",
+      "default": "./dist/ui.js"
+    },
+    "./style.css": "./dist/style.css",
+    "./dist/*": "./dist/*",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@floating-ui/dom": "^1.8.0",
+    "@iconify/vue": "^5.0.1",
+    "dayjs": "^1.11.21",
+    "lodash-es": "^4.18.1",
+    "maska": "^3.2.0",
+    "reka-ui": "^2.10.1"
+  },
+  "peerDependencies": {
+    "vue": "^3.5.0",
+    "vue-router": "^4.0.0 || ^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vue-router": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@storybook/addon-docs": "^10.5.7",
+    "@storybook/addon-links": "^10.5.7",
+    "@storybook/vue3-vite": "^10.5.7",
+    "@tsconfig/node24": "^24.0.4",
+    "@types/lodash-es": "^4.17.12",
+    "@types/node": "^24.13.3",
+    "@vitejs/plugin-vue": "^6.0.8",
+    "@vitest/coverage-v8": "^4.1.10",
+    "@vue/eslint-config-prettier": "^10.2.0",
+    "@vue/eslint-config-typescript": "^14.9.0",
+    "@vue/test-utils": "^2.4.11",
+    "@vue/tsconfig": "^0.9.1",
+    "eslint": "^10.8.1",
+    "eslint-plugin-storybook": "^10.5.7",
+    "eslint-plugin-vue": "^10.10.0",
+    "jsdom": "^30.0.1",
+    "npm-run-all2": "^9.0.3",
+    "package-version-git-tag": "^3.0.0",
+    "prettier": "^3.9.6",
+    "sass": "^1.102.0",
+    "storybook": "^10.5.7",
+    "storybook-vue3-router": "^7.0.0",
+    "typescript": "~6.0.3",
+    "vite": "^8.2.1",
+    "vite-plugin-dts": "^5.0.3",
+    "vite-plus": "^0.2.8",
+    "vitest": "^4.1.10",
+    "vue": "^3.5.41",
+    "vue-router": "^4.6.4",
+    "vue-tsc": "^3.3.9"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "dev": "pnpm storybook",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build",
+    "type-check": "vue-tsc --noEmit -p tsconfig.app.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "check:contrast": "node scripts/check-contrast.mjs",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write src/ .storybook/ scripts/ *.ts *.js",
+    "format:check": "prettier --check src/ .storybook/ scripts/ *.ts *.js",
+    "icons:bundle": "node scripts/build-icon-bundle.mjs",
+    "check:icons": "node scripts/check-icon-bundle.mjs",
+    "build": "pnpm run build-lib",
+    "build-lib": "vp build --config vite.config-lib.ts && vp build --config vite.config-umd.ts",
+    "verify": "pnpm run lint && pnpm run type-check && pnpm run test && pnpm run check:contrast && pnpm run check:icons && pnpm run build-lib",
+    "tag": "package-version-git-tag --push"
+  }
+}