@tongue-core/templates 0.0.0-stage → 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

@@ -1,3 +1,54 @@
-# Temporary Holding Version
+# @tongue-core/templates
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The film projects `tongue init` starts from. Each is a complete project (it builds and renders as
+it is) plus a `template.json` that says what it makes.
+
+| Template | Size | What it shows |
+|---|---|---|
+| `blank` | 1920×1080 | the smallest project: a title, a fade, an outro |
+| `social-post` | 1080×1920 | a Reel or Short: a photo hook with words landing one by one, a numbered list, a call to action; a brand kit; safe areas for the apps' buttons |
+| `promo` | 1920×1080 | footage: a title card, a video clip with a lower third over it on a second track, a still with a typed quote, an end card |
+
+```bash
+tongue templates                              # the list
+tongue init my-film --template social-post   # a project from one
+tongue init my-film --template ./my-template # or from any template folder
+```
+
+```ts
+import { builtInTemplates, readTemplateFolder, templateFolders } from "@tongue-core/templates";
+
+await builtInTemplates.list();                // TemplateManifest[]
+await builtInTemplates.read("promo");         // { manifest, files }
+templateFolders("/srv/templates");            // a TemplateSource over a folder of your own
+```
+
+Reading templates uses the file system (Bun or Node). The format itself (`template.json`,
+`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
+
+```
+my-template/
+  template.json   { "name", "title", "description", "width", "height", "fps", "tags" }
+  README.md       copied into the project: what the scenes are and which props they take
+  film.tsx, scenes/, kit/, lib/, assets.ts, assets/
+```
+
+`tongue init` copies the files, writes a fresh `tongue.json` (the project's name, the Tongue
+version, the template), and the `tsconfig.json` and `.gitignore` every project has.
+
+## Rules
+
+- **It builds as it is.** The test suite builds every template into film.json, and
+  `tools/project-check.ts` takes each through the CLI (init, check, build, stills, render) and the
+  social post through the browser player.
+- **Type-checked and cast-free,** like the rest of the repo (`tsconfig.templates.json`).
+- **Deterministic:** scene code uses `math` from `@tongue-core/film`, never `Math.sin` and friends.
+- **Assets it can ship:** fonts are OFL (licences beside them); the image and the footage are
+  generated with ffmpeg and free to use.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { type Template, type TemplateSource } from "@tongue-core/project";
+/** Where the built-in templates are. */
+export declare const TEMPLATES_DIR: string;
+/** The template in `dir`: its template.json and its files. Rejects with a TemplateError. */
+export declare function readTemplateFolder(dir: string): Promise<Template>;
+/** The templates in the folders of `root`, by name. */
+export declare function templateFolders(root: string): TemplateSource;
+/** The templates that come with Tongue. */
+export declare const builtInTemplates: TemplateSource;

package/dist/index.js

@@ -0,0 +1,60 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { IGNORED_DIRS, parseTemplateManifest, TEMPLATE_FILE, TemplateError } from "@tongue-core/project";
+import { Effect } from "effect";
+// @tongue-core/templates: the film projects `tongue init` starts from, and reading templates from
+// folders (these, or anyone's). Each template is a complete project plus template.json; the
+// test suite builds every one, so a template can't ship broken.
+/** Where the built-in templates are. */
+export const TEMPLATES_DIR = fileURLToPath(new URL("../templates", import.meta.url));
+/** Every file under `dir` (but what Tongue writes there), as a template's files. */
+async function filesOf(dir) {
+    const out = [];
+    const walk = async (at) => {
+        for (const name of (await readdir(at)).sort()) {
+            const path = join(at, name);
+            if ((await stat(path)).isDirectory()) {
+                if (!IGNORED_DIRS.has(name))
+                    await walk(path);
+            }
+            else {
+                out.push({ path: relative(dir, path).split(sep).join("/"), bytes: new Uint8Array(await readFile(path)) });
+            }
+        }
+    };
+    await walk(dir);
+    return out;
+}
+/** The template in `dir`: its template.json and its files. Rejects with a TemplateError. */
+export async function readTemplateFolder(dir) {
+    const text = await readFile(join(dir, TEMPLATE_FILE), "utf8").catch(() => null);
+    if (text === null)
+        throw new TemplateError({ template: dir, message: `${dir} isn't a template: it has no ${TEMPLATE_FILE}.` });
+    const manifest = await Effect.runPromise(parseTemplateManifest(text, dir));
+    const files = (await filesOf(dir)).filter((f) => f.path !== TEMPLATE_FILE);
+    return { manifest, files };
+}
+/** The templates in the folders of `root`, by name. */
+export function templateFolders(root) {
+    const folders = async () => {
+        const names = await readdir(root).catch(() => []);
+        const found = [];
+        for (const name of names.sort()) {
+            if ((await stat(join(root, name, TEMPLATE_FILE)).catch(() => null))?.isFile())
+                found.push(name);
+        }
+        return found;
+    };
+    return {
+        list: async () => Promise.all((await folders()).map(async (name) => (await readTemplateFolder(join(root, name))).manifest)),
+        read: async (name) => {
+            const known = await folders();
+            if (!known.includes(name))
+                throw new TemplateError({ template: name, message: `There is no template "${name}" (templates: ${known.join(", ")}).` });
+            return readTemplateFolder(join(root, name));
+        },
+    };
+}
+/** The templates that come with Tongue. */
+export const builtInTemplates = templateFolders(TEMPLATES_DIR);

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@tongue-core/templates",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "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": "MIT",
+  "author": "Backpine",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/backpine/tongue-core.git",
+    "directory": "packages/templates"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "dependencies": {
+    "@tongue-core/project": "0.1.0-rc.10"
+  },
+  "peerDependencies": {
+    "effect": "^4.0.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/blank/README.md

@@ -0,0 +1,22 @@
+# A Tongue film
+
+- `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 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)
+tongue stills . --sheet     # a contact sheet of frames
+tongue stills . --scene title
+tongue build .              # dist/: film.json, build.json, a bundle per scene
+tongue render .             # out/<name>.mp4
+```
+
+Scenes take their content as props (`props={{ headline: "…" }}` in film.tsx), so the same scene
+plays with different words. Use `math` from `@tongue-core/film` (not `Math.sin`) in scene code so every
+frame is the same everywhere.

package/templates/blank/assets/fonts/OFL-Inter.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/templates/blank/assets.ts

@@ -0,0 +1,9 @@
+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/blank/film.tsx

@@ -0,0 +1,15 @@
+import { Clip, Film, Track, Transition } from "@tongue-core/film";
+import Outro from "./scenes/outro.tsx";
+import Title from "./scenes/title.tsx";
+
+// The timeline: a title, then the outro, joined by a crossfade. 5 seconds at 30 fps.
+
+export default (
+  <Film width={1920} height={1080} fps={30} background="#0f1115">
+    <Track id="main">
+      <Clip scene={Title} props={{ headline: "Your film starts here", subline: "Edit film.tsx and the scenes, then look with tongue stills" }} />
+      <Transition.Fade frames={15} />
+      <Clip scene={Outro} props={{ line: "Made with Tongue" }} />
+    </Track>
+  </Film>
+);

package/templates/blank/scenes/outro.tsx

@@ -0,0 +1,21 @@
+import { Center, Fill, scene, Show, Stage, t } from "@tongue-core/film";
+import { inter } from "../assets.ts";
+
+// The last word: one line that pops in and holds.
+
+export default scene({
+  name: "outro",
+  props: { line: t.string({ maxLength: 60 }) },
+  duration: 60,
+  keys: ["headline"],
+  render: ({ line }) => (
+    <Stage>
+      <Fill color="#ff7a45" />
+      <Center>
+        <Show from={6} enter="pop">
+          <div morph="headline" style={{ fontFamily: inter, fontSize: 96, fontWeight: 700, letterSpacing: -2, color: "#0f1115" }}>{line}</div>
+        </Show>
+      </Center>
+    </Stage>
+  ),
+});

package/templates/blank/scenes/title.tsx

@@ -0,0 +1,40 @@
+import { Center, Fill, now, scene, Show, Stage, t } from "@tongue-core/film";
+import { inter } from "../assets.ts";
+
+// A headline that rises in over a line drawn underneath it, with an optional line of detail. Each
+// part has its own fixed height, so nothing moves when the next part appears.
+
+export default scene({
+  name: "title",
+  props: {
+    headline: t.string({ maxLength: 48 }),
+    subline: t.optional(t.string({ maxLength: 80 })),
+  },
+  duration: 90,
+  keys: ["headline"],
+  render: ({ headline, subline }) => {
+    const line = now().progress(14, 44, "glide");
+    return (
+      <Stage>
+        <Fill color="#0f1115" />
+        <Center>
+          <div style={{ display: "flex", flexDirection: "column", alignItems: "center", gap: 28 }}>
+            <div style={{ height: 136, display: "flex", alignItems: "center" }}>
+              <Show from={4} enter="rise">
+                <div morph="headline" style={{ fontFamily: inter, fontSize: 112, fontWeight: 700, letterSpacing: -3, color: "#f5f3ee", whiteSpace: "nowrap" }}>{headline}</div>
+              </Show>
+            </div>
+            <div style={{ width: 640 * line, height: 6, borderRadius: 3, background: "#ff7a45" }} />
+            {subline ? (
+              <div style={{ height: 52 }}>
+                <Show from={26} enter="fade">
+                  <div style={{ fontFamily: inter, fontSize: 40, color: "#a9adb6", whiteSpace: "nowrap" }}>{subline}</div>
+                </Show>
+              </div>
+            ) : null}
+          </div>
+        </Center>
+      </Stage>
+    );
+  },
+});

package/templates/blank/template.json

@@ -0,0 +1,9 @@
+{
+  "name": "blank",
+  "title": "Blank",
+  "description": "The smallest film project: a title and an outro, joined by a fade. Start here to build something of your own.",
+  "width": 1920,
+  "height": 1080,
+  "fps": 30,
+  "tags": ["16:9", "starter"]
+}

package/templates/promo/README.md

@@ -0,0 +1,24 @@
+# A promo
+
+A 16:9 film of 12.5 seconds built on footage. Two tracks:
+
+- **base**: the title card, the footage (`assets/video/aurora.mp4`, 4 s), a still
+  (`assets/images/dusk.jpg`) and the end card, joined by a wipe and fades.
+- **titles**, drawn over base: a lower third while the footage plays, a quote over the still.
+  Their scenes have no background, so the footage shows through.
+
+| Scene | Props |
+|---|---|
+| `intro` | `kicker`, `title` |
+| `lower-third` | `label`, `title` |
+| `caption` | `quote`, `credit` |
+| `outro` | `headline`, `url` |
+
+Swap the footage and the still in `assets.ts` (any MP4, JPEG or PNG), and the brand in
+`kit/brand.ts`. The media is generated, free to use.
+
+```bash
+tongue stills . --sheet
+tongue stills . --scene lower-third
+tongue render .
+```

package/templates/promo/assets/fonts/OFL-Fraunces.txt

@@ -0,0 +1,93 @@
+Copyright 2018 The Fraunces Project Authors (https://github.com/undercasetype/Fraunces)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/templates/promo/assets/fonts/OFL-Inter.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/templates/promo/assets.ts

@@ -0,0 +1,14 @@
+import { font, image, video } from "@tongue-core/film";
+
+// Every file the film uses, declared once. Paths are relative to the project.
+
+export const fraunces = font("assets/fonts/Fraunces.woff2");
+export const inter = font("assets/fonts/Inter.woff2");
+/** Generated footage of an aurora, 4 seconds; swap in your own. */
+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.