npm - anentrypoint-design - Versions diffs - 0.0.122 → 0.0.125 - Mend

anentrypoint-design 0.0.122 → 0.0.125

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.

Files changed (204) hide show

package/README.md +253 -253
package/app-shell.css +977 -594
package/colors_and_type.css +226 -226
package/community.css +933 -2255
package/dist/247420.css +2322 -3075
package/dist/247420.js +14 -14
package/package.json +80 -80
package/src/bootstrap.js +25 -25
package/src/components/chat.js +199 -199
package/src/components/community.js +190 -208
package/src/components/content.js +269 -269
package/src/components/editor-primitives.js +100 -0
package/src/components/files-modals.js +107 -107
package/src/components/files.js +118 -118
package/src/components/freddie/helpers.js +50 -50
package/src/components/freddie.js +33 -33
package/src/components/shell.js +117 -117
package/src/components/theme-toggle.js +70 -70
package/src/components.js +59 -67
package/src/debug.js +30 -30
package/src/deck-stage.js +21 -21
package/src/highlight.js +65 -32
package/src/index.js +86 -86
package/src/kits/os/about-app.js +52 -52
package/src/kits/os/app-panes.css +152 -152
package/src/kits/os/browser-app.js +58 -58
package/src/kits/os/files-app.js +44 -44
package/src/kits/os/freddie/helpers.js +59 -59
package/src/kits/os/freddie/pages-chat.js +143 -143
package/src/kits/os/freddie/pages-core.js +101 -101
package/src/kits/os/freddie/pages-os.js +51 -51
package/src/kits/os/freddie/pages-tools.js +183 -183
package/src/kits/os/freddie/routes.js +24 -24
package/src/kits/os/freddie-dashboard.css +51 -51
package/src/kits/os/freddie-dashboard.js +101 -101
package/src/kits/os/icons.js +17 -17
package/src/kits/os/index.js +17 -17
package/src/kits/os/launcher.css +61 -61
package/src/kits/os/launcher.js +79 -79
package/src/kits/os/monitor-app.js +34 -34
package/src/kits/os/shell.js +214 -214
package/src/kits/os/terminal-app.js +45 -45
package/src/kits/os/theme.css +450 -450
package/src/kits/os/validate.css +19 -19
package/src/kits/os/validator-app.js +55 -55
package/src/kits/os/wm.css +115 -115
package/src/kits/os/wm.js +111 -111
package/src/markdown.js +39 -39
package/src/motion.js +35 -35
package/src/page-html.js +196 -196
package/src/styles.js +25 -25
package/src/theme.js +99 -99
package/src/web-components/ds-chat.js +116 -116
package/dist/.nojekyll +0 -0
package/dist/app-shell.css +0 -594
package/dist/colors_and_type.css +0 -197
package/dist/favicon.svg +0 -1
package/dist/index.html +0 -308
package/dist/preview/buttons.html +0 -28
package/dist/preview/colors-core.html +0 -45
package/dist/preview/colors-lore.html +0 -28
package/dist/preview/colors-semantic.html +0 -34
package/dist/preview/dateline.html +0 -19
package/dist/preview/dropzone.html +0 -30
package/dist/preview/file-grid.html +0 -19
package/dist/preview/file-row.html +0 -20
package/dist/preview/file-toolbar.html +0 -40
package/dist/preview/file-viewer.html +0 -31
package/dist/preview/header.html +0 -24
package/dist/preview/icons-unicode.html +0 -26
package/dist/preview/index-row.html +0 -25
package/dist/preview/inputs.html +0 -22
package/dist/preview/manifesto.html +0 -52
package/dist/preview/motion-default.js +0 -106
package/dist/preview/rules.html +0 -16
package/dist/preview/spacing.html +0 -18
package/dist/preview/stamps-lore.html +0 -20
package/dist/preview/stamps.html +0 -14
package/dist/preview/theme-ink.html +0 -15
package/dist/preview/type-display.html +0 -16
package/dist/preview/type-mono.html +0 -15
package/dist/preview/type-prose.html +0 -11
package/dist/preview/type-scale.html +0 -20
package/dist/preview/wordmarks.html +0 -28
package/dist/robots.txt +0 -8
package/dist/site/content/globals/navigation.yaml +0 -5
package/dist/site/content/globals/site.yaml +0 -16
package/dist/site/content/pages/freddie.yaml +0 -88
package/dist/site/content/pages/home.yaml +0 -190
package/dist/site/theme.mjs +0 -368
package/dist/sitemap.xml +0 -31
package/dist/slides/deck-stage-overlay.js +0 -63
package/dist/slides/deck-stage-state.js +0 -81
package/dist/slides/deck-stage-style.js +0 -117
package/dist/slides/deck-stage.js +0 -159
package/dist/slides/index.html +0 -276
package/dist/src/bootstrap.js +0 -25
package/dist/src/components/chat.js +0 -199
package/dist/src/components/community.js +0 -167
package/dist/src/components/content.js +0 -213
package/dist/src/components/files-modals.js +0 -107
package/dist/src/components/files.js +0 -118
package/dist/src/components/freddie/helpers.js +0 -50
package/dist/src/components/freddie.js +0 -33
package/dist/src/components/shell.js +0 -117
package/dist/src/components/theme-toggle.js +0 -70
package/dist/src/components.js +0 -52
package/dist/src/debug.js +0 -30
package/dist/src/deck-stage.js +0 -21
package/dist/src/highlight.js +0 -32
package/dist/src/index.js +0 -86
package/dist/src/kits/os/about-app.js +0 -52
package/dist/src/kits/os/app-panes.css +0 -152
package/dist/src/kits/os/browser-app.js +0 -58
package/dist/src/kits/os/files-app.js +0 -44
package/dist/src/kits/os/freddie/helpers.js +0 -59
package/dist/src/kits/os/freddie/pages-chat.js +0 -143
package/dist/src/kits/os/freddie/pages-core.js +0 -101
package/dist/src/kits/os/freddie/pages-os.js +0 -51
package/dist/src/kits/os/freddie/pages-tools.js +0 -183
package/dist/src/kits/os/freddie/routes.js +0 -24
package/dist/src/kits/os/freddie-dashboard.css +0 -51
package/dist/src/kits/os/freddie-dashboard.js +0 -101
package/dist/src/kits/os/icons.js +0 -17
package/dist/src/kits/os/index.js +0 -5
package/dist/src/kits/os/launcher.css +0 -61
package/dist/src/kits/os/launcher.js +0 -79
package/dist/src/kits/os/monitor-app.js +0 -34
package/dist/src/kits/os/shell.js +0 -214
package/dist/src/kits/os/terminal-app.js +0 -45
package/dist/src/kits/os/theme.css +0 -412
package/dist/src/kits/os/validate.css +0 -19
package/dist/src/kits/os/validator-app.js +0 -55
package/dist/src/kits/os/wm.css +0 -115
package/dist/src/kits/os/wm.js +0 -111
package/dist/src/markdown.js +0 -39
package/dist/src/motion.js +0 -35
package/dist/src/page-html.js +0 -196
package/dist/src/styles.js +0 -25
package/dist/src/theme.js +0 -99
package/dist/src/web-components/ds-chat.js +0 -45
package/dist/ui_kits/aicat/README.md +0 -7
package/dist/ui_kits/aicat/app.js +0 -156
package/dist/ui_kits/aicat/index.html +0 -26
package/dist/ui_kits/aicat/sample-square.png +0 -0
package/dist/ui_kits/aicat/sample-svg.svg +0 -1
package/dist/ui_kits/aicat/sample.pdf +0 -32
package/dist/ui_kits/blog/README.md +0 -3
package/dist/ui_kits/blog/index.html +0 -90
package/dist/ui_kits/chat/README.md +0 -5
package/dist/ui_kits/chat/app.js +0 -110
package/dist/ui_kits/chat/index.html +0 -26
package/dist/ui_kits/chat/sample-square.png +0 -0
package/dist/ui_kits/chat/sample-svg.svg +0 -1
package/dist/ui_kits/chat/sample.pdf +0 -32
package/dist/ui_kits/community/app.js +0 -134
package/dist/ui_kits/community/index.html +0 -24
package/dist/ui_kits/dashboard/app.js +0 -92
package/dist/ui_kits/dashboard/index.html +0 -26
package/dist/ui_kits/docs/README.md +0 -3
package/dist/ui_kits/docs/index.html +0 -123
package/dist/ui_kits/error_404/app.js +0 -56
package/dist/ui_kits/error_404/index.html +0 -26
package/dist/ui_kits/file_browser/README.md +0 -48
package/dist/ui_kits/file_browser/app.js +0 -231
package/dist/ui_kits/file_browser/index.html +0 -33
package/dist/ui_kits/gallery/app.js +0 -121
package/dist/ui_kits/gallery/index.html +0 -26
package/dist/ui_kits/homepage/README.md +0 -7
package/dist/ui_kits/homepage/app.js +0 -167
package/dist/ui_kits/homepage/index.html +0 -46
package/dist/ui_kits/project_page/README.md +0 -3
package/dist/ui_kits/project_page/app.js +0 -154
package/dist/ui_kits/project_page/index.html +0 -45
package/dist/ui_kits/search/app.js +0 -107
package/dist/ui_kits/search/index.html +0 -26
package/dist/ui_kits/settings/app.js +0 -133
package/dist/ui_kits/settings/index.html +0 -26
package/dist/ui_kits/signin/app.js +0 -115
package/dist/ui_kits/signin/index.html +0 -26
package/dist/ui_kits/slide_deck/app.js +0 -174
package/dist/ui_kits/slide_deck/index.html +0 -26
package/dist/ui_kits/system_primer/app.js +0 -152
package/dist/ui_kits/system_primer/index.html +0 -26
package/dist/ui_kits/terminal/app.js +0 -150
package/dist/ui_kits/terminal/index.html +0 -26
package/dist/vendor/webjsx/applyDiff.js +0 -182
package/dist/vendor/webjsx/attributes.js +0 -154
package/dist/vendor/webjsx/constants.js +0 -4
package/dist/vendor/webjsx/createDOMElement.js +0 -52
package/dist/vendor/webjsx/createElement.js +0 -75
package/dist/vendor/webjsx/elementTags.js +0 -115
package/dist/vendor/webjsx/factory.js +0 -6
package/dist/vendor/webjsx/index.js +0 -6
package/dist/vendor/webjsx/jsx-dev-runtime.js +0 -2
package/dist/vendor/webjsx/jsx-runtime.js +0 -30
package/dist/vendor/webjsx/jsx.js +0 -2
package/dist/vendor/webjsx/package.json +0 -39
package/dist/vendor/webjsx/renderSuspension.js +0 -25
package/dist/vendor/webjsx/types.js +0 -5
package/dist/vendor/webjsx/utils.js +0 -84
package/src/components/overlays.js +0 -151
package/src/components/surfaces.js +0 -399
package/src/components/voice.js +0 -132

