@telepath-computer/television 0.1.128 → 0.1.142

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.
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: television-theme
2
+ name: tv-theme
3
3
  description: Author a Television theme — capture intent as a skill, render to <storagePath>/themes/<name>/theme.css. The skill survives Television token-surface changes across releases.
4
4
  ---
5
5
 
@@ -40,7 +40,7 @@ Television is a single-screen-at-a-time display for AI-generated artifacts. The
40
40
 
41
41
  - **The app shell.** A single window that always shows one active screen. There's no home page; the active screen is the page.
42
42
  - **`<screen-select>`** — a top-edge or corner control listing available screens; lets the user switch.
43
- - **`<command-panel>`** — persistent chrome that floats over content (bottom or corner). Hosts global commands and the chat input + message stream. Uses paper material in dark tone by default.
43
+ - **`<command-panel>`** — persistent chrome that floats over content (bottom or corner). Hosts global commands and command panel input/content. Uses paper material in dark tone by default.
44
44
  - **`<screen-view>` → `<layout-view>`** — page container holding the scrollable canvas where artifact cards live.
45
45
  - **`<artifact-view>`** — each artifact card. Glass-material title bar wrapping a paper-material content surface (the artifact's rendered HTML, in an iframe).
46
46
  - **Popovers, dropdowns, modals** — paper-material panels for transient and modal UI.
@@ -117,7 +117,7 @@ cat <television-checkout>/packages/ui/styles/tokens.css <television-checkout>/pa
117
117
  Themes have two complementary tools:
118
118
 
119
119
  - **Override semantic tokens on `:root`** when you want a change to propagate everywhere it's relevant — every paper surface, every body text, every focus ring. One token edit, system-wide effect. Use this for the look's foundations: backgrounds, foregrounds, primary accents, border weights.
120
- - **Override specific selectors** when the intent is local to a surface — the chat input gets a special background, the artifact title bar uses a custom font, the layout canvas gets a subtle background image. Selectors give surgical control; tokens can't always express what a design wants.
120
+ - **Override specific selectors** when the intent is local to a surface — the command panel input gets a special background, the artifact title bar uses a custom font, the layout canvas gets a subtle background image. Selectors give surgical control; tokens can't always express what a design wants.
121
121
 
122
122
  Both are first-class. A typical theme uses tokens for ~80% of its effect and selector-level rules for the rest. Don't avoid selectors out of orthodoxy; use them where they fit.
123
123
 
@@ -138,7 +138,7 @@ Theme levers:
138
138
 
139
139
  - Want a flat colored background? `:root { --app-wallpaper: none; }` and override `--color-bg` (or `--app-bg` directly for finer control).
140
140
  - Want a custom wallpaper? `:root { --app-wallpaper: url(my-bg.jpg); }` where `my-bg.jpg` is in the theme's `resources/` folder (the server will rewrite the relative URL).
141
- - The default-look bundled wallpaper is `packages/web/src/assets/wallpaper-s.jpg` — themes don't import or reference it; they replace the variable.
141
+ - The default-look bundled wallpaper is `packages/web/src/assets/wallpapers/clouds.jpg` — themes don't import or reference it; they replace the variable.
142
142
 
143
143
  ### Buttons
144
144
 
@@ -147,7 +147,7 @@ Television has three button stories: variant-styled buttons, ghost buttons (chro
147
147
  What each consumes:
148
148
 
149
149
  - **Default `<button>`** — `--color-text` (text), `--color-interactive` (resting bg), `--color-interactive-hover` (hover bg), `--control-height-md` (28px outer height), `--shadow-control` (subtle drop shadow on resting state).
150
- - **`<button variant="ghost">`** — fully chromeless, no fill. Hover/active backgrounds use `--color-overlay-hover` / `--color-overlay-active` (semantic overlay tokens that auto-flip with the surface's `tone`). The ghost-button auto-tone watcher (`packages/ui/utils/button-tone.ts`) samples the surface under each ghost button and sets `tone="dark"` or `tone="light"` on the button itself so its hover tint reads against the local backdrop.
150
+ - **`<button variant="ghost">`** — fully chromeless, no fill. Hover/active backgrounds use `--color-overlay-hover` / `--color-overlay-active` (semantic overlay tokens that auto-flip with the surface's `tone`). The transparent-chrome auto-tone watcher (`packages/ui/utils/button-tone.ts`) samples `[variant="ghost"]`, `[variant="glass"]`, and `[material="glass"]` when they create a new tone boundary; nested transparent chrome inherits an ancestor `tone` unless it explicitly declares its own.
151
151
  - **`<button variant="primary">`** — emphasis button. Fills with `--color-primary` for the bg, `--white` for text.
152
152
  - **Icon-only buttons** — `<button icon-only>` becomes a square at `--control-height-md` per side.
153
153
 
@@ -173,9 +173,9 @@ Theme levers:
173
173
  - Adjust `--color-border` to change the title bar's edge weight.
174
174
  - Adjust the title's font weight or letter spacing via selector-level rules on `artifact-view > header` if the design needs a non-token change (comment the rule with purpose).
175
175
 
176
- ### Command panel — input + chat stream
176
+ ### Command panel — input + content
177
177
 
178
- `<command-panel>` is the persistent chrome at the bottom (or corner) of the app. It hosts the chat input (typically a textarea) and the message stream above it. By default uses **paper** material in **dark** tone, **`level="overlay"`** (no shadow — it's bonded to the viewport).
178
+ `<command-panel>` is the persistent chrome at the bottom (or corner) of the app. It hosts the command panel input (typically a textarea) and command panel content above it. By default uses **paper** material in **dark** tone, **`level="overlay"`** (no shadow — it's bonded to the viewport).
179
179
 
180
180
  What it consumes:
181
181
 
@@ -189,8 +189,8 @@ Theme levers:
189
189
 
190
190
  - Override the dark-tone surface color: target `[tone="dark"]` in your theme and set `--color-surface` (or set it on `command-panel` directly with a purpose comment).
191
191
  - Adjust message-stream separator weight via `--color-border-muted`.
192
- - Adjust the chat input's affordance via `--color-interactive`.
193
- - For dramatic looks (a saturated chat background, a textured chat surface), target `command-panel` directly with a purpose comment.
192
+ - Adjust the command panel input's affordance via `--color-interactive`.
193
+ - For dramatic looks (a saturated command panel background, a textured command panel surface), target `command-panel` directly with a purpose comment.
194
194
 
195
195
  ### Popovers and dropdowns
196
196
 
@@ -310,7 +310,7 @@ Create a new skill — wherever skills live in the user's environment. Folder la
310
310
 
311
311
  The SKILL.md should have:
312
312
 
313
- - **Frontmatter** with `name` following the convention `tv-theme-<name>` (e.g. `tv-theme-paperlike`) and `description` (one-line aesthetic summary). The `tv-theme-` prefix scopes the skill to Television theming so it's discoverable alongside the bundled `television-theme` meta-skill.
313
+ - **Frontmatter** with `name` following the convention `tv-theme-<name>` (e.g. `tv-theme-paperlike`) and `description` (one-line aesthetic summary). The `tv-theme-` prefix scopes the skill to Television theming so it's discoverable alongside the bundled `tv-theme` meta-skill.
314
314
  - **Intent.** 1–3 paragraphs describing the look and the user-facing pitch. Specific enough that another agent (or you, six months later) could re-author this theme from scratch from this section alone.
315
315
  - **References.** Optional — inspirations, links, screenshots, brand/product references.
316
316
  - **Design choices.** Bulleted list of decisions with rationale. E.g. *"Background is near-black to evoke low-light comfort"*, *"Primary accent is muted teal — saturated enough to read on dark, restrained enough not to scream."*