eleven / ocho Public

apps: declare an app namespace; derive event types + CSS classes from it (rebase of #415) (#1057)

* apps: declare an app namespace; derive event types + CSS classes from it

Apps prefix the same string onto their event types ("todo.add", joined
with ".") and CSS classes ("todo-item", joined with "-"). That prefix was
written by hand in every file, so it drifted. Add a one-declaration helper,
`namespace(name)`, that derives both:

  const N = namespace("todo");
  N.ev("add")   // "todo.add"   — events-map keys, emits, e.type compares
  N.cls("item") // "todo-item"  — className / selector strings

- `defineApp` gains a `namespace` field (defaults to `name`, so it's fully
  opt-in and nothing changes for apps that ignore it) and exposes `app.ns`.
- The same resolver is on `ctx` as `ctx.ev` / `ctx.cls`, bound to the app.
- The wire strings are IDENTICAL — the helper only spells the existing
  namespaced type, so the cross-platform event-vector contract is untouched.
- Mirrored into the sandbox SDK (sandbox-frame.js + ALLOWED_IMPORTS + the
  Go validator) so member (user-built) apps get the identical helper.
- todo.js migrated as the worked reference; chat.js deliberately stays
  un-namespaced (it reuses the original feed's .msg/.bubble markup).
- Docs updated (mini-app guide, both authoring guides) + tests added.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013BQxpDPGm6aLeBty4icC83

* apps: migrate all built-in apps to the namespace helper; use it throughout the guides

Follow-up to the namespace helper: convert every built-in app to declare its
prefix once with `namespace(name)` and derive event types (N.ev) and CSS
classes (N.cls / ctx.cls) from it, and thread the helper through all the
authoring examples the guides give humans and LLMs.

Apps migrated: poll, remind, bookmarks, board, admin, connect, dnsimple,
setup, welcome, appstudio, chat (todo was the earlier reference).

Notable per-app decisions, all preserving byte-identical wire strings:
- bookmarks: event types are `bookmark.*` (singular) while the app name is
  "bookmarks" — declared `namespace("bookmark")` to match the wire prefix; its
  `bookmarks-` CSS classes stay literal (a single prefix can't spell both).
- dnsimple: event migrated; its `dns-` CSS classes stay literal (shorter than
  the name on purpose).
- chat: event types only (msg/react/edit/delete/typing incl. hostEvents keys);
  its CSS classes are the original feed's shared .msg/.bubble markup and are
  deliberately left untouched.
- admin/connect/appstudio: no owned event types (host-driven) — classes only
  where they match the name prefix; App Studio's STARTER template now teaches
  namespace/ctx.ev/ctx.cls.

Docs: the flagship complete-app examples and the emit/command/schedule/
messageAction snippets in web/static/apps/README.md, docs/building-apps.md
(/api/app-guide) and docs/building-member-apps.md (/api/member-app-guide) now
use the helper, with a Namespacing section in each.

Verified: npm test, event-vector contract, and go test ./... all pass; every
app node --checks; the App Studio STARTER still evaluates in the sandbox.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013BQxpDPGm6aLeBty4icC83

* apps: namespace todo/remind's hand-written glue; fix a rebase bug

todo.js and remind.js are schema-described (schemas/*.json), so their
`events` map keys already come from the schema — no drift there. But the
hand-written glue around a schema app (commands, chatMessage/preview/unread)
still compared against the wire type by hand ("todo.add" etc). Namespace
those too: `const N = namespace(schema.name)`, then N.ev("add") instead of
a second hardcoded "todo.add" — same pattern every other built-in app uses.

Also fixes a real bug this surfaced: the previous commit left todo.js
referencing N.ev(...) in preview()/unread() with no `namespace` import and
no `const N` — undefined at runtime, silently swallowed by appPreview's
try/catch (caught by npm test as a null return instead of the expected
preview string). Declaring N properly fixes it for real, rather than
reverting to the literal string as done previously.

Also corrects a test/apps.test.mjs assertion still pinned to the old
hand-written todo.js's 4 event types (missing todo.move, added to the
schema after this branch forked). Updates the README's namespacing note
now that todo.js/remind.js do use the helper, just only in their
hand-written glue.

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>