@tellandshow/story-assets 0.0.1

package/CLAUDE.md

@@ -0,0 +1,45 @@
+# @tellandshow/story-assets — Agent Router
+
+## What this is
+
+CC0 starter content for Story Studio: background SVGs, palette presets, ambient sound loops, font pairings. Consumed by genre presets (`@tellandshow/story-skills/genre/*`) and the drawing card (offers starter palettes per genre).
+
+**M1.1 status: empty stub.** Assets land in M3 once the builder is wired to read from them.
+
+## Planned layout (M3)
+
+```
+story-studio/packages/story-assets/
+├── assets/
+│   ├── palettes/
+│   │   ├── fairy-tale.json
+│   │   ├── mystery.json
+│   │   └── ...
+│   ├── backgrounds/
+│   │   ├── forest.svg
+│   │   ├── castle.svg
+│   │   └── ...
+│   ├── sound-loops/
+│   │   ├── fireplace.mp3
+│   │   └── ...
+│   └── fonts/
+│       └── (Google Fonts subsets we ship)
+├── package.json
+└── CLAUDE.md
+```
+
+## Always
+
+- Every asset is **CC0** or otherwise public-domain. No CC-BY, no attribution-required content. We can't expect a 9-year-old to manage attribution.
+- Pre-publish, scan that no third-party copyrighted material slipped in.
+
+## Ask first
+
+- Adding a non-CC0-licensed asset (even if "free for non-commercial use").
+- Bundling fonts that have name-restricted licenses (e.g., Adobe Originals).
+
+## Updates
+
+| Date       | Change                                              | Author |
+|------------|-----------------------------------------------------|--------|
+| 2026-05-07 | Initial empty stub (M1.1). Assets land in M3.       | jim    |

package/LICENSE

@@ -0,0 +1,30 @@
+MIT License
+
+Copyright © 2026 Tell and Show
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+---
+
+NOTE ON BUNDLED ASSETS: The CC0 sprites, sounds, palettes, and other content
+shipped under `assets/` are sourced from public-domain origins. Each asset's
+provenance is documented in its sibling `<asset>.meta.json` file (when M3
+content lands). Use of those assets is governed by CC0 — no attribution
+required, but provenance metadata preserves the chain of custody for
+auditability.

package/assets/picker-thumbnails/README.md

@@ -0,0 +1,62 @@
+# Picker thumbnails
+
+Tiny CC0 SVG icons that ride alongside `picker` / `image-picker` wizard
+options. When a wizard option declares `image: "@tellandshow/story-assets/picker-thumbnails/<id>.svg"`,
+the renderer grabs the thumbnail from this folder and shows it inside the
+option tile. Kids see what each choice *looks like* before committing —
+visual-forward all the way down.
+
+## Why this exists
+
+Story Studio's wizards already lean on `image-picker` for mood / vibe / role
+selection (see `kid/sketch-character`'s mood picker, `kid/sketch-scene`'s
+mood picker, `kid/create-character`'s vibe + role pickers). Today those
+options ship without `image` URLs because no thumbnail bank exists. This
+folder is the bank.
+
+## Schema (`manifest.json`)
+
+```jsonc
+{
+  "version": 1,
+  // Optional default size hint. Renderer reads this; falls back to its own
+  // 96×96 if absent.
+  "thumbSize": { "w": 96, "h": 96 },
+  // Map of option id → thumbnail path, relative to this folder.
+  // Keys MUST match the `id` of a picker option used in some wizard.
+  "thumbnails": {
+    "mood-brave":       "moods/brave.svg",
+    "mood-mysterious":  "moods/mysterious.svg",
+    "vibe-heroic":      "vibes/heroic.svg",
+    "role-villain":     "roles/villain.svg"
+  }
+}
+```
+
+The manifest is a **lookup table**, not a build artifact. Wizards reference
+thumbnails by manifest key OR by relative path inside `picker-thumbnails/`
+— both resolve. Keys win when both are valid.
+
+## Authoring rules (when M3 fills this in)
+
+- **CC0 only.** No traced-from-copyrighted-source thumbnails. Each `.svg`
+  ships with a sibling `<id>.meta.json` recording origin (drawn fresh /
+  derived from open art / sourced from <link>) so the chain of custody is
+  auditable.
+- **One concept per thumbnail.** A "brave" mood thumbnail isn't a busy
+  scene — it's a single iconic stick figure with the brave-pose silhouette.
+  Kids should read the meaning in under a second.
+- **96×96 viewBox**, 2-color palette by default (paper + ink), accent
+  swatch optional for mood-keyed tints. Stroke 4–6px to read at thumbnail
+  size on a small screen.
+- **Group by category.** `moods/`, `vibes/`, `roles/`, `genres/`. Lets
+  wizards reference a whole category at once via `manifest.byCategory`
+  (M3 expansion — not in v1 schema).
+
+## Status
+
+**Placeholder.** This folder ships in `@tellandshow/story-assets@0.0.1`
+with the manifest scaffold + this README, no SVGs yet. The first batch
+arrives when M3 visual-forward authoring lands (Task #50 in the plan).
+Wizards already ship with `description:` strings on every option; those
+remain the textual fallback after thumbnails arrive.

package/assets/picker-thumbnails/manifest.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "thumbSize": { "w": 96, "h": 96 },
+  "thumbnails": {}
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@tellandshow/story-assets",
+  "version": "0.0.1",
+  "description": "CC0 starter assets for Tell and Show's Story Studio: backgrounds, palette presets, sound loops, font pairings. Consumed by genre presets and the drawing card.",
+  "files": [
+    "assets/",
+    "CLAUDE.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "tellandshow",
+    "story-assets",
+    "kids"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EJKIV/tellandshow.git",
+    "directory": "story-studio/packages/story-assets"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}