@tongue-core/templates 0.1.0-rc.8 → 0.1.0-rc.9

package/README.md

@@ -27,6 +27,10 @@ Reading templates uses the file system (Bun or Node). The format itself (`templa
 `TemplateSource`, `projectFromTemplate`) is `@tongue-core/project/template`'s, so other sources (an app's
 own catalog, a URL) implement the same interface.
 
+Templates ship local, generated media for offline use. Applications should normally declare
+hosted footage by URL in `assets.ts`, with an immutable SHA-256 when available. The SDK's media
+store prepares and hosts previews outside the project; builds retain only their references.
+
 ## A template
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tongue-core/templates",
-  "version": "0.1.0-rc.8",
+  "version": "0.1.0-rc.9",
   "description": "The film projects `tongue init` starts from: a blank film, a vertical social post, a promo with footage. Each is a complete project that builds as it is.",
   "type": "module",
   "license": "MIT",
@@ -25,7 +25,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@tongue-core/project": "0.1.0-rc.8"
+    "@tongue-core/project": "0.1.0-rc.9"
   },
   "peerDependencies": {
     "effect": "^4.0.6"

package/templates/blank/README.md

@@ -2,7 +2,12 @@
 
 - `film.tsx` is the timeline: which scenes play, for how long, and how they join.
 - `scenes/` has one scene per file, named for its id (`scenes/title.tsx` is scene `title`).
-- `assets.ts` declares the files the film uses; they live in `assets/`.
+- `assets.ts` declares media at module scope. Application footage normally uses hosted URLs;
+  the template's local fonts live in `assets/` so it also works offline.
+
+For hosted footage, declare `video("https://…/screen.mp4", { name: "screen", sha256: "<64 hex digits>" })`.
+Set `TONGUE_MEDIA_DIR` and `TONGUE_MEDIA_URL` to the host's prepared-media store for portable builds,
+or supply a hosted `prepared` manifest on the asset. Studio serves a local media store automatically.
 
 ```bash
 tongue check .              # does it build? (layout, code, timeline)

package/templates/blank/assets.ts

@@ -3,3 +3,7 @@ import { font } from "@tongue-core/film";
 // Every file the film uses, declared once. Paths are relative to the project.
 
 export const inter = font("assets/fonts/Inter.woff2");
+
+// Application media normally uses hosted URLs, declared here before rendering.
+// Example: video("https://cdn.example/screen.mp4", { name: "screen", sha256: "<64 hex digits>" }).
+// A portable build uses the host media store or an asset's prepared manifest URL.

package/templates/promo/assets.ts

@@ -8,3 +8,7 @@ export const inter = font("assets/fonts/Inter.woff2");
 export const aurora = video("assets/video/aurora.mp4");
 /** A generated dusk landscape. */
 export const dusk = image("assets/images/dusk.jpg", { maxSize: 2000 });
+
+// Application media normally uses hosted URLs, declared here before rendering.
+// Example: video("https://cdn.example/screen.mp4", { name: "screen", sha256: "<64 hex digits>" }).
+// A portable build uses the host media store or an asset's prepared manifest URL.

package/templates/social-post/assets.ts

@@ -6,3 +6,7 @@ export const fraunces = font("assets/fonts/Fraunces.woff2");
 export const figtree = font("assets/fonts/Figtree.woff2");
 /** A generated dusk landscape; swap in a photo of your own. */
 export const dusk = image("assets/images/dusk.jpg", { maxSize: 2000 });
+
+// Application media normally uses hosted URLs, declared here before rendering.
+// Example: video("https://cdn.example/screen.mp4", { name: "screen", sha256: "<64 hex digits>" }).
+// A portable build uses the host media store or an asset's prepared manifest URL.