Repository navigation
Expand file tree
/
Copy pathllms.txt
More file actions
92 lines (75 loc) · 15 KB
/
Copy pathllms.txt
File metadata and controls
92 lines (75 loc) · 15 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
# wcstack
> Standards-first, zero-config, buildless Web Components packages for building web apps: reactive state with declarative `data-wcs` HTML bindings (@wcstack/state), SPA routing (@wcstack/router), TC39-style signals (@wcstack/signals), and 39 I/O node packages of declarative custom elements (`wcs-*` tags) that wrap browser APIs (fetch, storage, WebSocket, camera, sensors, ...) via the wc-bindable protocol.
Current release: v4.1.1. An app is correctly a single HTML file plus one-line CDN loads
(`<script type="module" src="https://esm.run/@wcstack/<pkg>/auto"></script>`) — no bundler,
no build step, no npm install. All links below are pinned to v4.1.1.
## Entry guide
- [wcstack](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/wcstack/README.md): wcstack SPA-core bundle: reactive state, router, fetch, storage and autoloader as one script tag with one SRI hash. Also the entry point for the wcstack ecosystem - run `npm view wcstack readme` for the full authoring guide.
The unscoped `wcstack` package is documentation-only: read it with
`npm view wcstack readme`; load or install the individual `@wcstack/*` packages an app uses.
## Core
- [@wcstack/state](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/state/README.md): Reactive state management with declarative data binding for Web Components. Zero dependencies, buildless.
- [@wcstack/router](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/router/README.md): Declarative SPA routing for Web Components with Navigation API support. Zero dependencies, buildless.
- [@wcstack/signals](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/signals/README.md): Signals-based lightweight reactive core with async-IO resource adapters and a wc-bindable → signal bridge for Web Components. Zero runtime dependencies.
## Machine-readable contracts
- [wcs-manifest.json](https://cdn.jsdelivr.net/npm/@wcstack/state@4.1.1/dist/wcs-manifest.json): the data-wcs binding grammar and all built-in filters (names, arity, argument types) as JSON — the single source of truth for tooling
- [Timing and firing contract](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/docs/timing-and-firing-contract.md): when bindings attach, when writes fire, initial-sync authority
- [Sidecar manifest schema](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/docs/wcstack-manifest-schema.md): wcstack.manifest.json format for declaring custom tag contracts to the wcs-validate linter and IDE
- [Framework adapter integration](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/docs/framework-adapter-integration.md): using `<wcs-*>` from React / Vue / Svelte / Solid / Angular — definition gating, object inputs as properties, raw values across the structured-clone boundary
## I/O node packages (wcs-* tags)
- [@wcstack/accelerometer](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/accelerometer/README.md): Declarative Accelerometer component for Web Components. Framework-agnostic Generic Sensor API (Accelerometer) monitor via wc-bindable-protocol.
- [@wcstack/ambient-light-sensor](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/ambient-light-sensor/README.md): Declarative AmbientLightSensor component for Web Components. Framework-agnostic Generic Sensor API (AmbientLightSensor) monitor via wc-bindable-protocol.
- [@wcstack/audio](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/audio/README.md): Declarative Web Audio components for Web Components. A modular audio graph written as HTML, via wc-bindable-protocol.
- [@wcstack/broadcast](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/broadcast/README.md): Declarative cross-tab messaging component for Web Components. Framework-agnostic BroadcastChannel primitive via wc-bindable-protocol.
- [@wcstack/camera](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/camera/README.md): Declarative camera capture and media recording for Web Components. Binds live MediaStream handles directly to elements (never through serializable state) via getUserMedia + MediaRecorder.
- [@wcstack/clipboard](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/clipboard/README.md): Declarative clipboard component for Web Components. Framework-agnostic Clipboard API primitive via wc-bindable-protocol.
- [@wcstack/contacts](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/contacts/README.md): Declarative Contact Picker component for Web Components. Framework-agnostic navigator.contacts.select() wrapper via wc-bindable-protocol.
- [@wcstack/credential](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/credential/README.md): Declarative Credential Management component for Web Components. Framework-agnostic navigator.credentials get/store wrapper (password/federated only) via wc-bindable-protocol.
- [@wcstack/debounce](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/debounce/README.md): Declarative debounce/throttle components for Web Components. Framework-agnostic signal coalescing via wc-bindable-protocol.
- [@wcstack/defined](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/defined/README.md): Declarative custom-element readiness gate for Web Components. Waits on customElements.whenDefined with timeout-based load-failure detection via wc-bindable-protocol.
- [@wcstack/eyedropper](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/eyedropper/README.md): Declarative EyeDropper component for Web Components. Framework-agnostic EyeDropper.open() primitive via wc-bindable-protocol.
- [@wcstack/fetch](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/fetch/README.md): Declarative fetch component for Web Components. Framework-agnostic async data fetching via wc-bindable-protocol.
- [@wcstack/fullscreen](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/fullscreen/README.md): Declarative Fullscreen API component for Web Components. Framework-agnostic requestFullscreen()/exitFullscreen() control via wc-bindable-protocol.
- [@wcstack/geolocation](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/geolocation/README.md): Declarative geolocation component for Web Components. Framework-agnostic Geolocation API primitive via wc-bindable-protocol.
- [@wcstack/gyroscope](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/gyroscope/README.md): Declarative Gyroscope component for Web Components. Framework-agnostic Generic Sensor API (Gyroscope) monitor via wc-bindable-protocol.
- [@wcstack/idle](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/idle/README.md): Declarative Idle Detection component for Web Components. Framework-agnostic IdleDetector wrapper via wc-bindable-protocol.
- [@wcstack/intersection](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/intersection/README.md): Declarative IntersectionObserver component for Web Components. Framework-agnostic visibility primitive via wc-bindable-protocol.
- [@wcstack/magnetometer](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/magnetometer/README.md): Declarative Magnetometer component for Web Components. Framework-agnostic Generic Sensor API (Magnetometer) monitor via wc-bindable-protocol.
- [@wcstack/media-query](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/media-query/README.md): Declarative matchMedia component for Web Components. Framework-agnostic media-query monitor (prefers-color-scheme, prefers-reduced-motion, viewport width) via wc-bindable-protocol.
- [@wcstack/midi](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/midi/README.md): Declarative Web MIDI component for Web Components. Framework-agnostic MIDI input/output via wc-bindable-protocol.
- [@wcstack/network](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/network/README.md): Declarative Network Information component for Web Components. Framework-agnostic navigator.connection monitor via wc-bindable-protocol.
- [@wcstack/notification](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/notification/README.md): Declarative desktop-notification component for Web Components. Framework-agnostic Notifications API wrapper via wc-bindable-protocol, with Service Worker support.
- [@wcstack/permission](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/permission/README.md): Declarative permission-state component for Web Components. Framework-agnostic Permissions API monitor via wc-bindable-protocol.
- [@wcstack/picture-in-picture](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/picture-in-picture/README.md): Declarative Picture-in-Picture component for Web Components. Framework-agnostic <video> Picture-in-Picture control via wc-bindable-protocol.
- [@wcstack/pointer-lock](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/pointer-lock/README.md): Declarative Pointer Lock component for Web Components. Framework-agnostic Pointer Lock API control via wc-bindable-protocol.
- [@wcstack/raf](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/raf/README.md): Declarative requestAnimationFrame component for Web Components. Framework-agnostic frame-source primitive (tick/dt/suspended) via wc-bindable-protocol.
- [@wcstack/resize](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/resize/README.md): Declarative ResizeObserver component for Web Components. Framework-agnostic element-size primitive via wc-bindable-protocol.
- [@wcstack/screen-orientation](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/screen-orientation/README.md): Declarative Screen Orientation component for Web Components. Framework-agnostic screen.orientation monitor + lock/unlock commands via wc-bindable-protocol.
- [@wcstack/share](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/share/README.md): Declarative Web Share component for Web Components. Framework-agnostic navigator.share primitive via wc-bindable-protocol.
- [@wcstack/speech](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/speech/README.md): Declarative Web Speech components for Web Components. Framework-agnostic SpeechSynthesis (TTS) and SpeechRecognition (STT) primitives via wc-bindable-protocol.
- [@wcstack/sse](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/sse/README.md): Declarative Server-Sent Events (EventSource) component for Web Components. Framework-agnostic one-way streaming via wc-bindable-protocol.
- [@wcstack/storage](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/storage/README.md): Declarative persistent storage component for Web Components. Framework-agnostic localStorage/sessionStorage via wc-bindable-protocol.
- [@wcstack/tilt](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/tilt/README.md): Declarative Device Orientation component for Web Components. Framework-agnostic deviceorientation wrapper via wc-bindable-protocol.
- [@wcstack/timer](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/timer/README.md): Declarative timer component for Web Components. Framework-agnostic interval/timeout primitive via wc-bindable-protocol.
- [@wcstack/upload](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/upload/README.md): Declarative file upload component for Web Components. Framework-agnostic upload with progress tracking via wc-bindable-protocol.
- [@wcstack/view-transition](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/view-transition/README.md): Declarative View Transition arbiter for Web Components. Framework-agnostic policy tag that animates @wcstack/router route swaps and @wcstack/state list/branch updates via the transition-runner protocol.
- [@wcstack/wakelock](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/wakelock/README.md): Declarative Screen Wake Lock component for Web Components. Framework-agnostic, holds the screen awake while a bound state is true via wc-bindable-protocol.
- [@wcstack/websocket](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/websocket/README.md): Declarative WebSocket component for Web Components. Framework-agnostic real-time communication via wc-bindable-protocol.
- [@wcstack/worker](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/worker/README.md): Declarative Web Worker component for Web Components. Framework-agnostic Dedicated Worker primitive via wc-bindable-protocol.
## Tooling
- [@wcstack/devtools](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/devtools/README.md): In-page DevTools overlay for wcstack. Inspect state trees, bindings/wiring and update timelines via the DevTools Hook Protocol - one script tag, no build step.
- [@wcstack/autoloader](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/autoloader/README.md): Auto-detect and dynamically import undefined custom elements via Import Maps. Zero dependencies, buildless.
- [@wcstack/server](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/server/README.md): Server-side rendering for wcstack Web Components.
- [@wcstack/lint](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/lint/README.md): Static-contract validator CLI (wcs-validate) for wcstack data-wcs bindings and wcstack.manifest.json sidecars. Thin npm wrapper around the wcstack-intellisense validator core.
- [wcstack-intellisense](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/vscode-wcs/README.md): TypeScript language features for <wcs-state> inline scripts in HTML
- [@wcstack/typescript](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/typescript/README.md): TypeScript tooling for wcstack apps: wcs-schema generates the sidecar stateSchema from a typed state file, so wcs-validate checks data-wcs paths against real types in CI and every editor.
- [@wcstack/testing](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/packages/testing/README.md): Headless test helpers for wcstack pages: mount HTML under happy-dom, await bindings, read/write state, settle updates - the README recipe as one import.
## Examples
- [Multi-package demos](https://github.com/wcstack/wcstack/tree/v4.1.1/examples): router SPA, signals live search, camera/record/upload, cross-tab todo, and more
- [Per-package demos](https://github.com/wcstack/wcstack/tree/v4.1.1/packages): see each package's examples/ directory
## Optional
- [llms-full.txt](https://wcstack.github.io/llms-full.txt): complete authoring guide (workflow, full data-wcs syntax, I/O node catalog with timing notes, silent-failure matrix) in one file — use this when generating wcstack apps
- [wcstack-app skill](https://github.com/wcstack/wcstack-skill): the same content as an installable Claude Code Agent Skill (`/plugin marketplace add wcstack/wcstack-skill`)
- Validate generated HTML with `npx @wcstack/lint index.html` and iterate until exit code 0
- [AGENTS.md](https://raw.githubusercontent.com/wcstack/wcstack/v4.1.1/AGENTS.md): guidance for AI agents working inside the wcstack monorepo itself
- Japanese docs: every package also ships README.ja.md next to its README.md