@vielzeug/codex 3.1.1 → 26.10.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/data/catalog.json +166 -84
- package/data/llms-full.txt +3492 -1583
- package/data/llms.txt +9 -7
- package/data/manifest.json +1 -1
- package/data/packages/arsenal.json +40 -16
- package/data/packages/assay.json +12 -20
- package/data/packages/clockwork.json +31 -28
- package/data/packages/codex.json +5 -5
- package/data/packages/coins.json +4 -4
- package/data/packages/conduit.json +33 -34
- package/data/packages/courier.json +18 -17
- package/data/packages/dnd.json +11 -11
- package/data/packages/familiar.json +27 -6
- package/data/packages/flux.json +11 -8
- package/data/packages/focus.json +17 -7
- package/data/packages/forge.json +4 -4
- package/data/packages/gesture.json +11 -5
- package/data/packages/herald.json +16 -17
- package/data/packages/illusionist.json +5 -5
- package/data/packages/keymap.json +16 -12
- package/data/packages/ledger.json +26 -26
- package/data/packages/lingua.json +4 -4
- package/data/packages/mesh.json +30 -32
- package/data/packages/necromancer.json +7 -6
- package/data/packages/orbit.json +11 -10
- package/data/packages/ore.json +6 -5
- package/data/packages/postmaster.json +26 -26
- package/data/packages/prism.json +50 -42
- package/data/packages/pulse.json +34 -34
- package/data/packages/refine.json +7 -5
- package/data/packages/ripple.json +4 -4
- package/data/packages/rune.json +9 -9
- package/data/packages/sandbox.json +4 -4
- package/data/packages/scout.json +17 -11
- package/data/packages/scroll.json +14 -14
- package/data/packages/sentinel.json +26 -15
- package/data/packages/sigil.json +6 -6
- package/data/packages/sourcerer.json +4 -4
- package/data/packages/spell.json +31 -36
- package/data/packages/tandem.json +29 -0
- package/data/packages/tavern.json +23 -0
- package/data/packages/tempo.json +45 -43
- package/data/packages/vault.json +15 -25
- package/data/packages/ward.json +27 -30
- package/data/packages/wayfinder.json +34 -27
- package/data/refine.json +987 -134
- package/data/search.json +341 -306
- package/dist/http.js +2 -2
- package/dist/http.js.map +1 -1
- package/dist/index.d.ts +3 -4
- package/dist/index.js +3 -4
- package/dist/index.js.map +1 -1
- package/dist/refine.d.ts +1 -1
- package/dist/refine.js +1 -1
- package/dist/server.d.ts +1 -1
- package/dist/server.js +1 -1
- package/dist/tools/refine.js +1 -1
- package/package.json +5 -12
- package/skills/vielzeug/SKILL.md +57 -55
- package/dist/advanced.d.ts +0 -12
- package/dist/advanced.js +0 -13
- package/dist/advanced.js.map +0 -1
package/dist/http.js
CHANGED
|
@@ -12,7 +12,7 @@ function close(server) {
|
|
|
12
12
|
});
|
|
13
13
|
}
|
|
14
14
|
/**
|
|
15
|
-
* Builds a Web-standard `Request` from a Node `IncomingMessage
|
|
15
|
+
* Builds a Web-standard `Request` from a Node `IncomingMessage`: `createMcpHandler()`'s
|
|
16
16
|
* `fetch()` face speaks Fetch API objects (2026-07-28's stateless transport is Web-standard
|
|
17
17
|
* `Request`/`Response`, not Node's own `req`/`res` pair), so the loopback host bridges once here.
|
|
18
18
|
*/
|
|
@@ -53,7 +53,7 @@ export async function startHttpHost(options) {
|
|
|
53
53
|
throw new CodexError('HTTP host must be a loopback address (127.0.0.1 or ::1).');
|
|
54
54
|
}
|
|
55
55
|
// Stateless by default (SEP-2575): a fresh server instance per request, matching the
|
|
56
|
-
// spec's "any request can land on any instance" design
|
|
56
|
+
// spec's "any request can land on any instance" design: codex's tools carry no
|
|
57
57
|
// per-connection state, so a persistent instance buys nothing beyond a small, negligible
|
|
58
58
|
// (13-tool catalog) reconstruction cost per request.
|
|
59
59
|
const factory = () => {
|
package/dist/http.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,9 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* `@vielzeug/codex
|
|
2
|
+
* `@vielzeug/codex`: supported public contract.
|
|
3
3
|
*
|
|
4
|
-
* Exposes the generic catalog, snapshot loader, errors, and server hosts.
|
|
5
|
-
*
|
|
6
|
-
* tools live behind `@vielzeug/codex/refine`.
|
|
4
|
+
* Exposes the generic catalog, snapshot loader, errors, and server hosts.
|
|
5
|
+
* Refine catalog types and tools live behind `@vielzeug/codex/refine`.
|
|
7
6
|
*/
|
|
8
7
|
export { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
|
|
9
8
|
export { type Catalog, CatalogError, type SearchHit, SnapshotCatalog } from './catalog.js';
|
package/dist/index.js
CHANGED
|
@@ -1,9 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* `@vielzeug/codex
|
|
2
|
+
* `@vielzeug/codex`: supported public contract.
|
|
3
3
|
*
|
|
4
|
-
* Exposes the generic catalog, snapshot loader, errors, and server hosts.
|
|
5
|
-
*
|
|
6
|
-
* tools live behind `@vielzeug/codex/refine`.
|
|
4
|
+
* Exposes the generic catalog, snapshot loader, errors, and server hosts.
|
|
5
|
+
* Refine catalog types and tools live behind `@vielzeug/codex/refine`.
|
|
7
6
|
*/
|
|
8
7
|
export { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
|
|
9
8
|
export { CatalogError, SnapshotCatalog } from './catalog.js';
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAgB,YAAY,EAAkB,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAuC,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAuB,YAAY,EAAE,MAAM,eAAe,CAAC"}
|
package/dist/refine.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* `@vielzeug/codex/refine
|
|
2
|
+
* `@vielzeug/codex/refine`: opt-in Refine component tools.
|
|
3
3
|
*
|
|
4
4
|
* The main entry (`@vielzeug/codex`) registers only generic, product-agnostic package
|
|
5
5
|
* tools. Refine-specific tools (`refine-*`) live here behind a subpath so the core
|
package/dist/refine.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* `@vielzeug/codex/refine
|
|
2
|
+
* `@vielzeug/codex/refine`: opt-in Refine component tools.
|
|
3
3
|
*
|
|
4
4
|
* The main entry (`@vielzeug/codex`) registers only generic, product-agnostic package
|
|
5
5
|
* tools. Refine-specific tools (`refine-*`) live here behind a subpath so the core
|
package/dist/server.d.ts
CHANGED
|
@@ -2,7 +2,7 @@ import { Server } from '@modelcontextprotocol/server';
|
|
|
2
2
|
import type { Catalog } from './catalog.js';
|
|
3
3
|
/**
|
|
4
4
|
* Creates an MCP server with the generic package tools registered. Refine-specific
|
|
5
|
-
* tools are opt-in via `@vielzeug/codex/refine`'s `registerRefineTools()
|
|
5
|
+
* tools are opt-in via `@vielzeug/codex/refine`'s `registerRefineTools()`: the main
|
|
6
6
|
* library entry stays product-agnostic.
|
|
7
7
|
*/
|
|
8
8
|
export declare function createMcpServer(catalog: Catalog, options: {
|
package/dist/server.js
CHANGED
|
@@ -2,7 +2,7 @@ import { Server } from '@modelcontextprotocol/server';
|
|
|
2
2
|
import { packageTools, registerTools } from './tools/index.js';
|
|
3
3
|
/**
|
|
4
4
|
* Creates an MCP server with the generic package tools registered. Refine-specific
|
|
5
|
-
* tools are opt-in via `@vielzeug/codex/refine`'s `registerRefineTools()
|
|
5
|
+
* tools are opt-in via `@vielzeug/codex/refine`'s `registerRefineTools()`: the main
|
|
6
6
|
* library entry stays product-agnostic.
|
|
7
7
|
*/
|
|
8
8
|
export function createMcpServer(catalog, options) {
|
package/dist/tools/refine.js
CHANGED
|
@@ -49,7 +49,7 @@ function htmlTemplate(component, scenario) {
|
|
|
49
49
|
.filter((slot) => slot.name)
|
|
50
50
|
.map((slot) => ` <span slot="${escapeHtml(slot.name)}">${escapeHtml(slot.description ?? slot.name)}</span>`);
|
|
51
51
|
const body = slots.length > 0 ? `\n${slots.join('\n')}\n` : '\n Content\n';
|
|
52
|
-
const comment = scenario ? `<!-- ${scenario.replaceAll('--', '
|
|
52
|
+
const comment = scenario ? `<!-- ${scenario.replaceAll('--', ':')} -->\n` : '';
|
|
53
53
|
return `${comment}<${name}${attributes.length ? `\n ${attributes.join('\n ')}` : ''}>${body}</${name}>`;
|
|
54
54
|
}
|
|
55
55
|
function usageIssues(component, html) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vielzeug/codex",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "26.10.1",
|
|
4
4
|
"description": "MCP server exposing all Vielzeug docs to AI clients",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -23,10 +23,6 @@
|
|
|
23
23
|
"types": "./dist/index.d.ts",
|
|
24
24
|
"import": "./dist/index.js"
|
|
25
25
|
},
|
|
26
|
-
"./advanced": {
|
|
27
|
-
"types": "./dist/advanced.d.ts",
|
|
28
|
-
"import": "./dist/advanced.js"
|
|
29
|
-
},
|
|
30
26
|
"./refine": {
|
|
31
27
|
"types": "./dist/refine.d.ts",
|
|
32
28
|
"import": "./dist/refine.js"
|
|
@@ -34,9 +30,6 @@
|
|
|
34
30
|
},
|
|
35
31
|
"typesVersions": {
|
|
36
32
|
"*": {
|
|
37
|
-
"advanced": [
|
|
38
|
-
"dist/advanced.d.ts"
|
|
39
|
-
],
|
|
40
33
|
"refine": [
|
|
41
34
|
"dist/refine.d.ts"
|
|
42
35
|
]
|
|
@@ -65,12 +58,12 @@
|
|
|
65
58
|
"verify:exports": "node verify-exports.mjs"
|
|
66
59
|
},
|
|
67
60
|
"dependencies": {
|
|
68
|
-
"@modelcontextprotocol/server": "2.
|
|
61
|
+
"@modelcontextprotocol/server": "2.1.0"
|
|
69
62
|
},
|
|
70
63
|
"devDependencies": {
|
|
71
|
-
"@types/node": "^26.
|
|
72
|
-
"@vielzeug/refine": "
|
|
64
|
+
"@types/node": "^26.6.2",
|
|
65
|
+
"@vielzeug/refine": "26.10.1",
|
|
73
66
|
"typescript": "^6.0.3",
|
|
74
|
-
"vitest": "^5.0.
|
|
67
|
+
"vitest": "^5.0.1"
|
|
75
68
|
}
|
|
76
69
|
}
|
package/skills/vielzeug/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: vielzeug
|
|
3
|
-
description: Use when a project depends on any @vielzeug/* package
|
|
3
|
+
description: 'Use when a project depends on any @vielzeug/* package: pick the owning package instead of hand-rolling, and use Refine components, tokens, and theme whenever @vielzeug/refine is installed. Applies to features, fixes, refactors, and UI work in consuming apps.'
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Vielzeug
|
|
@@ -11,7 +11,7 @@ Vielzeug is a set of independent, zero-dependency TypeScript packages published
|
|
|
11
11
|
|
|
12
12
|
1. Read `package.json` (`dependencies`, `devDependencies`, `peerDependencies`) and list every `@vielzeug/*` entry.
|
|
13
13
|
2. Note whether `@vielzeug/refine` is installed. If it is, the **Refine** and **Theme** sections below are mandatory for any UI work.
|
|
14
|
-
3. Read the project's own agent contract (`AGENTS.md`, `.github/copilot-instructions.md`) first
|
|
14
|
+
3. Read the project's own agent contract (`AGENTS.md`, `.github/copilot-instructions.md`) first: project rules win over this skill.
|
|
15
15
|
|
|
16
16
|
## Discover, don't recall
|
|
17
17
|
|
|
@@ -22,12 +22,12 @@ Never guess exports, attributes, events, slots, or token names. Look them up:
|
|
|
22
22
|
| Which package solves X? | `search-packages`, `list-packages` | the package list below |
|
|
23
23
|
| How do I use package X? | `get-docs` (`index`, `usage`, `api`, `examples`) | `node_modules/@vielzeug/<pkg>/README.md` |
|
|
24
24
|
| Exact signature of an export | `get-type-signature` | `node_modules/@vielzeug/<pkg>/dist/*.d.ts` |
|
|
25
|
-
| Runnable example | `list-examples`, `get-example` |
|
|
25
|
+
| Runnable example | `list-examples`, `get-example` | N/A |
|
|
26
26
|
| Which Refine components exist? | `refine-list-components` | `node_modules/@vielzeug/refine/dist/custom-elements.json` |
|
|
27
27
|
| Attributes, properties, events, slots, CSS parts of `ore-*` | `refine-get-component` | same manifest |
|
|
28
28
|
| Available design tokens | `refine-get-tokens` | `node_modules/@vielzeug/refine/dist/styles/tokens.css` |
|
|
29
29
|
| Is my markup valid? | `refine-validate-usage` | compare against the manifest |
|
|
30
|
-
| Blank component scaffold | `refine-generate-template` |
|
|
30
|
+
| Blank component scaffold | `refine-generate-template` | N/A |
|
|
31
31
|
|
|
32
32
|
If the MCP server is not connected, install it with `npx -y @vielzeug/codex` (see `node_modules/@vielzeug/codex/mcp-setup.json`) or use the fallback column.
|
|
33
33
|
|
|
@@ -37,54 +37,56 @@ If a need matches a package below, use that package. Do not reimplement signals,
|
|
|
37
37
|
|
|
38
38
|
<!-- GENERATED:skill-packages:BEGIN -->
|
|
39
39
|
|
|
40
|
-
- `@vielzeug/arsenal
|
|
41
|
-
- `@vielzeug/assay
|
|
42
|
-
- `@vielzeug/clockwork
|
|
43
|
-
- `@vielzeug/coins
|
|
44
|
-
- `@vielzeug/conduit
|
|
45
|
-
- `@vielzeug/courier
|
|
46
|
-
- `@vielzeug/dnd
|
|
47
|
-
- `@vielzeug/familiar
|
|
48
|
-
- `@vielzeug/flux
|
|
49
|
-
- `@vielzeug/focus
|
|
50
|
-
- `@vielzeug/forge
|
|
51
|
-
- `@vielzeug/gesture
|
|
52
|
-
- `@vielzeug/herald
|
|
53
|
-
- `@vielzeug/illusionist
|
|
54
|
-
- `@vielzeug/keymap
|
|
55
|
-
- `@vielzeug/ledger
|
|
56
|
-
- `@vielzeug/lingua
|
|
57
|
-
- `@vielzeug/mesh
|
|
58
|
-
- `@vielzeug/necromancer
|
|
59
|
-
- `@vielzeug/orbit
|
|
60
|
-
- `@vielzeug/ore
|
|
61
|
-
- `@vielzeug/postmaster
|
|
62
|
-
- `@vielzeug/prism
|
|
63
|
-
- `@vielzeug/pulse
|
|
64
|
-
- `@vielzeug/refine
|
|
65
|
-
- `@vielzeug/ripple
|
|
66
|
-
- `@vielzeug/rune
|
|
67
|
-
- `@vielzeug/sandbox
|
|
68
|
-
- `@vielzeug/scout
|
|
69
|
-
- `@vielzeug/scroll
|
|
70
|
-
- `@vielzeug/sentinel
|
|
71
|
-
- `@vielzeug/sigil
|
|
72
|
-
- `@vielzeug/sourcerer
|
|
73
|
-
- `@vielzeug/spell
|
|
74
|
-
- `@vielzeug/
|
|
75
|
-
- `@vielzeug/
|
|
76
|
-
- `@vielzeug/
|
|
77
|
-
- `@vielzeug/
|
|
40
|
+
- `@vielzeug/arsenal`: Non-trivial TypeScript utilities: retry, cancellation, cache, safe-path, serialization, prototype-pollution-guarded collections
|
|
41
|
+
- `@vielzeug/assay`: Framework-agnostic DOM testing primitives: scoped queries, event dispatch, async waiting
|
|
42
|
+
- `@vielzeug/clockwork`: Framework-neutral finite state machines with pure transitions and actors
|
|
43
|
+
- `@vielzeug/coins`: Currency formatting and exchange utilities for monetary arithmetic
|
|
44
|
+
- `@vielzeug/conduit`: Typed dependency injection container
|
|
45
|
+
- `@vielzeug/courier`: Typed HTTP client with bounded structured-key caching, prefetching, immutable middleware, and structured errors
|
|
46
|
+
- `@vielzeug/dnd`: Drag-and-drop: drop zones and sortable lists
|
|
47
|
+
- `@vielzeug/familiar`: Web Worker pool with tasks, timeouts, cancellation
|
|
48
|
+
- `@vielzeug/flux`: Minimal push streams with explicit ownership, bounded buffering, and structural bridges
|
|
49
|
+
- `@vielzeug/focus`: Framework-neutral list navigation and focus restoration primitives
|
|
50
|
+
- `@vielzeug/forge`: Typed form state, validation, submission
|
|
51
|
+
- `@vielzeug/gesture`: Framework-neutral two-dimensional pointer drag and one-axis pan recognition with lifecycle-owned handles
|
|
52
|
+
- `@vielzeug/herald`: Typed synchronous event bus with wildcard subscriptions, one-shot waits, and lifecycle tracing
|
|
53
|
+
- `@vielzeug/illusionist`: Typed, deterministic, locale-aware fake data generator with seeded PRNG
|
|
54
|
+
- `@vielzeug/keymap`: Headless keyboard shortcut manager with chord sequences
|
|
55
|
+
- `@vielzeug/ledger`: Serialized reversible command history with atomic framework-neutral state and cancellation ownership
|
|
56
|
+
- `@vielzeug/lingua`: Typed i18n with pluralization and lazy locale loading
|
|
57
|
+
- `@vielzeug/mesh`: Backendless peer-to-peer session transport over WebRTC data channels with manual pairing and host-authoritative star topology
|
|
58
|
+
- `@vielzeug/necromancer`: Lifecycle-owned Web Animations API primitives with native access, per-handle groups, and additive FLIP
|
|
59
|
+
- `@vielzeug/orbit`: Floating UI positioning with lifecycle-owned geometry and middleware
|
|
60
|
+
- `@vielzeug/ore`: Functional web-component authoring on top of ripple
|
|
61
|
+
- `@vielzeug/postmaster`: Typed durable job outbox with leased processing, retries, and dead-letter recovery
|
|
62
|
+
- `@vielzeug/prism`: Responsive SVG charts with explicit updates: line, bar, area, pie, radar, sparkline
|
|
63
|
+
- `@vielzeug/pulse`: Typed WebSocket client with channels, rooms, presence, reconnect
|
|
64
|
+
- `@vielzeug/refine`: Accessible, themeable web components built on ore
|
|
65
|
+
- `@vielzeug/ripple`: Reactive runtime primitives: signals, derived values, effects, scopes, watchers, and async resources
|
|
66
|
+
- `@vielzeug/rune`: Structured scoped logger with remote transport
|
|
67
|
+
- `@vielzeug/sandbox`: Sandboxed iframe runtime with typed postMessage state bridge
|
|
68
|
+
- `@vielzeug/scout`: Trigram fuzzy-search index with highlighting and reactive layer
|
|
69
|
+
- `@vielzeug/scroll`: Virtual list engine for large datasets
|
|
70
|
+
- `@vielzeug/sentinel`: Subscribable snapshots for external browser environment state
|
|
71
|
+
- `@vielzeug/sigil`: QR code generation and scanning: pure matrix encoder, SVG and canvas renderers, native BarcodeDetector scanning
|
|
72
|
+
- `@vielzeug/sourcerer`: Reactive collection sources with local, page, cursor, and infinite pagination
|
|
73
|
+
- `@vielzeug/spell`: Zero-dependency schema validation with Standard Schema interoperability
|
|
74
|
+
- `@vielzeug/tandem`: Offline-first sync engine with rev baselines, tombstoned deletions, and idle-batched pushes
|
|
75
|
+
- `@vielzeug/tavern`: Table sessions over mesh: host-owned state replication with guest command forwarding
|
|
76
|
+
- `@vielzeug/tempo`: Temporal-powered date utilities
|
|
77
|
+
- `@vielzeug/vault`: Adapter-free typed storage core with focused browser and SQLite subpaths
|
|
78
|
+
- `@vielzeug/ward`: Ordered authorization rules with immutable policies and typed decisions
|
|
79
|
+
- `@vielzeug/wayfinder`: Client-side router with middleware and guards
|
|
78
80
|
|
|
79
81
|
<!-- GENERATED:skill-packages:END -->
|
|
80
82
|
|
|
81
83
|
Common compositions (verify each API with `get-docs` before writing code):
|
|
82
84
|
|
|
83
|
-
- **State
|
|
84
|
-
- **Data
|
|
85
|
-
- **Forms
|
|
86
|
-
- **App shell
|
|
87
|
-
- **Dispose** every handle you create (`effect`, subscriptions, clients) when its owner unmounts. Vielzeug APIs return disposables
|
|
85
|
+
- **State**: `ripple` signals/derived/effects; `clockwork` when state is a finite machine; `ledger` for undo/redo.
|
|
86
|
+
- **Data**: `courier` for HTTP with caching and structured errors; `sourcerer` for paged/cursor/infinite collections; `vault` for storage; `postmaster` for durable jobs; `scout` for fuzzy search; `mesh` for backendless peer sessions on a LAN; `sigil` for QR generation/scanning: prefer `ore-qr-code` / `ore-qr-scanner` when Refine is installed.
|
|
87
|
+
- **Forms**: `forge` for form state, validation, and submission; `spell` for schemas; render fields with Refine inputs when Refine is installed.
|
|
88
|
+
- **App shell**: `wayfinder` routing; `conduit` DI; `herald` events; `lingua` i18n; `rune` logging; `ward` authorization; `keymap` shortcuts.
|
|
89
|
+
- **Dispose** every handle you create (`effect`, subscriptions, clients) when its owner unmounts. Vielzeug APIs return disposables: use them.
|
|
88
90
|
|
|
89
91
|
## Refine (when `@vielzeug/refine` is installed)
|
|
90
92
|
|
|
@@ -107,7 +109,7 @@ Refine is the UI layer. Build interfaces from `ore-*` elements before anything e
|
|
|
107
109
|
|
|
108
110
|
5. **Follow the element contract**: attributes for primitives, JavaScript properties for objects/arrays/callbacks, standard DOM events (read state from `event.target`), named slots for composition. Icon-only controls need an accessible label.
|
|
109
111
|
|
|
110
|
-
6. **Type the tags** once in a type entry point: `import type {} from '@vielzeug/refine/frameworks/elements'` (or `/react`, `/vue`). Framework wiring (React 18/19, Vue, Svelte, Angular, SSR guards) is documented in the Refine `frameworks` doc
|
|
112
|
+
6. **Type the tags** once in a type entry point: `import type {} from '@vielzeug/refine/frameworks/elements'` (or `/react`, `/vue`). Framework wiring (React 18/19, Vue, Svelte, Angular, SSR guards) is documented in the Refine `frameworks` doc: fetch it with `get-docs` before integrating.
|
|
111
113
|
|
|
112
114
|
7. **Validate** every fragment you write with `refine-validate-usage` before finishing.
|
|
113
115
|
|
|
@@ -126,13 +128,13 @@ Refine is the UI layer. Build interfaces from `ore-*` elements before anything e
|
|
|
126
128
|
|
|
127
129
|
Refine covers the widget layer; these cover what it does not. Use them directly only when no `ore-*` element already provides the behavior:
|
|
128
130
|
|
|
129
|
-
- `prism
|
|
130
|
-
- `scroll
|
|
131
|
-
- `dnd` / `gesture
|
|
132
|
-
- `necromancer
|
|
133
|
-
- `orbit
|
|
134
|
-
- `focus` / `keymap
|
|
135
|
-
- `ore
|
|
131
|
+
- `prism`: SVG charts (line, bar, area, pie, sparkline) plus `@vielzeug/prism/theme`.
|
|
132
|
+
- `scroll`: virtualized large lists (prefer `ore-datagrid`/`ore-list` for ordinary sizes).
|
|
133
|
+
- `dnd` / `gesture`: sortable lists, drop zones, pointer drag and pan.
|
|
134
|
+
- `necromancer`: Web Animations API primitives and FLIP.
|
|
135
|
+
- `orbit`: floating positioning; reach for `ore-popover`, `ore-tooltip`, `ore-menu` first.
|
|
136
|
+
- `focus` / `keymap`: list navigation, focus restoration, keyboard shortcuts.
|
|
137
|
+
- `ore`: authoring your own custom elements that compose Refine.
|
|
136
138
|
|
|
137
139
|
## Anti-patterns
|
|
138
140
|
|
package/dist/advanced.d.ts
DELETED
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `@vielzeug/codex/advanced` — snapshot parser internals.
|
|
3
|
-
*
|
|
4
|
-
* The main entry (`@vielzeug/codex`) keeps the supported catalog, loader, and server
|
|
5
|
-
* contracts. These pure validation parsers and raw snapshot types
|
|
6
|
-
* are the smaller, less stable contract used by generators and integration tests —
|
|
7
|
-
* import them explicitly from this subpath when you need to parse individual snapshot
|
|
8
|
-
* chunks rather than loading a whole validated snapshot.
|
|
9
|
-
*/
|
|
10
|
-
export { CodexError } from './errors.js';
|
|
11
|
-
export { type LoadedSnapshot, loadSnapshotDirectory, parseCatalog, parseContent, parseManifest, parsePointer, parseRefine, parseSearch, validateSnapshot, } from './snapshot.js';
|
|
12
|
-
export { type CatalogFile, DOC_PAGES, type SearchRecord, SNAPSHOT_SCHEMA_VERSION, type SnapshotPointer, } from './types.js';
|
package/dist/advanced.js
DELETED
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `@vielzeug/codex/advanced` — snapshot parser internals.
|
|
3
|
-
*
|
|
4
|
-
* The main entry (`@vielzeug/codex`) keeps the supported catalog, loader, and server
|
|
5
|
-
* contracts. These pure validation parsers and raw snapshot types
|
|
6
|
-
* are the smaller, less stable contract used by generators and integration tests —
|
|
7
|
-
* import them explicitly from this subpath when you need to parse individual snapshot
|
|
8
|
-
* chunks rather than loading a whole validated snapshot.
|
|
9
|
-
*/
|
|
10
|
-
export { CodexError } from './errors.js';
|
|
11
|
-
export { loadSnapshotDirectory, parseCatalog, parseContent, parseManifest, parsePointer, parseRefine, parseSearch, validateSnapshot, } from './snapshot.js';
|
|
12
|
-
export { DOC_PAGES, SNAPSHOT_SCHEMA_VERSION, } from './types.js';
|
|
13
|
-
//# sourceMappingURL=advanced.js.map
|
package/dist/advanced.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"advanced.js","sourceRoot":"","sources":["../src/advanced.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAEL,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,SAAS,EAET,uBAAuB,GAExB,MAAM,YAAY,CAAC"}
|