@tongue-core/templates 0.1.0-rc.1 → 0.1.0-rc.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Backpine
+
+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.

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,9 +1,9 @@
 {
   "name": "@tongue-core/templates",
-  "version": "0.1.0-rc.1",
+  "version": "0.1.0-rc.10",
   "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": "UNLICENSED",
+  "license": "MIT",
   "author": "Backpine",
   "repository": {
     "type": "git",
@@ -25,8 +25,10 @@
     "README.md"
   ],
   "dependencies": {
-    "@tongue-core/project": "0.1.0-rc.1",
-    "effect": "4.0.6"
+    "@tongue-core/project": "0.1.0-rc.10"
+  },
+  "peerDependencies": {
+    "effect": "^4.0.6"
   },
   "publishConfig": {
     "access": "public"

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.