@kudzujs/core 0.9.0 → 0.9.2

package/README.md

@@ -14,7 +14,7 @@ Kudzu compiles ordinary React-shaped TypeScript and TSX into complete static HTM
 
 > Experimental `0.9.x`: the compiler API and supported TSX surface may change.
 
-**Latest release: 0.9.0 - Semantic compression.** Ordinary React-shaped state, derived data, shared actions, effects, component ownership, and keyed collections compile through a bounded package-neutral semantic core while static pages remain zero JavaScript. Read the [release notes](./RELEASES.md#090---semantic-compression), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.9.0), or follow the [architecture packet](./docs/next-architecture/README.md).
+**Latest release: 0.9.2 - Legacy CSS safety.** Projects with source CSS but no explicit style ownership retain their pre-0.8.53 global styles with an actionable migration warning; explicit apps keep route-aware CSS unchanged. Read the [release notes](./RELEASES.md#092---legacy-css-safety), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.9.2), or follow the [architecture packet](./docs/next-architecture/README.md).
 
 - [Documentation](https://kudzujs.cloud/docs)
 - [Installation guide](https://kudzujs.cloud/docs#install)

package/RELEASES.md

@@ -1,5 +1,58 @@
 # Kudzu Releases
 
+## 0.9.2 - Legacy CSS safety
+
+Kudzu 0.9.2 prevents pre-0.8.53 applications from silently producing an
+unstyled deploy after upgrading to route-aware CSS ownership.
+
+### Changed in 0.9.2
+
+- When no route imports CSS and `kudzu.config styles` is empty, source CSS is
+  linked globally in deterministic path order using the legacy behavior.
+- The build prints an actionable warning directing applications to explicit
+  source imports or global configuration.
+- Projects with any explicit CSS ownership retain unchanged route-aware output;
+  the fallback adds no browser JavaScript or explicit-path build work.
+
+### Validation
+
+- A two-route legacy fixture emits both unimported styles on both routes in path
+  order and keeps both routes JavaScript-free.
+- Configured global styles and explicit source-style tests retain their existing
+  output.
+- `npm run check`, `npm test`, and `npm run test:package` pass with 254 tests.
+
+### Upgrade
+
+```sh
+npm install @kudzujs/core@^0.9.2
+```
+
+## 0.9.1 - Positional primitive lists
+
+Kudzu 0.9.1 allows JSON-safe primitive values in lists keyed by their authored
+position while retaining the plain-object requirement for property-keyed rows.
+
+### Changed in 0.9.1
+
+- Build and browser list validation now accept primitive positional rows.
+- Compact object-row serialization ignores primitive arrays instead of treating
+  their values as object records.
+- Lupin-derived fixtures prove realtime rooms, lobby and private-room entry,
+  stopwatch ownership, chat and spectator replacement, Canvas/RAF input,
+  IME handling, panic shortcuts, and exact cleanup without a game runtime.
+
+### Validation
+
+- Static sibling routes remain complete HTML with zero JavaScript.
+- `npm run check`, `npm test`, and `npm run test:package` pass with 253 tests.
+
+### Upgrade
+
+```sh
+npm install @kudzujs/core@^0.9.1
+```
+
 ## 0.9.0 - Semantic compression
 
 Kudzu 0.9.0 consolidates evidence-backed React migration shapes onto the existing signal, handler, effect, component-ownership, and keyed-list semantics without adding React, hydration, a VDOM, or a retained browser component tree.

package/framework/README.md

@@ -80,7 +80,7 @@ Static routes receive no browser runtime. Command routes receive `runtime.js`; d
 
 Exact relative `.worker.ts` constructors in inline effects are validated and bundled in a separate content-hashed ESM graph under `dist/assets/workers/`. Those files are referenced only by rendered effect handlers and never become document capability scripts, preloads, or window imports; unreachable source effects do not emit their Worker roots. Worker graphs allow relative TypeScript ESM runtime imports only and reject JSX, package runtime imports, import-equals declarations, dynamic imports, `require()`, and paths outside `src`. Ordinary runtime imports or re-exports of `.worker.ts` and Worker construction in imported keyed-row effects are rejected.
 
-Page `metadata` can emit description, canonical, favicon, manifest, Open Graph, and Twitter Card tags without a client runtime. Relative source CSS imports follow each page's reachable TypeScript graph and link only from those routes; `kudzu.config` styles remain explicitly global. Enhanced navigation loads incoming managed styles before route replacement, reuses shared links, and removes outgoing links. All styles are emitted before `afterBuild()` runs; static stylesheet links in component JSX fail compilation instead of loading from the body.
+Page `metadata` can emit description, canonical, favicon, manifest, Open Graph, and Twitter Card tags without a client runtime. Relative source CSS imports follow each page's reachable TypeScript graph and link only from those routes; `kudzu.config` styles remain explicitly global. For pre-0.8.53 projects with source CSS but no explicit style ownership at all, Kudzu preserves the former global path-ordered output and prints a migration warning instead of silently emitting an unstyled deploy. Enhanced navigation loads incoming managed styles before route replacement, reuses shared links, and removes outgoing links. All styles are emitted before `afterBuild()` runs; static stylesheet links in component JSX fail compilation instead of loading from the body.
 
 Inline SVG rendering normalizes an explicit set of common React presentation aliases before static serialization and binding descriptor creation. Reactive aliases use the existing generic `setAttribute` path. Reactive conditionals and flat intrinsic keyed lists store inert branch or row markup on SVG markers and parse it in the actual parent namespace only when replacement nodes are needed; existing condition/list ownership then handles insertion, identity, updates, and removal. Focus, keyboard, and click handlers on keyed SVG points may update parent state for an external accessible HTML tooltip, and retained handlers read the latest item after list updates. Builds without structural SVG compile out that fragment path, and static SVG adds no JavaScript. Keyed-item conditions, nested SVG lists, MathML structures, and namespaced attributes remain unsupported.
 

package/framework/build.mjs

@@ -45,7 +45,7 @@ export async function buildWithSession(project, { changedFiles, quiet = false, m
   try {
     await recoverOutput(outputDirectory, backupOutput)
     await rm(stagedOutput, { recursive: true, force: true })
-    const { result, pageCount, behaviorCount, cache } = await buildInto(project, stagedOutput, { changedFiles, minify, retainCache })
+    const { result, pageCount, behaviorCount, cache } = await buildInto(project, stagedOutput, { changedFiles, minify, quiet, retainCache })
     await promoteOutput(stagedOutput, outputDirectory, backupOutput)
     project.buildCache = retainCache ? cache : undefined
     if (!quiet) console.log(`Built ${pageCount} page(s), ${behaviorCount} interactive page(s) into dist/`)
@@ -63,7 +63,7 @@ export async function buildWithSession(project, { changedFiles, quiet = false, m
   }
 }
 
-async function buildInto(project, outputDirectory, { changedFiles, minify, retainCache }) {
+async function buildInto(project, outputDirectory, { changedFiles, minify, quiet, retainCache }) {
   const { root, sourceDirectory, pagesDirectory, workDirectory } = project
   const previous = retainCache ? project.buildCache : undefined
   project.buildGeneration = (project.buildGeneration ?? 0) + 1
@@ -108,6 +108,14 @@ async function buildInto(project, outputDirectory, { changedFiles, minify, retai
   for (const file of sourceFiles) sourceFileSet.add(file)
   const staticFiles = await safeStaticFiles(projectFiles)
   const stylesByPage = new Map(pageFiles.map(file => [file, orderSourceStyles([file], sourceFiles, sourceIndex, staticFiles).filter(style => !configuredStyleSources.has(style))]))
+  const explicitSourceStyles = new Set([...stylesByPage.values()].flat())
+  const legacyStyles = configuredStyles.sources.length || configuredStyles.urls.length || explicitSourceStyles.size
+    ? []
+    : [...staticFiles].filter(file => file.toLowerCase().endsWith(".css")).sort()
+  if (legacyStyles.length) {
+    for (const file of pageFiles) stylesByPage.set(file, legacyStyles)
+    if (!quiet) console.warn("Kudzu: no route imports CSS and kudzu.config styles is empty; applying the legacy global CSS fallback. Import CSS from reachable source or declare config.styles for route-aware output.")
+  }
   const cssFiles = [...new Set([...stylesByPage.values()].flat())]
   const importedAssets = new Set()
   const { cssModules, cssOutputs } = await prepareSourceStyles(cssFiles, staticFiles, importedAssets, base, project)

package/framework/core.mjs

@@ -319,7 +319,7 @@ export function list(items, keyField, render, ownerField, selector = [], indexed
   for (const [index, item] of values.entries()) {
     const key = keyField === null ? index : item?.[keyField]
     if (!validListKey(key)) throw new Error(`Keyed list key "${keyField}" must be a string or finite number`)
-    assertListItem(item)
+    assertListItem(item, keyField === null)
     assertListValue(item, new Set())
     const token = `${typeof key}:${key}`
     if (keys.has(token)) throw new Error(`Duplicate keyed list key: ${String(key)}`)
@@ -360,7 +360,8 @@ function validListKey(key) {
   return typeof key === "string" || typeof key === "number" && Number.isFinite(key)
 }
 
-function assertListItem(item) {
+function assertListItem(item, allowPrimitive = false) {
+  if (allowPrimitive && (item === null || typeof item !== "object")) return
   const prototype = item && typeof item === "object" ? Object.getPrototypeOf(item) : undefined
   if (!item || Array.isArray(item) || prototype !== Object.prototype) throw new Error("Keyed list items must be ordinary plain objects")
 }
@@ -1103,6 +1104,7 @@ function escapeJsonAttribute(value) {
 
 function compactListState(value) {
   if (!Array.isArray(value) || !value.length) return undefined
+  if (!value[0] || typeof value[0] !== "object" || Array.isArray(value[0]) || Object.getPrototypeOf(value[0]) !== Object.prototype) return undefined
   const fields = Object.keys(value[0])
   if (!fields.length || !value.every(item => Object.keys(item).length === fields.length && fields.every(field => Object.hasOwn(item, field)))) return undefined
   return [fields, value.map(item => fields.map(field => item[field]))]

package/framework/list-runtime.js

@@ -170,7 +170,7 @@ function updateList(list) {
   for (const [index, item] of items.entries()) {
     const key = list.descriptor.key === null ? index : item?.[list.descriptor.key]
     if (!validListKey(key)) throw new Error(`Keyed list key "${list.descriptor.key}" must be a string or finite number`)
-    assertListItem(item)
+    assertListItem(item, list.descriptor.key === null)
     const seededValue = __KUDZU_LIST_SEEDS__ ? list.seedFields && seededListValue(item, list.seedFields, list.valueSeed, !referenceOnly) : undefined
     if (seededValue === undefined) assertListValue(item, seen, true)
     const token = keyToken(key)
@@ -1155,7 +1155,8 @@ function validListKey(key) {
   return typeof key === "string" || typeof key === "number" && Number.isFinite(key)
 }
 
-function assertListItem(item) {
+function assertListItem(item, allowPrimitive = false) {
+  if (allowPrimitive && (item === null || typeof item !== "object")) return
   const prototype = item && typeof item === "object" ? Object.getPrototypeOf(item) : undefined
   if (!item || Array.isArray(item) || prototype !== Object.prototype) throw new Error("Keyed list items must be ordinary plain objects")
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kudzujs/core",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "HTML-first TSX framework with synchronous state semantics and no virtual DOM",
   "type": "module",
   "license": "MIT",