Skip to content

Releases

v0.2.0-beta.7

Choose a tag to compare

@yartema yartema released this 18 Nov 21:25

Added

  • Каталог навигации из дерева маршрутов. Поле route.navigation (opt-in) помечает маршрут пунктом меню; getNavigation() возвращает плоский каталог (id, href, parentId, dynamic, slug + прикладные ключи), buildNavigation(routes) — то же без состояния (тесты, sitemap.xml). href для статического маршрута берётся из пути, явный navigation.href побеждает, динамический маршрут без явного href отдаётся с dynamic: true без ссылки. Ключи (title, icon, order, права) — приложение через module augmentation TustenRouteNavigation; значения проверяются на JSON-safety в buildRouteTree. Каталог статичен, засеивается в globalThis в client-entry и create-server, в __ROOT_STATE_STR__ не попадает. getNavigation() импортируется из client-safe @tusten/core, поэтому работает и на клиенте, и в кастомном JSON-RPC-обработчике: сервер может вернуть каталог (при необходимости отфильтрованный по правам/ctx) клиенту обычным Service.call.
  • Сжатие HTTP-ответов включено по умолчанию (brotli + gzip). @fastify/compress сжимает POST /service, API-роуты и статику; SSR-документ и готовые HTML-тела (SPA-shell, 404, страницы ошибок) сжимаются встроенным zlib-пайплайном, потому что SSR пишет в reply.raw в обход хуков Fastify. Кодировка выбирается по Accept-Encoding, Vary: Accept-Encoding мёржится с i18n-значением. Новый конфиг server.compress?: false | { threshold?, encodings?, ssr? }; false полностью выключает сжатие (когда сжимает прокси/CDN), ssr: false — только стримируемый HTML.
  • publicDir — каталог статики рядом с client/ и server/ (по умолчанию public, false — отключить). Vite обслуживает его в dev и копирует в dist/client на сборке; prod-сервер дополнительно читает исходный каталог через @fastify/static (артефакты сборки имеют приоритет). Хэшированные чанки/ассеты (включая entry) получают Cache-Control: public, max-age=31536000, immutable, файлы из public/ — no-cache.
  • Хэшированные имена ассетов и immutable. Entry-чанк клиента, чанки и CSS получают хэш в имени (assets/client-entry-<hash>.js, assets/<name>-<hash>.js, assets/<name>-<hash>.css) и отдаются с Cache-Control: public, max-age=31536000, immutable. URL entry для <script type="module"> берётся из Vite manifest (findClientEntryFile), поэтому деплой не требует правок в шаблоне; файлы из public/ по-прежнему no-cache.
  • Предсжатие статики (Brotli + Gzip). buildClient после записи бандла создаёт рядом с текстовыми файлами (js, css, html, json, svg, xml, txt, map — крупнее 1 КБ) .br (brotli quality 11) и .gz (gzip level 9). Prod-сервер включает @fastify/static.preCompressed: true: отдача по Accept-Encoding без CPU на каждый запрос, с автоматическим Vary: Accept-Encoding и откатом на несжатый файл. Утилита — precompressAssets(dir, options) в build/precompress.ts.
  • startTransition при SPA-переходе и публичный pending. Новое дерево рендерится в transition: старая страница остаётся на месте, пока грузятся данные и чанки. useNavigation() получил pending, добавлены useNavigationPending(), isNavigationPending(), subscribeNavigationPending(), setNavigationPending() и готовая полоска <NavigationProgress /> (рендерится в root controller, при SSR невидима, клики не перехватывает).
  • create-tusten-app — скаффолдер новых приложений (npm create tusten-app@latest my-app). Один шаблон basic, вопросы про Tailwind / ESLint / Prettier, выбор пакетного менеджера (pnpm по умолчанию), установка зависимостей и git init по желанию. Версии @tusten/core и его peer-зависимостей берутся из packages/tusten/package.json при сборке скаффолдера. В шаблоне JSON-RPC включён по умолчанию: объект App (server/app/App.meta.ts), клиентский вызов через Service (client/Page/Factories/appInfo.ts) и SSR-prefetch данных, плюс public/ и сжатие ответов. Публикация пока не выполнялась.
  • Алиасы из tsconfig.json работают и на сервере. Загрузчики на jiti (tusten.config.ts, router.ts, *.loader.ts, server routes/plugins/middleware, RPC-объекты, configLoader маршрутов) читают compilerOptions.paths через createProjectJiti, поэтому @/… и @server/… резолвятся одинаково в редакторе, tsc, Vite и Node. В Vite пути включаются опцией vite.resolve.tsconfigPaths; скаффолдер создаёт paths для client/ и server/.

