mythik 0.1.3 → 0.1.4

package/docs/wiki/compiled/concept-public-package-names.md

@@ -7,29 +7,38 @@ sources: [docs/consumer/ai-context.md, docs/consumer/WHERE-TO-LOOK.md]
 
 # Public package names
 
-Mythik publishes unscoped npm packages. Do not generate scoped package imports for public npm consumers.
+Mythik publishes unscoped npm packages. Do not generate scoped package imports for public npm consumers.
 
 | Public package | Use |
 |---|---|
 | `mythik` | Browser-safe core runtime, state, expressions, validation, browser-safe stores |
-| `mythik/server` | Node-only stores, SQL drivers, and SQL DDL helpers exported from the core package subpath |
-| `mythik-react` | React host, renderer, and web primitives |
-| `mythik-cli` | CLI package; installs the `mythik` binary |
-| `mythik-cli/api` | Programmatic CLI API: `runPush`, `runPatch`, `runLint`, and related types |
-| `mythik-server` | Express server runtime for ApiSpecs |
-
-The `mythik` package also ships the AI documentation under `node_modules/mythik/docs`.
-Use [[@cli-docs]] to locate or copy it after install.
-
-Typical React install:
+| `mythik/server` | Node-only stores, SQL drivers, and SQL DDL helpers exported from the core package subpath |
+| `mythik-react` | React host, renderer, and web primitives |
+| `mythik-cli` | CLI package; installs the `mythik` binary |
+| `mythik-cli/api` | Programmatic CLI API: `runPush`, `runPatch`, `runLint`, and related types |
+| `mythik-server` | Express server runtime for ApiSpecs |
+
+The `mythik` package also ships the AI documentation under `node_modules/mythik/docs`.
+Use [[@cli-docs]] to locate or copy it after install.
+
+Typical React install:
 
 ```bash
 npm install mythik mythik-react
 npm install -D mythik-cli
 ```
 
-Add `mythik-server` only when building a Mythik-backed Node server. React Native work is a repository preview track, not part of the supported npm publish surface yet.
-
-SQL adapters (`mssql`, `pg`, `mysql2`, `better-sqlite3`) are optional dependencies of `mythik`. They install by default with npm/pnpm unless optional dependencies are omitted.
+Add `mythik-server` only when building a Mythik-backed Node server. React Native work is a repository preview track, not part of the supported npm publish surface yet.
+
+SQL adapters (`mssql`, `pg`, `mysql2`, `better-sqlite3`) are optional peer dependencies. Install only the selected database adapter:
+
+```bash
+npm install pg              # PostgreSQL
+npm install mysql2          # MySQL
+npm install mssql           # SQL Server
+npm install better-sqlite3  # SQLite
+```
+
+SQLite uses native `better-sqlite3`; warnings from its transitive native-build helpers are adapter-level install warnings, not Mythik runtime failures. Missing SQL adapter errors include the package name and exact install command for the selected dialect.
 
-Related: [[@cli-docs]], [[@cli-programmatic-api]], [[@concept-spec-stores-catalog]], [[@concept-where-to-look]].
+Related: [[@cli-docs]], [[@cli-programmatic-api]], [[@concept-spec-stores-catalog]], [[@concept-where-to-look]].

package/docs/wiki/compiled/path-ui-loading-error.md

@@ -16,6 +16,11 @@ Auto-managed by `fetch` action.
 | `/ui/loading` | boolean | Set `true` at request start, `false` at resolve. **Shared across all fetch actions.** |
 | `/ui/lastError` | object | Error message on failure; cleared on next successful fetch. |
 
