## 3.2.0 - 2026-07-03

### Added

- Re-export of `canonicalizeLocale()` from the package index, so consumers don't need a direct import of `langsys-js-typescript` to normalize locale identifiers.

### Changed

- **Base SDK bumped to `langsys-js-typescript` ^0.3.0 (CLDR-compliant).** No wrapper API changes, but consumers inherit the new SDK behavior:
    - Locale identifiers are canonicalized to BCP 47 everywhere (`en-us` → `en-US`) — on the wire, in cache keys, and in `$currentlyLoadedLocale` emissions. Comparisons against lowercase literals should be updated (or routed through the SDK's `canonicalizeLocale()`).
    - `detectPreferredLocale` matching is script-aware via CLDR likely-subtags (`zh-TW` matches `zh-Hant`, never falls back to `zh-Hans`); results come back canonical.
    - `{name}` interpolation now formats `number` params via `Intl.NumberFormat` and `Date` params via `Intl.DateTimeFormat` (medium date style) instead of `String()` / ISO 8601. String-typed values opt out.
    - Style-less ICU args (`{n, number}`, `{d, date}`, `{t, time}`) now format instead of rendering literally.
- README and demo updated to canonical locale casing (`en-US`, `es-ES`, `fr-FR`, `de-DE`).

---

## 3.0.0 - 2026-05-19

### BREAKING CHANGES

- **The `$_['Category']['Phrase']` proxy is removed**, replaced by `$t(category, phrase, params?)`. The phrase remains both the lookup key and the base-language default, but the function-call form unlocks interpolation, future ICU plural/select support, and compile-time-checked parameters via template-literal types.
    - **Migration:** `$_['UI']['Title']` → `$t('UI', 'Title')`. Two-arg, 1:1 with the previous category/phrase. Codemod-friendly.
    - **Staying on the proxy?** Consumers who want to keep the `$_['Cat']['Token']` syntax must pin to `2.x` or install via the `v-last-proxy-compat` dist-tag (`npm install langsys-js-svelte@v-last-proxy-compat`). 2.x will receive only critical security fixes going forward.
- **`langsys-js-svelte` is now a thin Svelte binding over the framework-agnostic [`langsys-js-typescript`](https://github.com/langsys/langsys-js-typescript) package.** All of the previous internals (Translations class, LangsysAppAPI, stores, utility code, type definitions) live there now. This package contains only Svelte-native concerns: a `LangsysApp` wrapper that accepts a `Writable<string>` for the user locale, the `t` / `currentlyLoadedLocale` / `sTranslations` / `contentBlocks` re-exports typed as Svelte `Readable`s, and the `<Translate>` Svelte 5 component.
- **Legacy parameter-based `LangsysApp.init(projectid, key, store, …)` is removed.** The config-object form (deprecated in 2.0.0) is now the only signature. Callers still on the old form must migrate to `LangsysApp.init({ projectid, key, UserLocaleStore, … })`.

### Added

- `$t(category, phrase, params?)` function-call translation API.
- `{name}`-style placeholder interpolation. Allowed value types: `string | number | Date | boolean`; `Date` serializes to ISO 8601.
- **Compile-time-checked params** via template-literal types. Placeholder names are extracted from the phrase string literal; the params object must satisfy them exactly. Missing or extra keys are TypeScript errors at the call site.
- `t: Readable<TFunction>` — Svelte store wrapping the underlying reactive primitive. `$t(...)` re-renders subscribed templates whenever translations or the loaded locale change.
- Re-exports of `currentlyLoadedLocale`, `sTranslations`, `contentBlocks` typed as Svelte `Readable`s.
- Type re-exports: `TFunction`, `TranslationParams`, `ParamPrimitive`, `ExtractParamKeys`, `ParamsFor`, `TArgs`, plus all the previous `iCategory`/`iCountry`/`iLocale`/etc types now sourced from `langsys-js-typescript`.

### Changed

- `LangsysApp.init` accepts a Svelte `Writable<string>` for `UserLocaleStore` and adapts it internally to the base SDK's `Signal<string>`. From the caller's perspective the contract is unchanged.
- All previously stale `@typescript-eslint/*: off` rule overrides removed — the new wrapper code is precise enough not to need them.
- `prettier` invocations updated to drop deprecated `--plugin-search-dir .` flags.

### Removed

- Old proxy-based `_` export and the entire `TranslationsAccessor` machinery.
- Legacy parameter-based `LangsysApp.init` signature (deprecated in 2.0).
- `src/lib/interface/`, `src/lib/js/`, `src/lib/service/`, `src/lib/store/` — all functionality now lives in `langsys-js-typescript`.
- `@macfja/svelte-persistent-store` and `@ungap/structured-clone` dependencies (no longer needed; persistence and cloning handled by `langsys-js-typescript`).
- `watch` devDep + accompanying `npm run watch` script. `svelte-package` has built-in watch mode.

### Added (deps)

- `langsys-js-typescript` — the framework-agnostic base SDK this package binds to.

---

## 2.0.0 - 2026-05-17

### BREAKING CHANGES

- **Svelte 5 required.** `peerDependencies.svelte` narrowed from `^3.3.0 || ^4.0.1 || ^5.0.0` to `^5.0.0`. Svelte 3 / 4 consumers must stay on `1.2.1` or use the `v-last-svelte4-compat` tag.
- **`idb-keyval` removed** as a direct dependency. The storage layer now uses a progressive fallback (IndexedDB → localStorage → in-memory) via `@macfja/svelte-persistent-store`. Code reaching into the previous IDB-backed store will need to migrate.
- **`Translate` component rewritten in Svelte 5 syntax.** Not consumable from Svelte 3 / 4 runtimes.
- **`updateTokens` now posts to `projects/:projectid/tokens`** (v2 API path). Requires a Langsys backend that serves the v2 token endpoint.
- **Legacy parameter-based `LangsysApp.init(projectid, key, store, …)` is deprecated** and logs a `console.warn` on use. It still works in 2.x but will be removed in 3.0. Migrate to the config-object form: `LangsysApp.init({ projectid, key, UserLocaleStore, … })`.

### Added

- `LangsysApp.detectPreferredLocale()` — works in both browser (`navigator.languages`) and SSR (`Accept-Language` header), with optional supported-locale matching (exact → language-only → null).
- `ssrTokenStrategy` config option (`'client' | 'server' | 'auto'`, default `'client'`) controlling when missing tokens are flushed during SSR.
- Microtask-batched server flushes and hydration-aware replay of SSR-collected tokens.
- `change(locale, force, skipFetch)` — `skipFetch` lets callers skip the network fetch when SSR-prefetched data is already present.
- SSR-compatible content-block resolution in `Translate.svelte`.
- New exports: `iLangsysInitConfig`, `iCurrency`, `iCurrencyList`, `iCategories`, `iTranslations`.
- New interface files: `currencies.ts`; expanded `countries.ts` and `config.ts`.
- API key permission detection: read-only keys automatically skip missing-token collection and content-block creation.
- `README-SSR.md` documenting SSR usage.
- Test suite: `ssr-init.test.ts` (6 cases).

### Changed

- `updateTokens` now de-duplicates against the current store state before sending.
- `debug` flag is now applied early in initialization so init-time logs are captured.
- Translation Proxy no longer `structuredClone`s the whole `$trans` store on every `$_['Cat']['Token']` read (significant hot-path perf win).
- Proxy introspection switched from brittle string-matching to `typeof prop === 'symbol' || prop === 'constructor'`, with `Reflect.get` on real category proxies (fixes `obj.constructor` and similar engine paths).
- Full dev-dep refresh: vite 5→8, vitest 2→4, typescript 5→6, eslint 9→10, eslint-plugin-svelte 2→3, `@sveltejs/vite-plugin-svelte` 4→7, `@sveltejs/adapter-auto` 3→7, publint 0.2→0.3, plus minor bumps. Only shipped dep change: `@ungap/structured-clone` 1.2 → 1.3.

### Fixed

- Infinite loop under Svelte 5.
- Timer handling in SSR environments.
- TypeScript type errors across multiple files; proper annotations on utility functions and `__uncategorized__` assignments.

### Removed

- `idb-keyval` dependency.
- `structuredCloneShim` helper (no remaining callers).
- Dead `__DirectToken__` prototype and other commented-out cruft (~25 lines).

---

## 1.2.1 - 2025-06-04

Last release supporting Svelte 3 / 4. See git history for prior changes.