Breaking

  • SliceRegistry.adoptPage() / adoptGlobal() больше не уничтожают вытесненные слайсы сразу. Они возвращают идемпотентную release()-функцию: client-entry вызывает её после commit нового дерева (startTransition), иначе старая страница осталась бы смонтированной с уничтоженными слайсами. Прямые вызовы, которые игнорировали возвращаемое значение, должны вызывать release() самостоятельно — иначе слайсы утекут до dispose*.
  • @tusten/core/client больше не реэкспортирует core API. Убран export * from '..': клиентский entry содержит только React API и клиентский рантайм (RootProvider, хуки, Link, Outlet, Remote, RootErrorBoundary/RootLoading/RootNotFound, i18n, devalueParse/devalueStringify). defineConfig, defineRoute, defineGlobalLoader, Slice, AbstractSlice, SliceRegistry, Service, TustenError, RpcError, runGlobalPrefetch/runPagePrefetch/runPrefetch, computePath, resolveMeta, toClientRoute/pickClientRoute/collectParentIds и общие типы импортируются из @tusten/core.
  • Из @tusten/core/server убраны дубли core-экспортов. TustenError, RpcError, runPrefetch, runGlobalPrefetch, runPagePrefetch и типы prefetch остаются только в @tusten/core; server/prefetch.ts удалён. Серверный entry — только Node-only API.
  • RPC-типы — только в @tusten/core/server. RpcContext, RpcOptions, ResolvedRpcOptions, RpcObjectDefinition, RpcMethodDefinition, RpcParamsSchema, AuthRequirement, RpcExecutor, StandardSchemaV1 больше не экспортируются из @tusten/core.
  • registerServerPlugins(fastify, plugins, projectDir) — третий аргумент обязателен: без корня проекта jiti не находит tsconfig.json и не применяет paths.

Changed

  • Пользовательская документация по данным. docs/Factories.md — фабрики, аргументы, зависимости, Service, SSR/SPA-пайплайн; docs/Slices.md — слайсы, setState, хуки, жизненный цикл, сериализация и SliceRegistry. Ссылки добавлены в README.md и docs/Router.md.
  • Пользовательская документация по конфигурации. docs/Config.md — defineConfig, все секции tusten.config.ts, значения по умолчанию, пути, рецепты и ограничения. Ссылка добавлена в раздел «Конфиг» корневого README.md.
  • dist/server больше не содержит копию public/. SSR-сборка запускается с publicDir: false: статика копируется один раз в dist/client, а SSR-бандл не раздувается.
  • defineRoute: обязательны только id и contentConfig.workspaceConfig.template. prefetchConfig стал опциональным: без него у страницы нет page-слайсов, configLoader не грузится ни на сервере, ни на клиенте, а в __ROOT_STATE_STR__ едут только глобальные слайсы. Глобальные слайсы и *.loader.ts тоже необязательны: проект с одной страницей без единого загрузчика собирается и рендерится, globalRegistry пустой. Затронуты runPagePrefetch, манифест, Vite-плагин и сбор фабрик.

Fixed

  • Конфиг без export default больше не игнорируется молча. jiti с interopDefault на модуле без экспортов возвращает { default: {} }, и loadConfig принимал пустой объект за валидный конфиг: сервер стартовал на дефолтах, пропадали client.css, client.root, i18n и Vite-плагины (например, Tailwind не подключался). Теперь — TustenError: Config at … must export a default object.
  • Source maps теперь попадают в npm-пакет. dist/**/*.map исключались из files, хотя сборка (tsup с sourcemap: true) оставляет в JS комментарии //# sourceMappingURL=…. Vite у потребителя пытался прочитать отсутствующий файл и писал при каждом старте Failed to load source map … ENOENT. Карты self-contained (sourcesContent), поэтому стеки SSR снова маппятся в исходные .ts/.tsx.

v0.2.0-beta.6

Choose a tag to compare

@yartema yartema released this 17 Nov 21:20

Breaking

  • Дефолтное имя cookie с выбранным языком — lang (было tusten_locale). Старые cookie больше не читаются: пользователь один раз получит язык из Accept-Language / defaultLocale. Вернуть прежнее имя — defineConfig({ i18n: { key: 'tusten_locale', defaultLocale, locales } }).
  • client.layouts и route.type удалены. Layout теперь задаётся в defineRoute через route.layout: 'Page/Layout:Main', массив для вложенности или false/[] для отказа. Если в конфиге есть client.layouts, загрузчик выведет warning и проигнорирует его. Если в маршруте остался type, buildRouteTree тоже выведет warning.
  • client.rootElement удалён и заменён на client.root.container. client.root теперь объект { component?, container? }; короткая строка root: 'Page/Controller:Root' поддерживается только для component.