package/README.md CHANGED Viewed

@@ -1,253 +1,253 @@
-# 247420
-The 247420 / AnEntrypoint design system, packaged as a single-file ESM SDK.
-friendly rounded sans body, monospace only on real code, tonal surfaces over borders, indicator rails for color-coded separation, generous negative space, terminal-flavoured rhythm.
-we fart in its general direction. ◰
-## install (the only step)
-You have two choices. Both are one line.
-**npm** (when you already have a bundler):
-```bash
-npm install anentrypoint-design
-```
-**unpkg** (when you don't, and you don't want one):
-```html
-<link rel="stylesheet" href="https://unpkg.com/anentrypoint-design@latest/dist/247420.css">
-<script type="importmap">
-  { "imports": { "anentrypoint-design": "https://unpkg.com/anentrypoint-design@latest/dist/247420.js" } }
-</script>
-```
-Add the scope class on a wrapping element and you are done:
-```html
-<html class="ds-247420" data-theme="light">
-  <body><div id="app"></div></body>
-</html>
-```
-## use it (3-line app)
-```js
-import { mount, components as C } from 'anentrypoint-design';
-mount(document.getElementById('app'), () => C.AppShell({
-  topbar: C.Topbar({ brand: '247420', leaf: 'gm', items: [['works','#/works']] }),
-  main:   C.HomeView({ /* hero, features, examples — see ./site/content/pages/home.yaml */ }),
-  status: C.Status({ left: ['main'], right: ['live'] })
-}));
-```
-`mount` automatically adds `.ds-247420` to your root.
-## what's in the box
-- **chrome** — `Topbar`, `Crumb`, `Side`, `Status`, `AppShell`, `Brand`, `Chip`, `Btn`, `Glyph`, `Heading`, `Lede`
-- **content** — `Panel`, `Row`, `RowLink`, `Hero`, `Install`, `Receipt`, `Changelog`, `WorksList`, `WritingList`, `Manifesto`, `Section`, `Kpi`, `Table`, `HomeView`, `ProjectView`
-- **chat** — `Chat`, `ChatMessage`, `ChatComposer`, `AICat`, `AICatPortrait`
-- **file browser** — `FileRow`, `FileGrid`, `FileToolbar`, `FileIcon`, `DropZone`, `UploadProgress`, `EmptyState`, `BreadcrumbPath`, plus modal pieces `FileViewer`, `FilePreviewMedia`, `FilePreviewCode`, `FilePreviewText`, `ConfirmDialog`, `PromptDialog`
-- **ui_kits** — `homepage`, `project_page`, `docs`, `blog`, `chat`, `aicat`, `file_browser`. Each is a fully-working buildless example loading the SDK from this repo.
-The file-browser surface (rails by file type, drop-zone upload, modal preview) ships its canonical real-world wiring at [`fsbrowse`](https://github.com/AnEntrypoint/fsbrowse) — Express + busboy backend, the SDK frontend.
-## use it from a buildless flatspace project
-A canonical example lives at `c:\dev\flatspace-demo`. It has **no `package.json`**. It has a `flatspace.config.mjs`, YAML pages under `config/`, and a `src/theme.mjs` that turns each page into HTML at build-time. CI runs `npx --yes flatspace@latest build` and deploys `dist/`.
-To plug 247420 into that shape, do exactly three things:
-### 1. Reference the SDK from `<head>` in `src/theme.mjs`
-```js
-export default function render({ site, page }) {
-  return `<!doctype html>
-<html lang="en" class="ds-247420" data-theme="light">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>${page.title} — ${site.title}</title>
-  <link rel="stylesheet" href="https://unpkg.com/anentrypoint-design@latest/dist/247420.css">
-  <script type="importmap">
-    { "imports": { "anentrypoint-design": "https://unpkg.com/anentrypoint-design@latest/dist/247420.js" } }
-  </script>
-</head>
-<body>
-  <div id="app"></div>
-  <script type="module">
-    import { mount, components as C } from 'anentrypoint-design';
-    const data = ${JSON.stringify({ site, page })};
-    mount(document.getElementById('app'), () => C.AppShell({
-      topbar: C.Topbar({ brand: data.site.title, items: data.site.nav }),
-      crumb:  C.Crumb({ leaf: data.page.title }),
-      main:   data.page.template === 'home' ? C.HomeView(data.page) : C.Section(data.page),
-      status: C.Status({ left: ['main'], right: ['live'] }),
-    }));
-  </script>
-</body>
-</html>`;
-}
-```
-### 2. Author pages in YAML
-```yaml
-# config/pages/home.yaml
-id: home
-title: home
-template: home
-hero:
-  heading: tigers
-  subheading: large striped cats
-  body: a flatspace site, styled by 247420.
-  badges: [ { label: encyclopedic }, { label: lowercase }, { label: 100% YAML } ]
-features:
-  heading: why tigers
-  items:
-    - { name: stripes, desc: structurally redundant, semiotically loud. }
-    - { name: silence, desc: we like ambush as a design pattern. }
-examples:
-  heading: pages
-  items:
-    - { name: about,   href: ./about.html,   cta: open }
-    - { name: species, href: ./species.html, cta: open }
-```
-### 3. CI workflow (`.github/workflows/build.yml`)
-```yaml
-name: Deploy
-on: { push: { branches: [main] }, workflow_dispatch: }
-permissions: { contents: read, pages: write, id-token: write }
-concurrency: { group: pages, cancel-in-progress: false }
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with: { node-version: '20' }
-      - run: npx --yes flatspace@latest build
-      - uses: actions/configure-pages@v5
-      - uses: actions/upload-pages-artifact@v3
-        with: { path: ./dist }
-  deploy:
-    needs: build
-    runs-on: ubuntu-latest
-    environment: { name: github-pages, url: ${{ steps.deployment.outputs.page_url }} }
-    steps:
-      - id: deployment
-        uses: actions/deploy-pages@v4
-```
-That is the whole integration. No `package.json`, no install, no bundler, no copy step. Push a YAML change to `main`, GH Actions builds, GH Pages serves.
-## components
-Primitives: `Brand`, `Chip`, `Btn`, `Glyph`, `Heading`, `Lede`, `Dot`, `Rail`.
-Chrome: `Topbar`, `Crumb`, `Side`, `Status`, `AppShell`.
-Surfaces: `Panel`, `Row`, `RowLink`, `Section`, `Install`, `Receipt`, `Changelog`.
-Pages: `Hero`, `WorksList`, `WritingList`, `Manifesto`, `HomeView`, `ProjectView`.
-Chat: `Chat`, `ChatMessage`, `ChatComposer`, `AICat`, `AICatPortrait`. Helpers: `renderInline`, `fmtBytes`.
-Files: `FileIcon`, `FileRow`, `FileGrid`, `FileToolbar`, `DropZone`, `UploadProgress`, `EmptyState`, `BreadcrumbPath`, `FileViewer` (+ `ConfirmDialog` / `PromptDialog` / `FilePreviewMedia` / `FilePreviewCode` / `FilePreviewText`). Helpers: `fileGlyph`, `fmtFileSize`.
-All factories are pure: props in, WebJSX tree out. Component source is split per group under `src/components/<shell|content|chat>.js`; `src/components.js` is a re-export barrel. The 200-line cap applies per module.
-## chat / markdown / code-highlight
-`Chat({ messages, onSend })` renders the bubble timeline; `ChatComposer({ onSend })` is the input row. Block markdown inside messages is sanitized through `renderMarkdown` (`marked@15` + `DOMPurify@3`, lazy-loaded from jsDelivr ESM on first call) and code blocks are highlighted by Prism (lazy-loaded core + per-language scripts via `ensurePrism` / `highlightAllUnder`). Direct `innerHTML` from chat content is forbidden — DOMPurify is the only XSS gate.
-```js
-import { components as C } from 'anentrypoint-design';
-C.Chat({
-  messages: [
-    { role: 'user', text: 'hello' },
-    { role: 'assistant', text: '```js\nconsole.log(1)\n```' }
-  ],
-  onSend: text => /* push to your store, re-render */ null
-});
-```
-## `<ds-chat>` web component
-`src/index.js` auto-registers `<ds-chat>` in any browser context. Set `el.messages = [...]` (or pass JSON via the `messages` attribute) and listen for the bubbling, composed `send` event:
-```html
-<ds-chat id="c"></ds-chat>
-<script type="module">
-  import 'https://unpkg.com/anentrypoint-design@latest/dist/247420.js';
-  const el = document.getElementById('c');
-  el.messages = [{ role: 'assistant', text: 'gm.' }];
-  el.addEventListener('send', e => console.log(e.detail.text));
-</script>
-```
-## ui-kit bootstrap
-`mountKit({ root, view, screen })` is the single entry point every kit uses — it installs styles, scopes the root, runs the WebJSX render loop, and registers the kit on the `window.__debug` registry. Do not roll your own motion / applyDiff / CDN loop in a kit's `app.js`.
-```js
-import { mountKit } from 'anentrypoint-design';
-mountKit({ root: document.getElementById('app'), view: () => myView(), screen: 'aicat' });
-```
-## DeckStage
-```js
-import { registerDeckStage } from 'anentrypoint-design';
-await registerDeckStage();
-// <deck-stage width="1920" height="1080">…<section>…</section></deck-stage>
-```
-## tokens (override anywhere)
-The system runs entirely on CSS custom properties under `.ds-247420`. To rebrand a single surface, declare overrides at any level:
-```html
-<div class="ds-247420" style="
-  --panel-accent: #6FA9FF;
-  --panel-select: #DCE8FF;
-  --green: #6FA9FF;
-">
-  …same components, sky-blue accent…
-</div>
-```
-The full token list lives in `colors_and_type.css`. The voice rules and the storytelling pass live in `SKILL.md`.
-## why scope-prefixed
-Every selector in the bundle is namespaced under `.ds-247420` via PostCSS. The bundle ships Nunito + Archivo + JetBrains Mono + the design tokens **without** colliding with whatever the host app already runs. Add the class to a root element to opt in.
-## CSS only (no JS)
-```html
-<link rel="stylesheet" href="https://unpkg.com/anentrypoint-design@latest/dist/247420.css">
-<div class="ds-247420">…</div>
-```
-You get the tokens, primitives, and utility classes. You write the markup.
-## publishing
-Every push to `main` runs `.github/workflows/publish.yml`:
-1. Resolves max(local, remote) version, bumps **patch**.
-2. Builds with `scripts/build.mjs` (esbuild + postcss-prefix-selector).
-3. Publishes to npm with `NPM_TOKEN`.
-4. Commits the bump back to `main` and pushes a `vX.Y.Z` tag.
-Skip publish for any commit by including `[skip publish]` in the message; release commits use that automatically to prevent loops.
-## links
-- live: <https://anentrypoint.github.io/design/>
-- npm: <https://www.npmjs.com/package/anentrypoint-design>
-- skill: see `SKILL.md` for the full visual paradigm and storytelling rules.
+# 247420
+The 247420 / AnEntrypoint design system, packaged as a single-file ESM SDK.
+friendly rounded sans body, monospace only on real code, tonal surfaces over borders, indicator rails for color-coded separation, generous negative space, terminal-flavoured rhythm.
+we fart in its general direction. ◰
+## install (the only step)
+You have two choices. Both are one line.
+**npm** (when you already have a bundler):
+```bash
+npm install anentrypoint-design
+```
+**unpkg** (when you don't, and you don't want one):
+```html
+<link rel="stylesheet" href="https://unpkg.com/anentrypoint-design@latest/dist/247420.css">
+<script type="importmap">
+  { "imports": { "anentrypoint-design": "https://unpkg.com/anentrypoint-design@latest/dist/247420.js" } }
+</script>
+```
+Add the scope class on a wrapping element and you are done:
+```html
+<html class="ds-247420" data-theme="light">
+  <body><div id="app"></div></body>
+</html>
+```
+## use it (3-line app)
+```js
+import { mount, components as C } from 'anentrypoint-design';
+mount(document.getElementById('app'), () => C.AppShell({
+  topbar: C.Topbar({ brand: '247420', leaf: 'gm', items: [['works','#/works']] }),
+  main:   C.HomeView({ /* hero, features, examples — see ./site/content/pages/home.yaml */ }),
+  status: C.Status({ left: ['main'], right: ['live'] })
+}));
+```
+`mount` automatically adds `.ds-247420` to your root.
+## what's in the box
+- **chrome** — `Topbar`, `Crumb`, `Side`, `Status`, `AppShell`, `Brand`, `Chip`, `Btn`, `Glyph`, `Heading`, `Lede`
+- **content** — `Panel`, `Row`, `RowLink`, `Hero`, `Install`, `Receipt`, `Changelog`, `WorksList`, `WritingList`, `Manifesto`, `Section`, `Kpi`, `Table`, `HomeView`, `ProjectView`
+- **chat** — `Chat`, `ChatMessage`, `ChatComposer`, `AICat`, `AICatPortrait`
+- **file browser** — `FileRow`, `FileGrid`, `FileToolbar`, `FileIcon`, `DropZone`, `UploadProgress`, `EmptyState`, `BreadcrumbPath`, plus modal pieces `FileViewer`, `FilePreviewMedia`, `FilePreviewCode`, `FilePreviewText`, `ConfirmDialog`, `PromptDialog`
+- **ui_kits** — `homepage`, `project_page`, `docs`, `blog`, `chat`, `aicat`, `file_browser`. Each is a fully-working buildless example loading the SDK from this repo.
+The file-browser surface (rails by file type, drop-zone upload, modal preview) ships its canonical real-world wiring at [`fsbrowse`](https://github.com/AnEntrypoint/fsbrowse) — Express + busboy backend, the SDK frontend.
+## use it from a buildless flatspace project
+A canonical example lives at `c:\dev\flatspace-demo`. It has **no `package.json`**. It has a `flatspace.config.mjs`, YAML pages under `config/`, and a `src/theme.mjs` that turns each page into HTML at build-time. CI runs `npx --yes flatspace@latest build` and deploys `dist/`.
+To plug 247420 into that shape, do exactly three things:
+### 1. Reference the SDK from `<head>` in `src/theme.mjs`
+```js
+export default function render({ site, page }) {
+  return `<!doctype html>
+<html lang="en" class="ds-247420" data-theme="light">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${page.title} — ${site.title}</title>
+  <link rel="stylesheet" href="https://unpkg.com/anentrypoint-design@latest/dist/247420.css">
+  <script type="importmap">
+    { "imports": { "anentrypoint-design": "https://unpkg.com/anentrypoint-design@latest/dist/247420.js" } }
+  </script>
+</head>
+<body>
+  <div id="app"></div>
+  <script type="module">
+    import { mount, components as C } from 'anentrypoint-design';
+    const data = ${JSON.stringify({ site, page })};
+    mount(document.getElementById('app'), () => C.AppShell({
+      topbar: C.Topbar({ brand: data.site.title, items: data.site.nav }),
+      crumb:  C.Crumb({ leaf: data.page.title }),
+      main:   data.page.template === 'home' ? C.HomeView(data.page) : C.Section(data.page),
+      status: C.Status({ left: ['main'], right: ['live'] }),
+    }));
+  </script>
+</body>
+</html>`;
+}
+```
+### 2. Author pages in YAML
+```yaml
+# config/pages/home.yaml
+id: home
+title: home
+template: home
+hero:
+  heading: tigers
+  subheading: large striped cats
+  body: a flatspace site, styled by 247420.
+  badges: [ { label: encyclopedic }, { label: lowercase }, { label: 100% YAML } ]
+features:
+  heading: why tigers
+  items:
+    - { name: stripes, desc: structurally redundant, semiotically loud. }
+    - { name: silence, desc: we like ambush as a design pattern. }
+examples:
+  heading: pages
+  items:
+    - { name: about,   href: ./about.html,   cta: open }
+    - { name: species, href: ./species.html, cta: open }
+```
+### 3. CI workflow (`.github/workflows/build.yml`)
+```yaml
+name: Deploy
+on: { push: { branches: [main] }, workflow_dispatch: }
+permissions: { contents: read, pages: write, id-token: write }
+concurrency: { group: pages, cancel-in-progress: false }
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: '20' }
+      - run: npx --yes flatspace@latest build
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v3
+        with: { path: ./dist }
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: { name: github-pages, url: ${{ steps.deployment.outputs.page_url }} }
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4
+```
+That is the whole integration. No `package.json`, no install, no bundler, no copy step. Push a YAML change to `main`, GH Actions builds, GH Pages serves.
+## components
+Primitives: `Brand`, `Chip`, `Btn`, `Glyph`, `Heading`, `Lede`, `Dot`, `Rail`.
+Chrome: `Topbar`, `Crumb`, `Side`, `Status`, `AppShell`.
+Surfaces: `Panel`, `Row`, `RowLink`, `Section`, `Install`, `Receipt`, `Changelog`.
+Pages: `Hero`, `WorksList`, `WritingList`, `Manifesto`, `HomeView`, `ProjectView`.
+Chat: `Chat`, `ChatMessage`, `ChatComposer`, `AICat`, `AICatPortrait`. Helpers: `renderInline`, `fmtBytes`.
+Files: `FileIcon`, `FileRow`, `FileGrid`, `FileToolbar`, `DropZone`, `UploadProgress`, `EmptyState`, `BreadcrumbPath`, `FileViewer` (+ `ConfirmDialog` / `PromptDialog` / `FilePreviewMedia` / `FilePreviewCode` / `FilePreviewText`). Helpers: `fileGlyph`, `fmtFileSize`.
+All factories are pure: props in, WebJSX tree out. Component source is split per group under `src/components/<shell|content|chat>.js`; `src/components.js` is a re-export barrel. The 200-line cap applies per module.
+## chat / markdown / code-highlight
+`Chat({ messages, onSend })` renders the bubble timeline; `ChatComposer({ onSend })` is the input row. Block markdown inside messages is sanitized through `renderMarkdown` (`marked@15` + `DOMPurify@3`, lazy-loaded from jsDelivr ESM on first call) and code blocks are highlighted by Prism (lazy-loaded core + per-language scripts via `ensurePrism` / `highlightAllUnder`). Direct `innerHTML` from chat content is forbidden — DOMPurify is the only XSS gate.
+```js
+import { components as C } from 'anentrypoint-design';
+C.Chat({
+  messages: [
+    { role: 'user', text: 'hello' },
+    { role: 'assistant', text: '```js\nconsole.log(1)\n```' }
+  ],
+  onSend: text => /* push to your store, re-render */ null
+});
+```
+## `<ds-chat>` web component
+`src/index.js` auto-registers `<ds-chat>` in any browser context. Set `el.messages = [...]` (or pass JSON via the `messages` attribute) and listen for the bubbling, composed `send` event:
+```html
+<ds-chat id="c"></ds-chat>
+<script type="module">
+  import 'https://unpkg.com/anentrypoint-design@latest/dist/247420.js';
+  const el = document.getElementById('c');
+  el.messages = [{ role: 'assistant', text: 'gm.' }];
+  el.addEventListener('send', e => console.log(e.detail.text));
+</script>
+```
+## ui-kit bootstrap
+`mountKit({ root, view, screen })` is the single entry point every kit uses — it installs styles, scopes the root, runs the WebJSX render loop, and registers the kit on the `window.__debug` registry. Do not roll your own motion / applyDiff / CDN loop in a kit's `app.js`.
+```js
+import { mountKit } from 'anentrypoint-design';
+mountKit({ root: document.getElementById('app'), view: () => myView(), screen: 'aicat' });
+```
+## DeckStage
+```js
+import { registerDeckStage } from 'anentrypoint-design';
+await registerDeckStage();
+// <deck-stage width="1920" height="1080">…<section>…</section></deck-stage>
+```
+## tokens (override anywhere)
+The system runs entirely on CSS custom properties under `.ds-247420`. To rebrand a single surface, declare overrides at any level:
+```html
+<div class="ds-247420" style="
+  --panel-accent: #6FA9FF;
+  --panel-select: #DCE8FF;
+  --green: #6FA9FF;
+">
+  …same components, sky-blue accent…
+</div>
+```
+The full token list lives in `colors_and_type.css`. The voice rules and the storytelling pass live in `SKILL.md`.
+## why scope-prefixed
+Every selector in the bundle is namespaced under `.ds-247420` via PostCSS. The bundle ships Nunito + Archivo + JetBrains Mono + the design tokens **without** colliding with whatever the host app already runs. Add the class to a root element to opt in.
+## CSS only (no JS)
+```html
+<link rel="stylesheet" href="https://unpkg.com/anentrypoint-design@latest/dist/247420.css">
+<div class="ds-247420">…</div>
+```
+You get the tokens, primitives, and utility classes. You write the markup.
+## publishing
+Every push to `main` runs `.github/workflows/publish.yml`:
+1. Resolves max(local, remote) version, bumps **patch**.
+2. Builds with `scripts/build.mjs` (esbuild + postcss-prefix-selector).
+3. Publishes to npm with `NPM_TOKEN`.
+4. Commits the bump back to `main` and pushes a `vX.Y.Z` tag.
+Skip publish for any commit by including `[skip publish]` in the message; release commits use that automatically to prevent loops.
+## links
+- live: <https://anentrypoint.github.io/design/>
+- npm: <https://www.npmjs.com/package/anentrypoint-design>
+- skill: see `SKILL.md` for the full visual paradigm and storytelling rules.