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.
Shipped (as of 7.1.6)
Section titled “Shipped (as of 7.1.6)”Architecture and packaging
Section titled “Architecture and packaging”- Hexagonal reorganization into
types/,core/services/,infrastructure/,adapters/,config/. - Pure ESM: relative imports with explicit
.jsextensions,module: nodenext,"type": "module"and anexportsmap with subpaths (katanakit-js/adapters/express,katanakit-js/adapters/nuxt). -
use*method convention across every service (onlygetInstance()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/polyfillas a runtime dependency;express,cors,dotenvandvueas optional peer dependencies. - Package renamed for publication as
katanakit-js(previously developed askatanakit-dev).
Services and adapters
Section titled “Services and adapters”- 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) forgetStaticPaths. - RSS service (
RssService) with raw XML generation and AstroGETendpoints — 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):useRequestcomposable (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
taskIdecho. - 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. -
useEncryptgenerates a random salt when none is provided.
Quality and tooling
Section titled “Quality and tooling”- Vitest suite (36+ files, 270+ tests) with the
@/alias; jsdom coverage for the UI kit foundations. - ESLint gate (
check= eslint +tsc6typecheck + vitest;fixauto-fixes). - Local releases:
useGit push --releasewrites the complete CHANGELOG section and syncs version refs before tagging, andbun run releasepublishes 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 withbun 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 forwardsAbortSignal). - 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.