Added

  • slice.state — прямое чтение состояния слайса как свойства (slice.state). getState() оставлен @deprecated-алиасом и больше не используется внутри фреймворка, в примерах и документации.
  • Root controller (client.root.component) — компонент-оболочка всего приложения, которая рендерится всегда: SSR, гидрация, SPA-loading, ошибка и 404. Получает children, route, router, status (ready / loading / error / not-found) и error. Внутри доступны useSlice/useRouter/useRoute, а React-контекст корня видят все layouts и страницы. Не задан — поведение как раньше, без обёртки.
  • useRoute() — публичный конфиг текущего маршрута в root controller, layouts и страницах. Новый тип TustenClientRoute — JSON-safe проекция TustenRoute; на сервере и клиенте используется одна функция проекции, поэтому нет hydration mismatch.
  • route.layout — layout как часть маршрута: строка (полная цепочка), массив (явная вложенность root → leaf), undefined (наследовать от parentId), false/[] (без layout'ов). Строка/массив заменяют унаследованную цепочку, дубликаты подряд удаляются. Layout всегда опционален.
  • client.root.container — настройка контейнера приложения: tag (по умолчанию div), id (по умолчанию root, false — без id) и attributes (class, data-*, aria-*, style, ...). Клиент находит контейнер по служебному data-tusten-root, поэтому смена id/тега не ломает гидрацию. Событийные атрибуты (on*) запрещены — это статичный HTML.
  • i18n.key — имя cookie с выбранным языком. Действует и на сервере (resolveRequestLocale), и на клиенте (setLocale); ключ уезжает в window.__ROOT_I18N__ (cookieKey), поэтому SSR и гидрация используют одно и то же имя. Дефолт — LOCALE_COOKIE (lang). Имя валидируется при загрузке конфига (RFC 6265 token, обрезается по краям): пустая строка, пробелы и разделители — TustenError.
  • <html lang> — SSR, SPA и 404 отдают атрибут lang с locale запроса (нужен скринридерам, SEO, спеллчекеру и CSS :lang()). При выключенном i18n атрибут не рендерится.
  • RootErrorBoundary получил resetKey: при SPA-навигации пойманная ошибка больше не «залипает» после перехода на другую страницу.
  • Тесты на кастомный ключ cookie: config, negotiate, boot, locale, runtime, ssr-head. Всего 497 тестов (32 файла).
  • Dev-оверлей ошибок в браузере. Падение SSR отдаёт отдельную страницу с описанием, стеком и code frame вокруг строки; стек маппится по sourcemap через vite.ssrFixStacktrace (в кадрах исходные .tsx), кадры кликабельны и открывают файл в редакторе (/__open-in-editor).
  • Ошибки SSR после отправки shell (стриминг) уезжают в HTML как window.__TUSTEN_SSR_ERRORS__; клиент показывает их оверлеем поверх частичной страницы, потому что статус ответа уже отправлен.
  • Клиентский оверлей (@tusten/core/client/dev-overlay, shadow DOM): описание, стек, копирование, переход в редактор, закрытие по Esc. Ловит гидрацию (onRecoverableError), SPA-навигацию, initial prefetch, window.error / unhandledrejection и ошибки, пойманные RootErrorBoundary. Одинаковые ошибки дедуплицируются; при сбое динамического импорта оверлей подсказывает проверить, запущен ли dev-сервер.
  • Prod-страница 500 с коротким Код ошибки и без стека/путей; код пишется в лог ([tusten] <label> [id]: …) и связывает ответ пользователя с записью.
  • Новая точка входа пакета @tusten/core/client/dev-overlay (tsup entry + exports); в prod-бандл не попадает — entry импортирует её динамически внутри if (import.meta.env.DEV).
  • useNavigation() — единый хук навигации: pathname, params, query, route и методы push / replace / back / prefetch / reload. Заменяет связку useRouter() + usePathname() + useParams() + useQuery().
  • router.reload(options?) — перезапуск лоадеров текущего маршрута без смены URL и history. По умолчанию обновляет глобальные и page-слайсы, сбрасывает клиентский кэш Service и сохраняет локальный state компонентов. Опции: global (по умолчанию true), cache (false — сбросить кэш), remount (перемонтировать страницу), middleware (прогнать клиентскую цепочку). Ошибка не заменяет страницу на components.error; при гонке с навигацией побеждает последняя операция. До инициализации client-entry — полная перезагрузка.
  • SliceRegistry.adoptGlobal(source) — атомарная подмена global-слайсов (используется router.reload, чтобы при ошибке не оставить частично обновлённые глобальные состояния).

Deprecated

  • useRouter(), usePathname(), useParams(), useQuery() — используйте useNavigation(). Старые хуки остаются тонкими обёртками.

Fixed

  • После router.reload() переставали обновляться слайсы. adoptPage / adoptGlobal заменяют инстансы без notifyKey, а useSlice оставался подписан на уничтоженный слайс: setState нового инстанса не вызывал re-render. Теперь subscribe для useSyncExternalStore зависит от текущего инстанса и переподписывается после подмены.
  • SSR игнорировал cookie с locale. В readLocaleCookie условие pair.slice(0, idx).trim() !== key || LOCALE_COOKIE было всегда истинным, поэтому выбор пользователя (setLocale) не учитывался — locale всегда бралась из Accept-Language / defaultLocale.
  • SPA-навигация при ошибке больше не молчит. Если clientPrefetch или загрузка чанка маршрута падают, рендерится components.error (в dev плюс оверлей), а не остаётся старая страница без объяснения.
  • Back в SPA терял query-параметры. Обработчик popstate передавал только window.location.pathname, поэтому back с /about?tab=router вёл на /about, а replaceState затирал предыдущие записи истории. Теперь учитывается pathname + search, и back возвращает на предыдущую вкладку/страницу.
  • Фатальный сбой клиента в SPA (без SSR) показывает текст «Не удалось загрузить страницу. Обновите её» вместо пустого экрана; SSR-разметка при этом не затирается.
  • В dev- и prod-ответах 500 используется один и тот же путь fail(): раньше dev отдавал <pre> с одним message, без стека и без code frame.

Changed

  • Пути в client.* задаются относительно clientDir без ./: Page/Controller:Root, layouts/Main. Старый вид с ./ поддерживается — нормализуется при загрузке конфига.
  • window.__ROOT_I18N__ содержит cookieKey; I18nBootstrap.cookieKey применяется в initI18n через setLocaleCookieKey.
  • CHANGELOG переехал в packages/tusten/CHANGELOG.md и отслеживается git; prepack больше не копирует его из корня.
  • README: цепочка определения locale и пример конфига описывают i18n.key и дефолт lang.

v0.2.0-beta.5

Choose a tag to compare

@yartema yartema released this 13 Nov 22:17

Breaking

  • Формат tusten.config.ts приведён к структуре ResolvedTustenConfig:
    export default defineConfig({
        ssr: true,
        client: {
            clientDir: 'client',
            layouts: { main: './layouts/Main.tsx' },
            css: ['styles/main.css'],
            components: { error, loading, notFound },
        },
        server: { serverDir: 'server', port, host, routes, plugins, rpc },
        middleware,
        vite,
        build,
        runtimeConfig,
        fastify,
    })
    • clientDir, layouts, css, components переехали в client;
    • serverDir и rpc переехали в server;
    • css теперь массив путей (было { main: string }) — в dev каждый файл даёт свой <link>.
  • Slice.dispose() → Slice.destroy(). dispose() оставлен как @deprecated-алиас, но теперь тоже очищает state. Уничтоженный слайс: setState — no-op (+ console.warn вне production), subscribe — пустая отписка.
  • SerializedState.slices[*].config — новый элемент __ROOT_STATE_STR__ (в типе optional для чтения старых снимков).

Added

  • AbstractSlice.destroy() / isDestroyed(); уничтожение освобождает подписчиков и state.
  • _initState(result, config) / hydrate(result, config): вторым аргументом приходит dataFactoryArguments фабрики. Config сериализуется в __ROOT_STATE_STR__, поэтому SSR-гидратация на клиенте получает те же значения, что и сервер.
  • SliceRegistry.adoptPage(source) — атомарная подмена page-слайсов при SPA-навигации; setPage / setGlobal уничтожают заменяемый инстанс.
  • setState для plain-объектов делает поверхностный мерж (было — полная замена): setState({ total: 0 }) сохраняет остальные ключи. Для массивов, Map/Date и экземпляров классов — замена. Новый публичный тип SlicePatch<TState>.
  • SSR: заголовки Cache-Control: no-store и Vary: Accept (404), кэш loadModule в prod, статические фрагменты документа вынесены из per-request пути.
  • utils/fs: resolveRealPath() и toVitePath() — канонический регистр путей для Vite/HMR.
  • getRouter() — навигатор без React-контекста для обработчиков, сервисов и таймеров. Тот же API, что у useRouter().
  • i18n клиентских модулей. Импорт import rk from 'i18n!<Module>' (единственный синтаксис). Словари — client/<Module>/lang/<locale>/<locale>.json; конфиг — defineConfig({ i18n: { defaultLocale, locales } }).
    • rk(key, ctx?) — ключ = текст на исходном языке, поиск ctx@@key → key; нет перевода → ключ, без ошибок. Битый JSON и нестроковые значения — ошибка сборки.
    • template(str, params, locale?) — {name} и {n, plural, one {…} few {…} many {…} other {…}} (подмножество ICU, other обязателен).
    • Locale: cookie tusten_locale → Accept-Language (с q) → defaultLocale. SSR-рендер и словари встраиваются в HTML; гидрация без mismatch. Параллельные запросы изолированы через AsyncLocalStorage.
    • setLocale(l) (@tusten/core/client) — cookie и перезагрузка страницы. Реактивного переключения нет.
    • Типы: declare module 'i18n!*' подключается через @tusten/core/client.
    • Тесты: i18nTestPlugin() из @tusten/core/server — в Vitest i18n!X превращается в заглушку, rk(key) возвращает key.
    • tusten inspect печатает i18n-модули: число ключей по locale, отсутствующие словари, ошибки JSON.

Fixed

  • HMR на Windows/macOS: правка компонента не подхватывалась без перезапуска dev, если регистр в спеке не совпадал с файлом ('HomePage/view' ↔ View.tsx). Причина — Vite регистрировал модуль под view.tsx, а watcher присылал View.tsx. Пути канонизируются через realpathSync.native в module-loader, vite/plugin и serialize.
  • serialize: modulePath ломался, когда projectDir был коротким путём (C:\Users\AV-BAR~1\...), а realpath — длинным (../../../../../...).
  • SSR: исключение после reply.hijack() (парсинг URL, 404-рендер, middleware) оставляло запрос висеть до таймаута — добавлен внешний try/catch и guard на повторный end(). В production клиенту больше не уходит текст внутренней ошибки.
  • queryToObject падал с URIError на битом percent-encoding (?a=%) — заменён на URLSearchParams.
  • SPA-переход: при ошибке loadData новая страница больше не оставляет пользователя с уже уничтоженными слайсами — prefetch идёт в отдельный реестр, подмена только после успеха.
  • независимые фабрики грузятся параллельно, и для runPagePrefetch, и для runGlobalPrefetch. Каждая ждёт только свои зависимости. Порядок записи в slices и registry остался прежним (топологический)
  • чанки шаблона и layout, Error и классы слайсов грузятся параллельно. Loading в SSR больше не качается. Добавил защиту от устаревшей навигации, onRecoverableError для hydration mismatch и прогрев чанка шаблона при prefetch. resolveMeta больше не блокирует SPA-переход, и document.title перестал затираться (раньше route.title перетирал заголовок из meta).
  • CSS берётся по всей цепочке layout и из imports. В <head> добавлен modulepreload для client.js, чанков маршрута и слайсов. Слои и шаблон грузятся параллельно, ErrorComponent стартует до prefetch.

Changed

  • examples/basic переведён на новую структуру конфига; UserListState.limit демонстрирует второй аргумент _initState.
  • Документация: packages/tusten/README.md — генерируемая копия корневого (prepack), правило зафиксировано в AGENTS.md; файл добавлен в .gitignore.
  • useRouter() — тонкая обёртка над getRouter(). Вызов вне <RootProvider> больше не бросает TustenError.

v0.2.0-beta.4

Choose a tag to compare

@yartema yartema released this 11 Nov 21:33
  • MetaResult: optional 'title' field
  • resolveMeta: title priority = fromMethod > metaConfig.title > 'Страница'
  • Service: LRU cache (cacheMaxEntries, default 500)
  • Service: cacheSize() for tests
  • Service/RpcError exported as-is (no Tusten prefix)
  • Published: @tusten/core@0.2.0-beta.4"

v0.2.0-beta.1

Choose a tag to compare

@yartema yartema released this 11 Nov 19:23
  • Scoped package @tusten/core
  • Bin 'tusten', imports '@tusten/core'
  • RootProvider / TustenError / RpcError / defineConfig / createServer
  • 264 tests, CI green
  • Published: beta + latest tags on 0.2.0-beta.1"

v0.2.0-alpha.3

Choose a tag to compare

@yartema yartema released this 11 Nov 10:27
refactor!: rename nixo -> setti