+`/ui/lastError` is global compatibility state. For critical screen loads,
+set `fetch.params.errorTarget` to a screen-owned `/ui/...` path and render
+that path visibly; `fetch` writes the same structured error there and clears
+it on success.
+
 ## Use in visibility
 
 ```json

package/docs/wiki/compiled/pattern-fetch-vs-datasources.md

@@ -19,6 +19,11 @@ Both load data into state. Pick **one pattern per data target**.
 | **Re-fetch** | Manual (call fetch again) | Automatic on param change, or `refreshDataSource` |
 | **Use for** | Static initial data, POST/PUT/DELETE | Lists with filters, search, pagination |
 
+For critical `initialActions + fetch` screen loads, set `errorTarget` to a
+screen-owned path (for example `/ui/loadErrors/orderForm`) and render that
+path visibly. `/ui/lastError` is shared global state and can be overwritten
+by unrelated fetches.
+
 ## Rule
 
 **Don't mix both for the same data target.** They write to different

package/docs/wiki/compiled/pattern-loading-content-empty.md

@@ -12,7 +12,8 @@ state paths differ between `initialActions + fetch` vs `dataSources`.
 
 ## With `initialActions + fetch`
 
-Uses `/ui/loading` and `/ui/lastError`:
+Uses `/ui/loading`; critical loads should set `errorTarget` and render the
+screen-owned error path:
 
 ```json
 "loading": { "visible": { "$and": [
@@ -24,7 +25,7 @@ Uses `/ui/loading` and `/ui/lastError`:
   { "$not": { "$state": "/ui/loading" } },
   { "$not": { "$array": "count", "source": { "$state": "/items" } } }
 ]}},
-"error":   { "visible": { "$state": "/ui/lastError" } }
+"error":   { "visible": { "$state": "/ui/loadErrors/items" } }
 ```
 
 ## With `dataSources`

package/docs/wiki/compiled/primitive-select.md

@@ -7,8 +7,8 @@ sources: [docs/consumer/ai-context-primitives.md#select, docs/consumer/reference
 
 # `select`
 
-Dropdown picker. Options accept either string array or `[{ label, value }]`
-objects.
+Dropdown picker. Options accept strings, `[{ label, value }]` objects, or
+catalog-shaped objects when `labelKey` and `valueKey` are provided.
 
 ## Props
 
@@ -55,6 +55,16 @@ State-driven options:
 }}
 ```
 
+Catalog-shaped options:
+```json
+{ "type": "select", "props": {
+  "options": { "$state": "/cat/services/data" },
+  "labelKey": "name",
+  "valueKey": "id",
+  "value": { "$bindState": "/form/serviceId" }
+}}
+```
+
 ## Notes
 
 - **Listbox portals to `document.body`** (rule 225) — the dropdown panel
@@ -64,6 +74,10 @@ State-driven options:
   opaque background for readability across all surface modes (in
   `outlined`, card has transparent bg).
 
+Malformed option data renders as disabled diagnostics instead of blank
+clickable rows or crashes. `labelKey` and `valueKey` are simple field names on each
+option object, not nested paths.
+
 ## Related concepts
 
 - [[@expression-bindstate]]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mythik",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Spec-driven core runtime for validated JSON applications, APIs, editor sessions, state, actions, validation, and versioning.",
   "license": "Apache-2.0",
   "type": "module",
@@ -48,15 +48,33 @@
   },
   "devDependencies": {
     "@types/node": "^25.5.2",
+    "better-sqlite3": "^12.9.0",
     "es-module-lexer": "^2.0.0",
+    "mssql": "^12.2.1",
+    "mysql2": "^3.22.3",
+    "pg": "^8.20.0",
     "typescript": "^5.7.0"
   },
-  "optionalDependencies": {
+  "peerDependencies": {
     "better-sqlite3": "^12.9.0",
     "mssql": "^12.2.1",
     "mysql2": "^3.22.3",
     "pg": "^8.20.0"
   },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    },
+    "mssql": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    }
+  },
   "scripts": {
     "build": "node ../../node_modules/typescript/bin/tsc",
     "typecheck": "node ../../node_modules/typescript/bin/tsc --noEmit"