davaux 0.8.0 → 0.8.1

package/CLAUDE.md

@@ -1,518 +0,0 @@
-<!-- pka-generated -->
-# davaux
-
-> Generated by Project Knowledge Analyzer on 2026-06-06T21:53:10.219Z
-
-## Overview
-
-SSR-first JSX framework with file-based routing and signals
-
-**Version**: 0.8.0
-**Author**: David L Dyess II
-**License**: MIT
-**Repository**: https://codeberg.org/davaux/davaux#readme
-
-## Tech Stack
-
-- **Language**: TypeScript
-- **Module System**: ESM (`type: module`)
-- **Build Tool**: esbuild
-
-## Commands
-
-- `davaux` (binary) — `./dist/cli.js`
-- `npm run build` — node build.mjs
-- `npm run build:types` — tsc --emitDeclarationOnly
-- `npm run typecheck` — tsc --noEmit
-- `npm run dev:framework` — node --watch dist/cli.js
-- `npm run test` — node --import tsx/esm --test 'src/test/**/*.test.ts'
-
-## Project Structure
-
-```
-├── CLAUDE.md
-├── README.md
-├── ROADMAP.md
-├── package.json
-├── pka.config.json
-├── tsconfig.client.json
-├── tsconfig.json
-├── client/
-│   ├── control.ts
-│   ├── hydrate.ts
-│   ├── index.ts
-│   ├── jsx-runtime.ts
-│   ├── resource.ts
-│   ├── signal.ts
-│   ├── store.ts
-│   └── useHead.ts
-├── BASELINE.md
-└── src/
-    ├── cli.ts
-    ├── config.ts
-    ├── create-multisite.ts
-    ├── create.ts
-    ├── env.d.ts
-    ├── errors.ts
-    ├── generate.ts
-    ├── index.ts
-    ├── island.ts
-    ├── jsx-runtime.d.ts
-    ├── jsx-runtime.ts
-    ├── link.ts
-    ├── signal.ts
-    ├── ssg.ts
-    ├── dev/
-    │   ├── blueprints.ts
-    │   ├── components.ts
-    │   ├── insert.ts
-    │   ├── remove.ts
-    │   └── watch.ts
-    ├── types.ts
-    ├── oml/
-    │   ├── fragment.ts
-    │   ├── index.ts
-    │   ├── jsx-runtime.ts
-    │   ├── jsx.ts
-    │   ├── page.ts
-    │   ├── render.ts
-    │   └── types.ts
-    ├── router/
-    │   ├── handler.ts
-    │   ├── matcher.ts
-    │   └── scanner.ts
-    ├── server/
-    │   └── index.ts
-    └── test/
-        ├── actions.test.ts
-        ├── body-limits.test.ts
-        ├── errors.test.ts
-        ├── helpers.ts
-        ├── layouts.test.ts
-        ├── middleware.test.ts
-        ├── multipart.test.ts
-        ├── oml-routing.test.ts
-        ├── oml.test.ts
-        ├── redirects.test.ts
-        ├── routing.test.ts
-        ├── ssg.test.ts
-        ├── web-response.test.ts
-        └── fixtures/
-            └── routes/
-                ├── [id].page.ts
-                ├── _error.ts
-                ├── _global.ts
-                ├── _layout-template.ts
-                ├── _layout.ts
-                ├── _layout_scripts.ts
-                ├── _middleware.ts
-                ├── _redirect301_mw.ts
-                ├── _redirect_mw.ts
-                ├── about.page.ts
-                ├── action.page.ts
-                ├── index.page.ts
-                ├── oml.page.ts
-                ├── redirect.page.ts
-                ├── state.page.ts
-                ├── throw.page.ts
-                ├── api/
-                │   ├── form-all.post.ts
-                │   ├── form-limited.post.ts
-                │   ├── response-obj.get.ts
-                │   ├── upload.post.ts
-                │   ├── users.get.ts
-                │   └── xml.get.ts
-                ├── auth/
-                │   ├── _middleware.ts
-                │   └── protected.page.ts
-                ├── ssg/
-                │   ├── [slug].page.ts
-                │   └── server.page.ts
-                └── wiki/
-                    └── [...slug].page.ts
-
-```
-
-## Entry Points
-
-- `./dist/cli.js`
-- `src/index.ts`
-- `src/oml/index.ts`
-- `src/server/index.ts`
-
-## Files by Type
-
-### Documentation (4)
-- `CLAUDE.md`
-- `README.md`
-- `ROADMAP.md`
-- `BASELINE.md`
-
-### Config (4)
-- `package.json`
-- `pka.config.json`
-- `tsconfig.client.json`
-- `tsconfig.json`
-
-### Module (38)
-- `client/control.ts`
-- `client/hydrate.ts`
-- `client/index.ts`
-- `client/jsx-runtime.ts`
-- `client/resource.ts`
-- `client/signal.ts`
-- `client/store.ts`
-- `client/useHead.ts`
-- `src/cli.ts`
-- `src/config.ts`
-- `src/create-multisite.ts`
-- `src/create.ts`
-- `src/errors.ts`
-- `src/generate.ts`
-- `src/index.ts`
-- `src/island.ts`
-- `src/jsx-runtime.d.ts`
-- `src/jsx-runtime.ts`
-- `src/link.ts`
-- `src/signal.ts`
-- `src/ssg.ts`
-- `src/dev/blueprints.ts`
-- `src/types.ts`
-- `src/dev/components.ts`
-- `src/dev/insert.ts`
-- `src/dev/remove.ts`
-- `src/oml/fragment.ts`
-- `src/oml/index.ts`
-- `src/dev/watch.ts`
-- `src/oml/jsx-runtime.ts`
-- `src/oml/jsx.ts`
-- `src/oml/page.ts`
-- `src/oml/render.ts`
-- `src/oml/types.ts`
-- `src/router/handler.ts`
-- `src/router/matcher.ts`
-- `src/router/scanner.ts`
-- `src/server/index.ts`
-
-### Script (1)
-- `src/env.d.ts`
-
-
-## Git
-- **Branch**: main
-- **Last Commit**: chore: Add alpha status note to README
-- **Author**: David Dyess II
-- **Date**: 2026-06-06 15:52:27 -0600
-- **Remote**: https://codeberg.org/davaux/davaux.git
-
-### Recent Commits
-```
-f527031 chore: Add alpha status note to README
-90c819e chore: Add repo info to package.json files
-b200d9d feat(davaux)!: Add OmlCacheConfig - opt-in with includes option or opt-out with excludes option; Fix OML implementation to follow OML spec - use output instead of return
-3bce0c2 chore: Update and add READMEs to packages; update ROADMAP
-fc27c20 fix(davaux): Remove old dist folder on new builds; fix server port per DavauxConfig
-c760659 feat(davaux): Add minify CSS in production builds
-c899ab8 fix(davaux): Added method JS and JSX extenstion to scanner
-7d99f04 feat(davaux): Add support for declarative partial updates
-3b47f37 chore: Bump package versions to 0.8.0
-aa0460f chore: Add CHANGELOG.md
-```
-
-## Dependencies
-
-### Runtime
-esbuild
-
-### Development
-@types/node, tsx, typescript
-
-
-
-
-## ⚠️ Potentially Unused Files (14)
-
-_These JS/TS files are not imported by anything and are not recognized entry points._
-
-- `client/control.ts`
-- `client/hydrate.ts`
-- `client/index.ts`
-- `client/jsx-runtime.ts`
-- `client/resource.ts`
-- `client/store.ts`
-- `client/useHead.ts`
-- `src/cli.ts`
-- `src/env.d.ts`
-- `src/island.ts`
-- `src/jsx-runtime.d.ts`
-- `src/link.ts`
-- `src/oml/page.ts`
-- `src/signal.ts`
-
-## Tests (40)
-
-### Test Suites (12)
-- `src/test/actions.test.ts`
-- `src/test/body-limits.test.ts`
-- `src/test/errors.test.ts`
-- `src/test/layouts.test.ts`
-- `src/test/middleware.test.ts`
-- `src/test/multipart.test.ts`
-- `src/test/oml-routing.test.ts`
-- `src/test/oml.test.ts`
-- `src/test/redirects.test.ts`
-- `src/test/routing.test.ts`
-- `src/test/ssg.test.ts`
-- `src/test/web-response.test.ts`
-
-### Fixtures (27)
-- `src/test/fixtures/routes/[id].page.ts`
-- `src/test/fixtures/routes/_error.ts`
-- `src/test/fixtures/routes/_global.ts`
-- `src/test/fixtures/routes/_layout-template.ts`
-- `src/test/fixtures/routes/_layout.ts`
-- `src/test/fixtures/routes/_layout_scripts.ts`
-- `src/test/fixtures/routes/_middleware.ts`
-- `src/test/fixtures/routes/_redirect301_mw.ts`
-- `src/test/fixtures/routes/_redirect_mw.ts`
-- `src/test/fixtures/routes/about.page.ts`
-- `src/test/fixtures/routes/action.page.ts`
-- `src/test/fixtures/routes/api/form-all.post.ts`
-- `src/test/fixtures/routes/api/form-limited.post.ts`
-- `src/test/fixtures/routes/api/response-obj.get.ts`
-- `src/test/fixtures/routes/api/upload.post.ts`
-- `src/test/fixtures/routes/api/users.get.ts`
-- `src/test/fixtures/routes/api/xml.get.ts`
-- `src/test/fixtures/routes/auth/_middleware.ts`
-- `src/test/fixtures/routes/auth/protected.page.ts`
-- `src/test/fixtures/routes/index.page.ts`
-- `src/test/fixtures/routes/oml.page.ts`
-- `src/test/fixtures/routes/redirect.page.ts`
-- `src/test/fixtures/routes/ssg/[slug].page.ts`
-- `src/test/fixtures/routes/ssg/server.page.ts`
-- `src/test/fixtures/routes/state.page.ts`
-- `src/test/fixtures/routes/throw.page.ts`
-- `src/test/fixtures/routes/wiki/[...slug].page.ts`
-
-### Helpers (1)
-- `src/test/helpers.ts`
-
-
-
-## Import Graph
-
-**client/control.ts** imports:
-  - `client/signal.ts`
-
-**client/hydrate.ts** imports:
-  - `client/signal.ts`
-
-**client/jsx-runtime.ts** imports:
-  - `client/signal.ts`
-
-**client/resource.ts** imports:
-  - `client/signal.ts`
-
-**client/store.ts** imports:
-  - `client/signal.ts`
-
-**client/useHead.ts** imports:
-  - `client/signal.ts`
-
-**src/cli.ts** imports:
-  - `src/config.ts`
-  - `src/errors.ts`
-  - `src/create.ts`
-  - `src/create-multisite.ts`
-  - `src/generate.ts`
-  - `src/dev/watch.ts`
-  - `src/router/scanner.ts`
-  - `src/ssg.ts`
-  - `src/router/handler.ts`
-  - `src/server/index.ts`
-
-**src/config.ts** imports:
-  - `src/types.ts`
-
-**src/island.ts** imports:
-  - `src/jsx-runtime.ts`
-
-**src/jsx-runtime.ts** imports:
-  - `src/oml/render.ts`
-
-**src/link.ts** imports:
-  - `src/jsx-runtime.ts`
-  - `src/types.ts`
-
-**src/ssg.ts** imports:
-  - `src/errors.ts`
-  - `src/router/handler.ts`
-  - `src/types.ts`
-
-**src/dev/blueprints.ts** imports:
-  - `src/oml/render.ts`
-  - `src/oml/types.ts`
-
-**src/types.ts** imports:
-  - `src/oml/types.ts`
-
-**src/dev/components.ts** imports:
-  - `src/oml/types.ts`
-
-**src/oml/fragment.ts** imports:
-  - `src/oml/types.ts`
-
-**src/dev/watch.ts** imports:
-  - `src/config.ts`
-  - `src/errors.ts`
-  - `src/oml/types.ts`
-  - `src/router/handler.ts`
-  - `src/router/scanner.ts`
-  - `src/server/index.ts`
-  - `src/types.ts`
-  - `src/dev/blueprints.ts`
-  - `src/dev/components.ts`
-  - `src/dev/insert.ts`
-  - `src/dev/remove.ts`
-
-**src/oml/jsx-runtime.ts** imports:
-  - `src/oml/types.ts`
-  - `src/jsx-runtime.ts`
-
-**src/oml/jsx.ts** imports:
-  - `src/oml/types.ts`
-
-**src/oml/page.ts** imports:
-  - `src/types.ts`
-  - `src/oml/types.ts`
-
-**src/oml/render.ts** imports:
-  - `src/oml/types.ts`
-
-**src/router/handler.ts** imports:
-  - `src/config.ts`
-  - `src/oml/render.ts`
-  - `src/oml/types.ts`
-  - `src/types.ts`
-  - `src/router/matcher.ts`
-
-**src/router/scanner.ts** imports:
-  - `src/types.ts`
-
-**src/server/index.ts** imports:
-  - `src/router/handler.ts`
-
-## Exported Symbols
-
-**`client/control.ts`**
-`For`, `Show`, `ErrorBoundary`, `ForProps`, `ShowProps`, `ErrorBoundaryProps`
-
-**`client/hydrate.ts`**
-`hydrate`, `IslandManifest`
-
-**`client/index.ts`**
-`ErrorBoundary`, `For`, `Show`, `hydrate`, `createEventSource`, `createResource`, `batch`, `createEffect`, `createMemo`, `createRoot`, `createSignal`, `onCleanup`, `untrack`, `createStore`, `useHead`
-
-**`client/jsx-runtime.ts`**
-`jsx`, `jsxs`, `jsxDEV`, `Fragment`, `Props`, `ComponentType`, `Element`, `ReactiveChild`, `Child`, `ElementChildrenAttribute`, `IntrinsicAttributes`, `IntrinsicElements`
-
-**`client/resource.ts`**
-`createResource`, `createEventSource`, `Resource`, `ResourceOptions`, `ResourceReturn`
-
-**`client/signal.ts`**
-`createSignal`, `createEffect`, `createMemo`, `onCleanup`, `createRoot`, `untrack`, `batch`, `trackRead`, `notifySubs`, `Signal`, `ReadonlySignal`
-
-**`client/store.ts`**
-`createStore`, `Updater`, `SetStoreFn`
-
-**`client/useHead.ts`**
-`useHead`, `MetaDescriptor`, `UseHeadOptions`
-
-**`src/config.ts`**
-`myPlugin`, `collectEsbuildPlugins`, `collectScannerSuffixes`, `pathsToAlias`, `defineConfig`, `DavauxPlugin`, `EditorConfig`, `DavauxConfig`, `OmlCacheConfig`
-
-**`src/create-multisite.ts`**
-`scaffoldMultisite`, `sites`, `SiteConfig`, `default`
-
-**`src/create.ts`**
-`scaffold`
-
-**`src/errors.ts`**
-`formatBuildErrors`, `frameworkWarn`, `frameworkError`, `handleBuildError`
-
-**`src/generate.ts`**
-`generate`, `getStaticPaths`
-
-**`src/index.ts`**
-`island`, `createLink`, `blueprintToFile`, `clearAllFragments`, `defineFragment`, `defineOmlPage`, `parseOml`, `parseOmlBlueprint`, `renderToHtml`, `renderToJsx`, `batch`, `createEffect`, `createMemo`, `createSignal`, `untrack`, `CookieJar`, `defineAction`, `defineError`, `defineHandler`, `defineLayout`, `defineMiddleware`, `definePage`, `defineStaticPaths`, `PayloadTooLargeError`, `RedirectError`, `redirect`, `ValidationError`
-
-**`src/island.ts`**
-`island`, `IslandComponent`
-
-**`src/jsx-runtime.d.ts`**
-`Props`, `ComponentType`, `Element`, `ElementChildrenAttribute`, `IntrinsicAttributes`, `IntrinsicElements`
-
-**`src/jsx-runtime.ts`**
-`jsx`, `jsxs`, `jsxDEV`, `Fragment`, `Props`, `ComponentType`, `Element`, `ElementChildrenAttribute`, `IntrinsicAttributes`, `IntrinsicElements`
-
-**`src/link.ts`**
-`createLink`
-
-**`src/signal.ts`**
-`createSignal`, `createEffect`, `createMemo`, `untrack`, `batch`, `Signal`, `ReadonlySignal`
-
-**`src/ssg.ts`**
-`generateStatic`, `prerender`, `getStaticPaths`, `SsgOptions`
-
-**`src/dev/blueprints.ts`**
-`scanBlueprints`, `BlueprintEntry`
-
-**`src/types.ts`**
-`CookieJar`, `ValidationError`, `PayloadTooLargeError`, `RedirectError`, `redirect`, `makeContext`, `definePage`, `defineHandler`, `defineLayout`, `defineError`, `defineMiddleware`, `defineAction`, `defineStaticPaths`, `action`, `getStaticPaths`, `CookieOptions`, `Validator`, `MultipartFile`, `MultipartResult`, `HeadContext`, `ExtractParams`, `State`, `RequestContext`, `RouteType`, `RouteFile`, `LayoutFile`, `MiddlewareFile`, `IslandFile`, `ScanResult`, `PageHandler`, `ApiHandler`, `LayoutHandler`, `LayoutProps`, `ErrorPageProps`, `ErrorPageHandler`, `MiddlewareFn`, `ActionFn`, `StaticPath`, `GetStaticPathsFn`
-
-**`src/dev/components.ts`**
-`scanComponents`, `updateBlueprint`, `saveBlueprint`, `ComponentEntry`
-
-**`src/dev/insert.ts`**
-`insertAfterElement`, `insertJsx`, `InsertResult`
-
-**`src/dev/remove.ts`**
-`removeJsx`, `removeElement`, `replaceElementAttrs`, `replaceTextContent`, `replaceJsx`, `getComponentFragment`, `replaceComponentFragment`, `getElementFragment`, `replaceElementFragment`, `moveNode`, `RemoveResult`, `ReplaceResult`, `ReplaceElemResult`, `FragmentResult`, `MoveResult`
-
-**`src/oml/fragment.ts`**
-`clearAllFragments`, `defineFragment`, `OmlFragmentOptions`
-
-**`src/oml/index.ts`**
-`clearAllFragments`, `defineFragment`, `blueprintToFile`, `renderToJsx`, `Fragment`, `jsx`, `jsxDEV`, `jsxs`, `defineOmlPage`, `renderToHtml`, `parseOml`, `parseOmlBlueprint`
-
-**`src/dev/watch.ts`**
-`startDev`, `DevOptions`
-
-**`src/oml/jsx-runtime.ts`**
-`jsx`, `jsxs`, `jsxDEV`, `Fragment`, `Props`, `ComponentType`, `Element`, `ElementChildrenAttribute`, `IntrinsicAttributes`, `IntrinsicElements`
-
-**`src/oml/jsx.ts`**
-`renderToJsx`, `blueprintToFile`
-
-**`src/oml/page.ts`**
-`defineOmlPage`, `OmlPageHandler`
-
-**`src/oml/render.ts`**
-`renderToHtml`, `renderToHtmlDev`
-
-**`src/oml/types.ts`**
-`parseOml`, `parseOmlBlueprint`, `OmlProps`, `OmlText`, `OmlRaw`, `OmlElement`, `OmlComponent`, `OmlFragment`, `OmlNode`, `OmlPropType`, `OmlPropSchema`, `OmlBlueprint`
-
-**`src/router/handler.ts`**
-`buildApp`, `dispatch`, `CompiledRoute`, `CompiledApp`
-
-**`src/router/matcher.ts`**
-`createMatcher`, `MatchResult`, `MatchFn`
-
-**`src/router/scanner.ts`**
-`scanIslands`, `scanRoutes`
-
-**`src/server/index.ts`**
-`startServer`, `ServerOptions`
-
-