Skip to content

Roadmap

A living list of what is planned for KatanaKit (katanakit-js). Contributions are welcome — pick something and open a pull request.

Legend: [x] done · [ ] planned.

  • Hexagonal reorganization into types/, core/services/, infrastructure/, adapters/, config/.
  • Pure ESM: relative imports with explicit .js extensions, module: nodenext, "type": "module" and an exports map with subpaths (katanakit-js/adapters/express, katanakit-js/adapters/nuxt).
  • use* method convention across every service (only getInstance() is exempt).
  • Destructured, tree-shakeable exports from Singleton facades.
  • Single source of truth for contracts and domain types in src/types/.
  • No side effects on import; SSR-safe infrastructure adapters.
  • Removed TypeScript errors, import-time side effects and duplicate types.
  • Dependency restructure: only @js-temporal/polyfill as a runtime dependency; express, cors, dotenv and vue as optional peer dependencies.
  • Package renamed for publication as katanakit-js (previously developed as katanakit-dev).
  • Core services: HTTP client, logger, formatter, converter, errors, generator, dates (Temporal), geometry, timing, data/system utilities and the reactive signals kernel.
  • Infrastructure adapters: DOM, storage, viewport, sensors, observer (+ lazy loader), worker (+ pools) and theme.
  • Astro adapter (AstroService) for getStaticPaths.
  • RSS service (RssService) with raw XML generation and Astro GET endpoints — no external dependencies.
  • Site config (SiteConfig/siteConfig) and SEO module (useHeadTags, useGenerateMetaTags, useTitle, useRssHeadLink).
  • Nuxt adapter (katanakit-js/adapters/nuxt): useUnwrap, useSafeResponse, useEventResponse.
  • Vue adapter (katanakit-js/adapters/vue): useRequest composable (data, error, loading, refetch).
  • Express reference server (katanakit-js/adapters/express) with CORS restriction defaults and hardened headers.
  • Worker pool concurrency fixed by correlating tasks with a taskId echo.
  • PhotoSwipe adapter (katanakit-js/adapters/photoswipe): DOM-selector lightbox binding, programmatic open, Safe Results, SSR guard.
  • Better Auth adapter (katanakit-js/adapters/better-auth): client factory for five frameworks plus Safe Result session/handler/locals helpers.
  • useEncrypt generates a random salt when none is provided.
  • Vitest suite (36+ files, 270+ tests) with the @/ alias; jsdom coverage for the UI kit foundations.
  • ESLint gate (check = eslint + tsc6 typecheck + vitest; fix auto-fixes).
  • Local releases: useGit push --release writes the complete CHANGELOG section and syncs version refs before tagging, and bun run release publishes to npm (GitHub Actions was removed).
  • English documentation: README, Getting Started, Architecture, API Reference, Roadmap, CONTRIBUTING, SECURITY, CHANGELOG.
  • Security fixes applied: URL scheme validation, DOM on* attribute block, JSON-LD </script> escaping, worker cleanup, generic server errors.
  • Verification gate (check, build, examples:check) run locally and by the release flow; docs deploy to Cloudflare with bun run deploy.
  • QueryClient (TanStack Query Core): cache with GC, stale-while-revalidate, retry with backoff, deduplication, invalidation and prefetch.
  • HTTP client: request interceptors and per-request cancellation plumbing in FetchApiManager (the query layer already forwards AbortSignal).
  • Reactive: automatic dependency tracking for useCreateEffect/useCreateMemo (today signals are listed explicitly).
  • Structured/JSON logger strategy.
  • Add Vitest coverage reporting to the release gate.
  • UI kit (Katana UI): foundations shipped (button, input, card, badge, alert); shells, blocks, layouts and app pages remain. See the UI Kit roadmap.
  • Deno / Cloudflare Workers compatibility pass.
  • More geometry (3D solids) and unit-system conversions.
  • E2E tests for the Express adapter.
  • AbortController support in useInterval/timeout helpers.