Files
orca/examples/plugins/hello-tsx/src/todos.ts
T
Neil b17d408416 Plugin dev loop: TS workers, hot reload with state, orca plugin dev watch, authoring skill (#36982)
* feat(plugins): build-less TypeScript workers

A worker's main may be .ts/.mts. The plugin host installs module.registerHooks scoped to the
plugin folder: .ts files are transpiled with the frames' sucrase options (lines kept, inline
source map, source maps on), relative imports fall back to the frames' candidate files, and a
value import of the type-only 'orca/worker' fails with a clear error. Needs engines.orca
>=1.4.246.

* feat(plugins): components panels hot reload with their state

- In dev folders a save swaps only the hidden guest: keyed memory atoms are handed to the new
  guest (ui.retain → ui.hydrate memory), dropped when an atom's version changes.
- A save that fails to load keeps the last good render and shows an inline file:line:col
  error banner; the next good save clears it. A subtle Reloaded mark follows a reload.
- Transpile and import errors carry line and column; dev worker restarts keep storage.

* feat(plugins): orca plugin dev watch

One command for the inner loop: refreshes .orca/types, dev-loads the folder, follows its frame
and worker logs (plugins.getLogs gains an optional cursor), prints reloads (optional
devChangeCount on list entries) and status changes, and unloads on Ctrl-C. --json streams
NDJSON events for agents.

* feat(skills): orca-plugin-authoring bundled skill guide

A guide for agents to build Orca plugins end to end (decision table, build-less rules, the
dev watch loop, test/check, validate, release-entry, approvals, gotchas) with references
generated from the component catalog, host API table, event schemas, manifest schema and CLI
specs, checked for drift. Fixes the components template's Reset to set(count, 0).

* feat(plugins): orca plugin dev watch --check; test kit details in the authoring skill

- --check runs orca plugin check after the load and after each reload (one at a time; saves
  made meanwhile fold into one rerun) and prints each panel's render or errors inline, as a
  `check` event with --json. Local folders only, since it runs the plugin's code here.
- The orca-plugin-authoring guide's Test and check section now documents orca plugin test and
  check from #36969 exactly (JSON results, exit codes, test placement, the orca/testing kit and
  its common mistakes), and the loop uses dev watch --check.

* refactor(plugins): move the components renderer's timing and helper constants to their own module
2026-11-01 03:32:25 -08:00

43 lines
1.3 KiB
TypeScript

import { atom, derived, read, set, update } from 'orca'
export type Todo = { id: number; title: string; done: boolean }
// Keyed and persisted: the list survives closing the panel and restarting Orca.
export const todos = atom<Todo[]>(
'todos',
[
{ id: 1, title: 'Read the components guide', done: true },
{ id: 2, title: 'Edit src/panel.tsx and save', done: false }
],
{ persist: 'plugin' }
)
// Keyed, in memory: a save in a development folder hot reloads the panel and keeps the draft.
export const draft = atom('draft', '')
export const openCount = derived(() => read(todos).filter((todo) => !todo.done).length)
export const percentDone = derived(() => {
const list = read(todos)
return list.length === 0 ? 100 : Math.round((100 * (list.length - read(openCount))) / list.length)
})
export function add(): void {
const title = read(draft).trim()
if (!title) {
return
}
update(todos, (list) => [
...list,
{ id: Math.max(0, ...list.map((todo) => todo.id)) + 1, title, done: false }
])
set(draft, '')
}
export function toggle(id: number): void {
update(todos, (list) =>
list.map((todo) => (todo.id === id ? { ...todo, done: !todo.done } : todo))
)
}
export function clearDone(): void {
update(todos, (list) => list.filter((todo) => !todo.done))
}