@tobos/cli 0.4.45 → 0.4.46
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.
- package/dist/chunk-FOAC7RGC.js +124 -0
- package/dist/{chunk-U44FVSIH.js → chunk-YQCBNLI6.js} +1 -1
- package/dist/cli.js +5 -5
- package/dist/{render-EGSI4MIU.js → render-FI5S3XNV.js} +1 -1
- package/dist/{types-Z5RQYYIE.js → types-XI7ITVA3.js} +2 -2
- package/package.json +1 -1
- package/dist/chunk-G2X34YQC.js +0 -183
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { createRequire as __tobosRequire } from 'node:module';
|
|
3
|
+
const require = __tobosRequire(import.meta.url);
|
|
4
|
+
var __create = Object.create;
|
|
5
|
+
var __defProp = Object.defineProperty;
|
|
6
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
7
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
8
|
+
var __getProtoOf = Object.getPrototypeOf;
|
|
9
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
10
|
+
var __esm = (fn, res, err) => function __init() {
|
|
11
|
+
if (err) throw err[0];
|
|
12
|
+
try {
|
|
13
|
+
return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
|
|
14
|
+
} catch (e) {
|
|
15
|
+
throw err = [e], e;
|
|
16
|
+
}
|
|
17
|
+
};
|
|
18
|
+
var __commonJS = (cb, mod) => function __require() {
|
|
19
|
+
try {
|
|
20
|
+
return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
|
|
21
|
+
} catch (e) {
|
|
22
|
+
throw mod = 0, e;
|
|
23
|
+
}
|
|
24
|
+
};
|
|
25
|
+
var __export = (target, all) => {
|
|
26
|
+
for (var name in all)
|
|
27
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
28
|
+
};
|
|
29
|
+
var __copyProps = (to, from, except, desc) => {
|
|
30
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
31
|
+
for (let key of __getOwnPropNames(from))
|
|
32
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
33
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
34
|
+
}
|
|
35
|
+
return to;
|
|
36
|
+
};
|
|
37
|
+
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
|
|
38
|
+
// If the importer is in node compatibility mode or this is not an ESM
|
|
39
|
+
// file that has been converted to a CommonJS file using a Babel-
|
|
40
|
+
// compatible transform (i.e. "__esModule" has not been set), then set
|
|
41
|
+
// "default" to the CommonJS "module.exports" for node compatibility.
|
|
42
|
+
isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
|
|
43
|
+
mod
|
|
44
|
+
));
|
|
45
|
+
|
|
46
|
+
// <define:TOBOS_PRESENT_TYPES>
|
|
47
|
+
var define_TOBOS_PRESENT_TYPES_default;
|
|
48
|
+
var init_define_TOBOS_PRESENT_TYPES = __esm({
|
|
49
|
+
"<define:TOBOS_PRESENT_TYPES>"() {
|
|
50
|
+
define_TOBOS_PRESENT_TYPES_default = { "registry.d.ts": "export declare function setMedia(media: Record<string, {\n hash: string;\n}>): void;\n/** The URL of a file in media/, what `import cow from '$media/cow.jpg'` gives. */\nexport declare function mediaUrl(name: string): string;\n/**\n * What `import.meta.glob('$media/cow/*.png')` gives: each file of media/ a pattern matches, by its\n * specifier (`$media/cow/a.png`), in order, with its URL. On a share, only those it has.\n */\nexport declare function mediaGlob(patterns: string[]): Record<string, string>;\n/** The deck's join code, and the ways to show it. */\nexport interface JoinInfo {\n /** The six digits: `482913`. */\n code: string;\n /** The link as people type it, without the scheme: `tobosusercontent.com/482913`. */\n link: string;\n /** The full URL the QR code holds: `https://tobosusercontent.com/482913`. */\n url: string;\n /** The QR code, black on white, as an image's address: `<img src={join.qr} />`. */\n qr: string;\n}\nexport declare function setJoin(info: JoinInfo | undefined): void;\nexport declare function joinInfo(): JoinInfo | undefined;\n/** Whether this is a share link's page, for people outside the deck's account. */\nexport declare function setShared(value: boolean): void;\nexport declare function isShared(): boolean;\n", "timeline.d.ts": "import type { Beat } from './index.ts';\n/**\n * Whether the scene timeline that holds this animation is playing a step forward, in real\n * time, as opposed to being sought (a jump, a step back, a finish, a still view or a render).\n */\nexport declare function playingForward(animation: gsap.core.Animation): boolean;\n/**\n * Whether the scene timeline that holds this animation is playing a step forward that may be\n * heard: one this window was moved to itself, not one it follows from another window.\n */\nexport declare function playingAloud(animation: gsap.core.Animation): boolean;\n/**\n * A sound that plays on through a range of a scene's beats, from the one that starts it up to,\n * not including, the one it stops at (playAudio's `until`).\n */\nexport interface Span {\n /** Play it from its start, heard. */\n start(): void;\n /** Stop it, fading it out or at once; resolves once it is silent. */\n stop(fade: boolean): Promise<void>;\n}\n/**\n * Add a span to the scene `tl` is the timeline of, while one of its beats' `enter` runs: from\n * that beat up to the one `until` names. False where `until` names no later beat of the scene.\n */\nexport declare function addSpan(tl: gsap.core.Timeline, until: string, span: Span): boolean;\n/**\n * One scene's beats as one paused GSAP timeline, with a label after each beat's animation.\n * Stepping forward tweens the playhead to the next label; everything else seeks. A beat's loop\n * repeats on a timeline of its own, beside it, which this one never holds: seeking its labels\n * would reach none past a loop that runs for ever.\n */\nexport declare class SceneTimeline {\n readonly timeline: gsap.core.Timeline;\n private labels;\n private tween;\n /** Whether the step playing may be heard. */\n aloud: boolean;\n private ids;\n /** The beat whose `enter` is running, while the timeline is built. */\n private building;\n private ranges;\n /** The ranges that are loops, which `loops` starts or stops. */\n private loopRanges;\n /** The beat shown, -1 before the first or off the stage. */\n private at;\n /**\n * Whether loops play, or each stays at its start. Off until a stage that plays them says so:\n * a page of the PDF never does.\n */\n private looping;\n /** The spans' stops still fading out. */\n private fades;\n constructor(root: Element, beats: readonly Beat[]);\n addSpan(until: string, span: Span): boolean;\n /** A beat's loop, repeating from its start each time the scene arrives in its range. */\n private addLoop;\n /** Play the loops, or keep each at its start: a still view, a render. Sound plays on as it was. */\n loops(on: boolean): void;\n /**\n * Whether a span is still fading out: a scene leaving the stage is unmounted once it is\n * silent, since its sound goes with its elements.\n */\n get fading(): Promise<void> | null;\n get playing(): boolean;\n /** Finish the beat that is playing, at once. */\n finish(): void;\n /** Before the first beat: the scene waiting for its entrance. */\n hold(): void;\n /** The scene has left the stage: its spans fade out, its loops stop. */\n leave(): void;\n /**\n * After a move to `beat` (-1: none), each range runs while the beat is in it, whichever way it\n * moved there, and stops outside it. `stepped`: a step forward, heard, played into the beat.\n */\n private move;\n /**\n * Show a beat: play the animation into it, or land on its end state. `aloud`: whether its\n * sound plays, or the step plays silent.\n */\n show(beat: number, animate: boolean, aloud?: boolean): void;\n /** Put the playhead part-way through the animation into a beat (0..1), for filmstrips. */\n sample(beat: number, progress: number): void;\n /** How long the animation into a beat takes, in seconds. */\n duration(beat: number): number;\n kill(): void;\n}\n", "playback.d.ts": "interface ClipOptions {\n /** Where the clip starts in the video or sound, in seconds. Default 0. */\n from?: number;\n /** Where the clip ends in the video or sound, in seconds. Default: its end. */\n to?: number;\n /** Speed: 1 is real time, 0.5 half speed. Default 1. */\n rate?: number;\n /**\n * When the clip starts within the beat: GSAP's position parameter (`'<'`, `'+=0.5'`, a\n * number). Default: after what the beat has animated so far, like any `tl.to`.\n */\n position?: gsap.Position;\n}\nexport interface PlayAudioOptions extends ClipOptions {\n /**\n * The beat the sound plays until. It plays on through the beats before it, whichever way the\n * presenter moves among them, and fades out when this beat or one outside the range is shown,\n * or the scene is left. The beat it starts in doesn't wait for it, and `to` and `position`\n * don't apply: it plays from `from` to its end, or until then.\n */\n until?: string;\n /** With `until`: how long it fades out, in seconds. Default 1; 0 stops it at once. */\n fade?: number;\n}\nexport interface PlayVideoOptions extends ClipOptions {\n /** Play the video's own sound with it. Default: muted. */\n sound?: boolean;\n}\n/**\n * Play a video (or the clip `from`\u2013`to` of it) as part of a beat. Stepping forward plays it in\n * real time; going back, jumping or reloading shows the frame for that position at once; a\n * click while it plays lands on its last frame. Before its beat it shows the clip's first frame.\n *\n * ```ts\n * { id: 'turn', enter: (tl, q) => playVideo(tl, q('video')) }\n * ```\n *\n * The video plays inline and preloads, and is muted unless `sound` is set. Several videos\n * (`q('video')` finding more than one) play side by side, each its own length.\n */\nexport declare function playVideo(tl: gsap.core.Timeline, target: Element | ArrayLike<Element> | null | undefined, options?: PlayVideoOptions): gsap.core.Timeline;\n/**\n * Play a sound (or the clip `from`\u2013`to` of it) as part of a beat. Stepping forward plays it in\n * real time; a click while it plays stops it and plays the next beat; going back, jumping or\n * reloading is silent. So is a scene mounted ahead, and a window that only follows another.\n *\n * ```ts\n * { id: 'listen', enter: (tl, q) => playAudio(tl, q('audio')) }\n * ```\n *\n * The sound preloads. Several (`q('audio')` finding more than one) play together, each its own\n * length.\n */\nexport declare function playAudio(tl: gsap.core.Timeline, target: Element | ArrayLike<Element> | null | undefined, options?: PlayAudioOptions): gsap.core.Timeline;\n/**\n * Call `listener` each time the browser refuses this window sound, until a click or key press\n * in it lets it play. Returns a function that stops listening.\n */\nexport declare function onSoundRefused(listener: () => void): () => void;\n/**\n * Wait until the videos and sounds inside `root` know their length, so `playVideo` and\n * `playAudio` can size their clips when the scene's timeline is built. Those that won't load (no\n * source, `preload=\"none\"`, an error) don't hold it up, nor does anything past `timeout`.\n */\nexport declare function mediaKnowTheirLength(root: Element, timeout?: number): Promise<void>;\n/**\n * Wait until every video inside `root` shows the frame it was last sought to: no seek pending,\n * a frame decoded, and that frame handed to the screen again (`repaint`). Videos that won't load\n * don't hold it up.\n */\nexport declare function videoFramesReady(root: Element): Promise<void>;\nexport {};\n", "deck/types.d.ts": "export type Severity = 'error' | 'warning';\n/** One thing wrong with a deck. Lines and columns are 1-based. */\nexport interface Problem {\n file: string;\n line?: number;\n column?: number;\n rule: string;\n message: string;\n severity: Severity;\n}\n/** A scene's place in the outline: its id, which is its file's name, its title and whether it shows. */\nexport interface OutlineScene {\n id: string;\n title: string;\n /** Left out of presenting, the share link and its PDF; still on the deck's page. */\n hidden?: true;\n}\nexport interface OutlineChapter {\n id: string;\n title: string;\n scenes: OutlineScene[];\n}\n/**\n * A deck's outline: its title, and its chapters and their scenes in order (ADR 0006). Data, held\n * by Tobos, never a file of the deck; Tobos's own decks keep theirs in `outline.json` in the\n * codebase, in this shape.\n */\nexport interface Outline {\n title: string;\n chapters: OutlineChapter[];\n}\n/** deck.json: what the deck's code needs, its packages. The outline isn't in it (ADR 0006). */\nexport interface DeckJson {\n dependencies?: Record<string, string>;\n}\nexport interface MediaEntry {\n hash: string;\n size: number;\n type: string;\n}\n/** media.json: path inside media/ \u2192 the file's content hash. */\nexport type MediaJson = Record<string, MediaEntry>;\n/** A multiple-choice poll: each phone picks one option; its result shows from `reveals` on. */\nexport interface ChoiceActivity {\n id: string;\n kind: 'choice';\n prompt: string;\n options: string[];\n /** The beat of its scene that closes the poll and shows its result. */\n reveals?: string;\n}\nexport interface TextField {\n id: string;\n label: string;\n multiline?: boolean;\n /** The most characters it takes. 500 unless the scene says otherwise; in a manifest, always set. */\n max?: number;\n}\n/** An open-text poll: each phone fills in its fields. The answers are only stored. */\nexport interface TextActivity {\n id: string;\n kind: 'text';\n prompt?: string;\n fields: TextField[];\n}\n/**\n * A poll: what a scene asks the room, who answer on their phones (the format's `activity`). It\n * is open while the deck is presented on its scene, up to its `reveals` beat.\n */\nexport type Activity = ChoiceActivity | TextActivity;\n/** A scene as the build has it: what its file is, whether or not the outline places it. */\nexport interface BuildScene {\n beats: string[];\n /** The scene's specifier in the import map. */\n module: string;\n activity?: Activity;\n}\nexport interface ManifestScene extends BuildScene {\n id: string;\n title: string;\n /** Left out of presenting, the share link and its PDF (the outline's `hidden`). */\n hidden?: true;\n}\nexport interface ManifestChapter {\n id: string;\n title: string;\n scenes: ManifestScene[];\n}\n/**\n * What a build makes of one revision of a deck, which the server stores with it: every scene file\n * by its id, placed or not, and what the viewer loads. The outline isn't part of it: it is joined\n * in when a manifest is read (joinOutline). Format 1's modules call the engine's media(); a later\n * one's import media (`import cow from '$media/cow.jpg'`), compiled into lookups of the same media\n * map. A revision keeps the format it was pushed with.\n */\nexport interface Build {\n format: 1 | 2;\n /** Each top-level `scenes/<id>.svelte` that exports beats, by its id. */\n scenes: Record<string, BuildScene>;\n /**\n * Deck specifiers (`@deck/scenes/a.svelte`) \u2192 module paths relative to the viewer (`m/<hash>.js`).\n * The server adds the package specifiers once it has bundled them (`d3` \u2192 `p/<bundle>/d3.js`).\n */\n imports: Record<string, string>;\n media: MediaJson;\n /** deck.json's dependencies: package \u2192 exact version. */\n dependencies: Record<string, string>;\n /** The package specifiers the deck imports, by dependency: `{ three: ['three', 'three/addons/\u2026'] }`. */\n packages: Record<string, string[]>;\n /**\n * Stylesheets, relative to the viewer: the master's tokens.css (`m/<hash>.css`), then those of\n * the packages it imports (`p/<bundle>/katex/dist/katex.min.css`), which the server adds.\n */\n styles?: string[];\n /**\n * What the deck's code uses of the deck, so a share gets only what the scenes it shows reach,\n * and only what is on a slide must be on the server (share.ts). A manifest pushed before the build recorded it\n * had it written in afterwards, as its build then would have (TOB-397).\n */\n uses: Uses;\n}\n/**\n * A build stored before the outline left deck.json (ADR 0006): the scenes deck.json listed, in\n * its chapters, and its title, instead of `scenes`. Read as a build (buildScenes), its outline\n * being the deck's now.\n */\nexport type LegacyBuild = Omit<Build, 'scenes'> & {\n title: string;\n chapters: ManifestChapter[];\n};\n/** A build as the server may have stored it: from now on, or from before ADR 0006. */\nexport type StoredBuild = Build | LegacyBuild;\n/**\n * What the viewer needs to show one revision of a deck: its build, with the deck's outline as it\n * is now joined in (joinOutline). Only the scenes both have are in it.\n */\nexport type Manifest = Omit<Build, 'scenes'> & {\n title: string;\n chapters: ManifestChapter[];\n};\n/** A manifest as a share link has it: what its modules use isn't part of it (share.ts). */\nexport type SharedManifest = Omit<Manifest, 'uses'>;\n/** What each of a deck's modules uses of the deck itself, and what its stylesheet does. */\nexport interface Uses {\n /**\n * By specifier (`@deck/scenes/a.svelte`): the deck's modules it imports, statically or not; the\n * media.json names it imports; and its `import.meta.glob` patterns (`frames/*.png`), or in format\n * 1 its media() calls' (share.ts), which a share matches against media.json, so a pattern is here\n * once, not as every name it matches. Each is left out when it has none.\n */\n modules: Record<string, {\n imports?: string[];\n media?: string[];\n patterns?: string[];\n }>;\n /** The media.json names tokens.css links, which every page that shows the deck loads. */\n styles: string[];\n}\n/** A deck's files, from a directory or from a git revision. Paths use `/` and have no leading slash. */\nexport interface DeckTree {\n files(): string[];\n read(path: string): Uint8Array | undefined;\n}\n", "activities.d.ts": "/** What the server tells about a deck's activities: phones what is open, the projector the results. */\n/** An activity as a phone needs it: no more. */\nexport type PhoneActivity = {\n id: string;\n kind: 'choice';\n prompt: string;\n options: string[];\n} | {\n id: string;\n kind: 'text';\n prompt?: string;\n fields: {\n id: string;\n label: string;\n multiline?: boolean;\n max: number;\n }[];\n};\n/** Nothing live, or the session and its open activity, if any. */\nexport type PhoneState = {\n live: false;\n} | {\n live: true;\n show: string;\n activity: PhoneActivity | null;\n};\n/** What the projector hears: the session, and every activity answered in it. */\nexport interface Results {\n show: string | null;\n joined: number;\n activities: Record<string, {\n answered: number;\n counts?: number[];\n }>;\n}\n", "viewer/stream.d.ts": "/**\n * A server-sent events stream that outlasts the server going away. EventSource reconnects by\n * itself only when a connection drops; when a reconnect is answered with an error, as the proxy\n * answers 502 while the app restarts for a release, it gives up for good. This one opens it\n * again, waiting longer each time, up to a minute.\n *\n * `onOpen` runs on every connection, `again` on all but the first: what was sent while the\n * stream was away is missed, so that is the moment to read the state afresh.\n */\nexport declare function stream(url: string, listeners: Record<string, (data: string) => void>, onOpen?: (again: boolean) => void): () => void;\n", "viewer/events.d.ts": 'type Listener = (data: string) => void;\ndeclare const TYPES: readonly ["push", "results", "notes"];\nexport type EventType = (typeof TYPES)[number];\n/** Listen for one type of event on `url`, the window\'s stream: until the returned function runs. */\nexport declare function listen(url: string, type: EventType, listener: Listener, onReopen?: () => void): () => void;\nexport {};\n', "responses.svelte.d.ts": "/**\n * What the room has answered, for the projector: the audience and presenter windows, and the\n * preview on the deck's page, follow it from the server. Print and render, and a link that isn't\n * a presenter's, have zeros. It is live data, which the position can't recreate.\n */\nimport type { SharedManifest } from '@tobos/deck/types';\nimport type { Results } from './activities.ts';\n/** One activity's responses in the current session. */\nexport interface Responses {\n /**\n * The most phones that had the deck's join link open at once during this session, and never fewer\n * than answered.\n */\n readonly joined: number;\n /** People who have answered this activity during this session. */\n readonly answered: number;\n /** Multiple choice's responses per option, in the order the scene declares them; else empty. */\n readonly counts: number[];\n}\n/** The deck's activities, so a poll nobody answered yet has a zero per option. */\nexport declare function setActivities(manifest: SharedManifest): void;\n/** The current session's responses: reactive, for a scene or the presenter's view. */\nexport declare function liveResults(): Readonly<Results>;\n/**\n * The room's responses to an activity of this deck in the current session: how many joined, how\n * many answered, and a poll's counts per option. Call during component setup.\n */\nexport declare function useResponses(id: string): Responses;\n/** Follow the room's results on the window's stream (events.ts) until the returned function runs. */\nexport declare function followResponses(url: string): () => void;\n", "index.d.ts": "import { type Component } from 'svelte';\nimport { type JoinInfo } from './registry.ts';\nexport { playAudio, playVideo, type PlayAudioOptions, type PlayVideoOptions } from './playback.ts';\nexport { useResponses, type Responses } from './responses.svelte.ts';\nexport type { Activity, ChoiceActivity, TextActivity, TextField } from '@tobos/deck/types';\n/** Finds elements inside the current scene only. */\nexport type Query = (selector: string) => Element[];\n/** One click's worth of a scene: an ID, and the animation into it. */\nexport interface Beat {\n id: string;\n /** Add the animation into this beat to the scene's timeline. */\n enter?: (tl: gsap.core.Timeline, q: Query) => unknown;\n /**\n * Add one round of an animation that repeats while the scene is at this beat, and on through\n * the beats after it up to `until`. Each arrival in that range, by any move, plays it from its\n * start; leaving the range puts it back there, which is also what a still view, a render and a\n * PDF show. End it as it starts, so a round follows the last without a jump.\n */\n loop?: (tl: gsap.core.Timeline, q: Query) => unknown;\n /** With `loop`: the later beat of this scene it stops at. Default: it repeats to the scene's end. */\n until?: string;\n}\n/** The props the engine passes to every scene. */\nexport interface SceneProps {\n /** The current beat's ID. */\n beat: string;\n /** The current beat's index in the scene, from 0. */\n index: number;\n}\n/** Where a scene sits in the deck, for layouts that show it (a wayfinder, an agenda). */\nexport interface DeckContext {\n title: string;\n chapters: {\n id: string;\n title: string;\n scenes: {\n id: string;\n title: string;\n }[];\n }[];\n chapter: {\n id: string;\n title: string;\n };\n scene: {\n id: string;\n title: string;\n };\n}\nexport declare const DECK_CONTEXT = \"tobos:deck\";\n/** The deck, its chapters and the current scene. Call during component setup. */\nexport declare function useDeck(): DeckContext;\nexport type { JoinInfo } from './registry.ts';\n/**\n * The deck's join code, for a scene to show its own way: the digits, the link as people type\n * it, the full URL, and the QR code as an image's address. Undefined while the deck has no\n * activity.\n */\nexport declare function useJoin(): JoinInfo | undefined;\nexport interface JoinCodeProps {\n /** The QR code's width and height, in stage pixels. */\n size?: number;\n}\n/**\n * The deck's join code: a QR code, and under it the link it holds, which phones open to answer\n * the deck's activities. The scene sizes it; the link takes the scene's font.\n */\nexport declare const JoinCode: Component<JoinCodeProps>;\n", "media.d.ts": "// What a deck's code may write of media/, besides the engine's API: `tobos check --types`\n// declares it beside the engine's types (cli/build.ts), as the build compiles it\n// (deck/src/media-imports.ts).\n\n/** A file of media/: its URL. `import cow from '$media/cow.jpg'` */\ndeclare module '$media/*' {\n const url: string;\n export default url;\n}\n\ninterface ImportMeta {\n /**\n * The files of media/ a pattern matches, `import.meta.glob('$media/cow/*.png')`: each file's\n * URL by its specifier (`'$media/cow/a.png'`), in order. `*` matches within a folder's name, a\n * `**` folder any number of folders. The pattern is a string literal, or an array of them.\n */\n glob(pattern: string | string[]): Record<string, string>;\n}\n" };
|
|
51
|
+
}
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
// <define:TOBOS_SKILL>
|
|
55
|
+
var define_TOBOS_SKILL_default;
|
|
56
|
+
var init_define_TOBOS_SKILL = __esm({
|
|
57
|
+
"<define:TOBOS_SKILL>"() {
|
|
58
|
+
define_TOBOS_SKILL_default = { "SKILL.md": "---\nname: tobos-present\ndescription: Build presentations as code with Tobos Present. Use when the user wants a talk, lecture, pitch or slide deck made, changed, rendered, presented or exported as a PDF, or mentions Tobos or `tobos`.\n---\n\n<!-- Installed by the `tobos` CLI and overwritten when it updates, so changes made here don't last. -->\n\n# Tobos Present\n\nTobos hosts presentations written as code: a deck is a folder of files, one Svelte 5 file per scene, advancing one beat per click. You build it with the `tobos` command, which needs no git; Tobos checks every push, keeps every version, hosts the deck and puts it on stage. `tobos --help` lists every command, and each takes `--json`.\n\n## Get to the deck\n\n- `tobos ls` lists the decks the person can work on, by id. `tobos pull <id>` gets one; `tobos new \"Title\"` starts one and pulls it.\n- A new deck starts from Tobos standard's design. The person's own house styles are decks in `tobos ls`: start from one with `--from <id>`, which copies its master, and ask which when there are several.\n- Then read the deck's `AGENTS.md`: it points to the loop, the format and the deck's slide master.\n- The deck's outline, its chapters and scenes in order, their titles and which are hidden, isn't a file: Tobos holds it, and `tobos outline` shows and changes it, live at once. A new scene's file shows nowhere until `tobos outline place <scene>` puts it in. deck.json lists only the npm packages.\n- The person's decks are in folders, which `tobos --help` lists the commands for.\n\nExit code 3 means this machine isn't connected to the person's account. Run `tobos login`: it prints an address, which the person opens on any device, logs in at (a first login signs them up, and accepts https://tobos.ai/terms) and approves this machine. Give it to them in one line, then, once they did, run `tobos login` again. In CI or a sandbox with no one to ask, `TOBOS_TOKEN` and `TOBOS_SERVER` stand in for the login.\n\n## Follow the person\n\nThey decide what to make and how much of it you build: one scene at a time, or the whole deck at once. Build what they ask, at the size they ask, from what they have told you about the talk. When they ask how Tobos works or where to start, give them the tour, https://tobos.ai/tour, and nothing of your own: no explanation, no deck to try.\n\n## Folders\n\n- Look at the person's folders before you make or move a deck, and file it under a folder name they have already, as they wrote it, rather than a new one that means the same.\n- File every deck you make: once it is made, move it into the folder it belongs in.\n- Before you move more than a handful of decks, show the person the tree you propose, and make it once they say yes.\n- A reorganisation is taken back by moving the decks back where they were: note where they were before you move them.\n- A folder goes when it empties, by a move or a deck's deletion: there is no removing one. A folder with only archived decks in it isn't empty.\n\n## What stays the person's\n\n- **Exit code 5** is a limit or an archived deck. Show the person the message as it is, which says what they can do, and wait for their answer. The deck stays in Tobos: a deck built elsewhere to upload later, media shrunk or hosted elsewhere to fit, or someone else's account would decide for them what is theirs to decide.\n- **Archiving, opening again and deleting** a deck, and deleting a session's answers, are done by the person on the deck's page, in their own browser.\n- **Who is on a deck, and its link,** are the person's, on the deck's page: they put people on it, change what each may do, take them off, and turn the link on or off there. You neither see nor change any of it: `tobos ls` tells you only what you may do on each deck and whose it is. Can edit builds it with their own agent, can present presents it with its notes and polls and starts decks from its design, and can view sees the slides.\n- **Each scene's notes,** what the speaker says, are the person's: they write them under the stage on the deck's page, and the presenter sees them. You neither read nor write them, and a scene needs none from you.\n- **The URL `tobos open` prints** is the deck's page, where the person watches it, presents it and shares it. Presenting starts there alone: no link you can get presents the deck.\n" };
|
|
59
|
+
}
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
// <define:TOBOS_TOOLCHAIN>
|
|
63
|
+
var define_TOBOS_TOOLCHAIN_default;
|
|
64
|
+
var init_define_TOBOS_TOOLCHAIN = __esm({
|
|
65
|
+
"<define:TOBOS_TOOLCHAIN>"() {
|
|
66
|
+
define_TOBOS_TOOLCHAIN_default = { "svelte-check": "4.7.6", typescript: "6.0.3", svelte: "5.57.2", gsap: "3.15.0" };
|
|
67
|
+
}
|
|
68
|
+
});
|
|
69
|
+
|
|
70
|
+
// src/out.ts
|
|
71
|
+
init_define_TOBOS_PRESENT_TYPES();
|
|
72
|
+
init_define_TOBOS_SKILL();
|
|
73
|
+
init_define_TOBOS_TOOLCHAIN();
|
|
74
|
+
var EXIT = { ok: 0, error: 1, problems: 2, auth: 3, conflict: 4, limit: 5 };
|
|
75
|
+
var ASK_THE_PERSON = "This is for the person you work for to decide: show them the above, and wait for their answer. Don\u2019t work around it, for instance by building the deck outside Tobos.";
|
|
76
|
+
var CliError = class extends Error {
|
|
77
|
+
exit;
|
|
78
|
+
extra;
|
|
79
|
+
constructor(message, exit = EXIT.error, extra = {}) {
|
|
80
|
+
super(message);
|
|
81
|
+
this.exit = exit;
|
|
82
|
+
this.extra = extra;
|
|
83
|
+
}
|
|
84
|
+
};
|
|
85
|
+
var update;
|
|
86
|
+
function offerUpdate(line) {
|
|
87
|
+
update = line;
|
|
88
|
+
}
|
|
89
|
+
function createOutput(json) {
|
|
90
|
+
return {
|
|
91
|
+
json,
|
|
92
|
+
note(message, always = false) {
|
|
93
|
+
if (!json || always) process.stderr.write(`${message}
|
|
94
|
+
`);
|
|
95
|
+
},
|
|
96
|
+
result(value, human) {
|
|
97
|
+
if (json) process.stdout.write(`${JSON.stringify(update ? { ...value, update } : value)}
|
|
98
|
+
`);
|
|
99
|
+
else {
|
|
100
|
+
const text = human();
|
|
101
|
+
if (text) process.stdout.write(text.endsWith("\n") ? text : `${text}
|
|
102
|
+
`);
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
};
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
export {
|
|
109
|
+
__commonJS,
|
|
110
|
+
__export,
|
|
111
|
+
__toESM,
|
|
112
|
+
init_define_TOBOS_PRESENT_TYPES,
|
|
113
|
+
define_TOBOS_PRESENT_TYPES_default,
|
|
114
|
+
init_define_TOBOS_SKILL,
|
|
115
|
+
define_TOBOS_SKILL_default,
|
|
116
|
+
init_define_TOBOS_TOOLCHAIN,
|
|
117
|
+
define_TOBOS_TOOLCHAIN_default,
|
|
118
|
+
EXIT,
|
|
119
|
+
ASK_THE_PERSON,
|
|
120
|
+
CliError,
|
|
121
|
+
update,
|
|
122
|
+
offerUpdate,
|
|
123
|
+
createOutput
|
|
124
|
+
};
|
package/dist/cli.js
CHANGED
|
@@ -7,7 +7,7 @@ import {
|
|
|
7
7
|
mergeText,
|
|
8
8
|
parseMediaJson,
|
|
9
9
|
unpackTar
|
|
10
|
-
} from "./chunk-
|
|
10
|
+
} from "./chunk-YQCBNLI6.js";
|
|
11
11
|
import {
|
|
12
12
|
ASK_THE_PERSON,
|
|
13
13
|
CliError,
|
|
@@ -19,7 +19,7 @@ import {
|
|
|
19
19
|
init_define_TOBOS_TOOLCHAIN,
|
|
20
20
|
offerUpdate,
|
|
21
21
|
update
|
|
22
|
-
} from "./chunk-
|
|
22
|
+
} from "./chunk-FOAC7RGC.js";
|
|
23
23
|
|
|
24
24
|
// src/main.ts
|
|
25
25
|
init_define_TOBOS_PRESENT_TYPES();
|
|
@@ -269,7 +269,7 @@ function settings() {
|
|
|
269
269
|
}
|
|
270
270
|
|
|
271
271
|
// src/api.ts
|
|
272
|
-
var VERSION = true ? "0.4.
|
|
272
|
+
var VERSION = true ? "0.4.46" : "dev";
|
|
273
273
|
function newer(a, b) {
|
|
274
274
|
const parse = (v) => /^\d+\.\d+\.\d+/.test(v) ? v.split(".").map((n) => parseInt(n)) : null;
|
|
275
275
|
const x = parse(a);
|
|
@@ -1120,7 +1120,7 @@ async function check(out, args) {
|
|
|
1120
1120
|
);
|
|
1121
1121
|
const problems = [...written.problems];
|
|
1122
1122
|
if (args.values.types) {
|
|
1123
|
-
const { checkTypes } = await import("./types-
|
|
1123
|
+
const { checkTypes } = await import("./types-XI7ITVA3.js");
|
|
1124
1124
|
problems.push(...await checkTypes(copy.root, (m) => out.note(m)));
|
|
1125
1125
|
}
|
|
1126
1126
|
const { errors, warnings } = problemSummary(problems);
|
|
@@ -1325,7 +1325,7 @@ async function openApp(out) {
|
|
|
1325
1325
|
out.result({ url, opened }, () => url);
|
|
1326
1326
|
}
|
|
1327
1327
|
async function render(out, args) {
|
|
1328
|
-
const { renderBeats } = await import("./render-
|
|
1328
|
+
const { renderBeats } = await import("./render-FI5S3XNV.js");
|
|
1329
1329
|
const copy = findCopy();
|
|
1330
1330
|
const deck = copy?.base ? { id: copy.base.deck, root: copy.root } : void 0;
|
|
1331
1331
|
const id = typeof args.values.deck === "string" ? parseId(args.values.deck) : deck?.id;
|
|
@@ -3,7 +3,7 @@ import { createRequire as __tobosRequire } from 'node:module';
|
|
|
3
3
|
const require = __tobosRequire(import.meta.url);
|
|
4
4
|
import {
|
|
5
5
|
parseDeckJson
|
|
6
|
-
} from "./chunk-
|
|
6
|
+
} from "./chunk-YQCBNLI6.js";
|
|
7
7
|
import {
|
|
8
8
|
CliError,
|
|
9
9
|
__commonJS,
|
|
@@ -14,7 +14,7 @@ import {
|
|
|
14
14
|
init_define_TOBOS_PRESENT_TYPES,
|
|
15
15
|
init_define_TOBOS_SKILL,
|
|
16
16
|
init_define_TOBOS_TOOLCHAIN
|
|
17
|
-
} from "./chunk-
|
|
17
|
+
} from "./chunk-FOAC7RGC.js";
|
|
18
18
|
|
|
19
19
|
// ../node_modules/.pnpm/aria-query@5.3.1/node_modules/aria-query/lib/util/iteratorProxy.js
|
|
20
20
|
var require_iteratorProxy = __commonJS({
|
package/package.json
CHANGED
package/dist/chunk-G2X34YQC.js
DELETED
|
@@ -1,183 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
import { createRequire as __tobosRequire } from 'node:module';
|
|
3
|
-
const require = __tobosRequire(import.meta.url);
|
|
4
|
-
var __create = Object.create;
|
|
5
|
-
var __defProp = Object.defineProperty;
|
|
6
|
-
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
7
|
-
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
8
|
-
var __getProtoOf = Object.getPrototypeOf;
|
|
9
|
-
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
10
|
-
var __esm = (fn, res, err) => function __init() {
|
|
11
|
-
if (err) throw err[0];
|
|
12
|
-
try {
|
|
13
|
-
return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
|
|
14
|
-
} catch (e) {
|
|
15
|
-
throw err = [e], e;
|
|
16
|
-
}
|
|
17
|
-
};
|
|
18
|
-
var __commonJS = (cb, mod) => function __require() {
|
|
19
|
-
try {
|
|
20
|
-
return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
|
|
21
|
-
} catch (e) {
|
|
22
|
-
throw mod = 0, e;
|
|
23
|
-
}
|
|
24
|
-
};
|
|
25
|
-
var __export = (target, all) => {
|
|
26
|
-
for (var name in all)
|
|
27
|
-
__defProp(target, name, { get: all[name], enumerable: true });
|
|
28
|
-
};
|
|
29
|
-
var __copyProps = (to, from, except, desc) => {
|
|
30
|
-
if (from && typeof from === "object" || typeof from === "function") {
|
|
31
|
-
for (let key of __getOwnPropNames(from))
|
|
32
|
-
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
33
|
-
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
34
|
-
}
|
|
35
|
-
return to;
|
|
36
|
-
};
|
|
37
|
-
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
|
|
38
|
-
// If the importer is in node compatibility mode or this is not an ESM
|
|
39
|
-
// file that has been converted to a CommonJS file using a Babel-
|
|
40
|
-
// compatible transform (i.e. "__esModule" has not been set), then set
|
|
41
|
-
// "default" to the CommonJS "module.exports" for node compatibility.
|
|
42
|
-
isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
|
|
43
|
-
mod
|
|
44
|
-
));
|
|
45
|
-
|
|
46
|
-
// <define:TOBOS_PRESENT_TYPES>
|
|
47
|
-
var define_TOBOS_PRESENT_TYPES_default;
|
|
48
|
-
var init_define_TOBOS_PRESENT_TYPES = __esm({
|
|
49
|
-
"<define:TOBOS_PRESENT_TYPES>"() {
|
|
50
|
-
define_TOBOS_PRESENT_TYPES_default = { "registry.d.ts": "export declare function setMedia(media: Record<string, {\n hash: string;\n}>): void;\n/** The URL of a file in media/, what `import cow from '$media/cow.jpg'` gives. */\nexport declare function mediaUrl(name: string): string;\n/**\n * What `import.meta.glob('$media/cow/*.png')` gives: each file of media/ a pattern matches, by its\n * specifier (`$media/cow/a.png`), in order, with its URL. On a share, only those it has.\n */\nexport declare function mediaGlob(patterns: string[]): Record<string, string>;\n/** The deck's join code, and the ways to show it. */\nexport interface JoinInfo {\n /** The six digits: `482913`. */\n code: string;\n /** The link as people type it, without the scheme: `tobosusercontent.com/482913`. */\n link: string;\n /** The full URL the QR code holds: `https://tobosusercontent.com/482913`. */\n url: string;\n /** The QR code, black on white, as an image's address: `<img src={join.qr} />`. */\n qr: string;\n}\nexport declare function setJoin(info: JoinInfo | undefined): void;\nexport declare function joinInfo(): JoinInfo | undefined;\n/** Whether this is a share link's page, for people outside the deck's account. */\nexport declare function setShared(value: boolean): void;\nexport declare function isShared(): boolean;\n", "timeline.d.ts": "import type { Beat } from './index.ts';\n/**\n * Whether the scene timeline that holds this animation is playing a step forward, in real\n * time, as opposed to being sought (a jump, a step back, a finish, a still view or a render).\n */\nexport declare function playingForward(animation: gsap.core.Animation): boolean;\n/**\n * Whether the scene timeline that holds this animation is playing a step forward that may be\n * heard: one this window was moved to itself, not one it follows from another window.\n */\nexport declare function playingAloud(animation: gsap.core.Animation): boolean;\n/**\n * A sound that plays on through a range of a scene's beats, from the one that starts it up to,\n * not including, the one it stops at (playAudio's `until`).\n */\nexport interface Span {\n /** Play it from its start, heard. */\n start(): void;\n /** Stop it, fading it out or at once; resolves once it is silent. */\n stop(fade: boolean): Promise<void>;\n}\n/**\n * Add a span to the scene `tl` is the timeline of, while one of its beats' `enter` runs: from\n * that beat up to the one `until` names. False where `until` names no later beat of the scene.\n */\nexport declare function addSpan(tl: gsap.core.Timeline, until: string, span: Span): boolean;\n/**\n * One scene's beats as one paused GSAP timeline, with a label after each beat's animation.\n * Stepping forward tweens the playhead to the next label; everything else seeks.\n */\nexport declare class SceneTimeline {\n readonly timeline: gsap.core.Timeline;\n private labels;\n private tween;\n /** Whether the step playing may be heard. */\n aloud: boolean;\n private ids;\n /** The beat whose `enter` is running, while the timeline is built. */\n private building;\n private spans;\n /** The spans' stops still fading out. */\n private fades;\n constructor(root: Element, beats: readonly Beat[]);\n addSpan(until: string, span: Span): boolean;\n /**\n * Whether a span is still fading out: a scene leaving the stage is unmounted once it is\n * silent, since its sound goes with its elements.\n */\n get fading(): Promise<void> | null;\n get playing(): boolean;\n /** Finish the beat that is playing, at once. */\n finish(): void;\n /** Before the first beat: the scene waiting for its entrance. */\n hold(): void;\n /** The scene has left the stage: its spans fade out. */\n leave(): void;\n /**\n * After a move to `beat` (-1: none), each span plays on while the beat is in its range,\n * whichever way it moved there, and fades out outside it. Only a step forward onto its first\n * beat, heard, starts it.\n */\n private sound;\n /**\n * Show a beat: play the animation into it, or land on its end state. `aloud`: whether its\n * sound plays, or the step plays silent.\n */\n show(beat: number, animate: boolean, aloud?: boolean): void;\n /** Put the playhead part-way through the animation into a beat (0..1), for filmstrips. */\n sample(beat: number, progress: number): void;\n /** How long the animation into a beat takes, in seconds. */\n duration(beat: number): number;\n kill(): void;\n}\n", "playback.d.ts": "interface ClipOptions {\n /** Where the clip starts in the video or sound, in seconds. Default 0. */\n from?: number;\n /** Where the clip ends in the video or sound, in seconds. Default: its end. */\n to?: number;\n /** Speed: 1 is real time, 0.5 half speed. Default 1. */\n rate?: number;\n /**\n * When the clip starts within the beat: GSAP's position parameter (`'<'`, `'+=0.5'`, a\n * number). Default: after what the beat has animated so far, like any `tl.to`.\n */\n position?: gsap.Position;\n}\nexport interface PlayAudioOptions extends ClipOptions {\n /**\n * The beat the sound plays until. It plays on through the beats before it, whichever way the\n * presenter moves among them, and fades out when this beat or one outside the range is shown,\n * or the scene is left. The beat it starts in doesn't wait for it, and `to` and `position`\n * don't apply: it plays from `from` to its end, or until then.\n */\n until?: string;\n /** With `until`: how long it fades out, in seconds. Default 1; 0 stops it at once. */\n fade?: number;\n}\nexport interface PlayVideoOptions extends ClipOptions {\n /** Play the video's own sound with it. Default: muted. */\n sound?: boolean;\n}\n/**\n * Play a video (or the clip `from`\u2013`to` of it) as part of a beat. Stepping forward plays it in\n * real time; going back, jumping or reloading shows the frame for that position at once; a\n * click while it plays lands on its last frame. Before its beat it shows the clip's first frame.\n *\n * ```ts\n * { id: 'turn', enter: (tl, q) => playVideo(tl, q('video')) }\n * ```\n *\n * The video plays inline and preloads, and is muted unless `sound` is set. Several videos\n * (`q('video')` finding more than one) play side by side, each its own length.\n */\nexport declare function playVideo(tl: gsap.core.Timeline, target: Element | ArrayLike<Element> | null | undefined, options?: PlayVideoOptions): gsap.core.Timeline;\n/**\n * Play a sound (or the clip `from`\u2013`to` of it) as part of a beat. Stepping forward plays it in\n * real time; a click while it plays stops it and plays the next beat; going back, jumping or\n * reloading is silent. So is a scene mounted ahead, and a window that only follows another.\n *\n * ```ts\n * { id: 'listen', enter: (tl, q) => playAudio(tl, q('audio')) }\n * ```\n *\n * The sound preloads. Several (`q('audio')` finding more than one) play together, each its own\n * length.\n */\nexport declare function playAudio(tl: gsap.core.Timeline, target: Element | ArrayLike<Element> | null | undefined, options?: PlayAudioOptions): gsap.core.Timeline;\n/**\n * Call `listener` each time the browser refuses this window sound, until a click or key press\n * in it lets it play. Returns a function that stops listening.\n */\nexport declare function onSoundRefused(listener: () => void): () => void;\n/**\n * Wait until the videos and sounds inside `root` know their length, so `playVideo` and\n * `playAudio` can size their clips when the scene's timeline is built. Those that won't load (no\n * source, `preload=\"none\"`, an error) don't hold it up, nor does anything past `timeout`.\n */\nexport declare function mediaKnowTheirLength(root: Element, timeout?: number): Promise<void>;\n/**\n * Wait until every video inside `root` shows the frame it was last sought to: no seek pending,\n * a frame decoded, and that frame handed to the screen again (`repaint`). Videos that won't load\n * don't hold it up.\n */\nexport declare function videoFramesReady(root: Element): Promise<void>;\nexport {};\n", "deck/types.d.ts": "export type Severity = 'error' | 'warning';\n/** One thing wrong with a deck. Lines and columns are 1-based. */\nexport interface Problem {\n file: string;\n line?: number;\n column?: number;\n rule: string;\n message: string;\n severity: Severity;\n}\n/** A scene's place in the outline: its id, which is its file's name, its title and whether it shows. */\nexport interface OutlineScene {\n id: string;\n title: string;\n /** Left out of presenting, the share link and its PDF; still on the deck's page. */\n hidden?: true;\n}\nexport interface OutlineChapter {\n id: string;\n title: string;\n scenes: OutlineScene[];\n}\n/**\n * A deck's outline: its title, and its chapters and their scenes in order (ADR 0006). Data, held\n * by Tobos, never a file of the deck; Tobos's own decks keep theirs in `outline.json` in the\n * codebase, in this shape.\n */\nexport interface Outline {\n title: string;\n chapters: OutlineChapter[];\n}\n/** deck.json: what the deck's code needs, its packages. The outline isn't in it (ADR 0006). */\nexport interface DeckJson {\n dependencies?: Record<string, string>;\n}\nexport interface MediaEntry {\n hash: string;\n size: number;\n type: string;\n}\n/** media.json: path inside media/ \u2192 the file's content hash. */\nexport type MediaJson = Record<string, MediaEntry>;\n/** A multiple-choice poll: each phone picks one option; its result shows from `reveals` on. */\nexport interface ChoiceActivity {\n id: string;\n kind: 'choice';\n prompt: string;\n options: string[];\n /** The beat of its scene that closes the poll and shows its result. */\n reveals?: string;\n}\nexport interface TextField {\n id: string;\n label: string;\n multiline?: boolean;\n /** The most characters it takes. 500 unless the scene says otherwise; in a manifest, always set. */\n max?: number;\n}\n/** An open-text poll: each phone fills in its fields. The answers are only stored. */\nexport interface TextActivity {\n id: string;\n kind: 'text';\n prompt?: string;\n fields: TextField[];\n}\n/**\n * A poll: what a scene asks the room, who answer on their phones (the format's `activity`). It\n * is open while the deck is presented on its scene, up to its `reveals` beat.\n */\nexport type Activity = ChoiceActivity | TextActivity;\n/** A scene as the build has it: what its file is, whether or not the outline places it. */\nexport interface BuildScene {\n beats: string[];\n /** The scene's specifier in the import map. */\n module: string;\n activity?: Activity;\n}\nexport interface ManifestScene extends BuildScene {\n id: string;\n title: string;\n /** Left out of presenting, the share link and its PDF (the outline's `hidden`). */\n hidden?: true;\n}\nexport interface ManifestChapter {\n id: string;\n title: string;\n scenes: ManifestScene[];\n}\n/**\n * What a build makes of one revision of a deck, which the server stores with it: every scene file\n * by its id, placed or not, and what the viewer loads. The outline isn't part of it: it is joined\n * in when a manifest is read (joinOutline). Format 1's modules call the engine's media(); a later\n * one's import media (`import cow from '$media/cow.jpg'`), compiled into lookups of the same media\n * map. A revision keeps the format it was pushed with.\n */\nexport interface Build {\n format: 1 | 2;\n /** Each top-level `scenes/<id>.svelte` that exports beats, by its id. */\n scenes: Record<string, BuildScene>;\n /**\n * Deck specifiers (`@deck/scenes/a.svelte`) \u2192 module paths relative to the viewer (`m/<hash>.js`).\n * The server adds the package specifiers once it has bundled them (`d3` \u2192 `p/<bundle>/d3.js`).\n */\n imports: Record<string, string>;\n media: MediaJson;\n /** deck.json's dependencies: package \u2192 exact version. */\n dependencies: Record<string, string>;\n /** The package specifiers the deck imports, by dependency: `{ three: ['three', 'three/addons/\u2026'] }`. */\n packages: Record<string, string[]>;\n /**\n * Stylesheets, relative to the viewer: the master's tokens.css (`m/<hash>.css`), then those of\n * the packages it imports (`p/<bundle>/katex/dist/katex.min.css`), which the server adds.\n */\n styles?: string[];\n /**\n * What the deck's code uses of the deck, so a share gets only what the scenes it shows reach,\n * and only what is on a slide must be on the server (share.ts). A manifest pushed before the build recorded it\n * had it written in afterwards, as its build then would have (TOB-397).\n */\n uses: Uses;\n}\n/**\n * A build stored before the outline left deck.json (ADR 0006): the scenes deck.json listed, in\n * its chapters, and its title, instead of `scenes`. Read as a build (buildScenes), its outline\n * being the deck's now.\n */\nexport type LegacyBuild = Omit<Build, 'scenes'> & {\n title: string;\n chapters: ManifestChapter[];\n};\n/** A build as the server may have stored it: from now on, or from before ADR 0006. */\nexport type StoredBuild = Build | LegacyBuild;\n/**\n * What the viewer needs to show one revision of a deck: its build, with the deck's outline as it\n * is now joined in (joinOutline). Only the scenes both have are in it.\n */\nexport type Manifest = Omit<Build, 'scenes'> & {\n title: string;\n chapters: ManifestChapter[];\n};\n/** A manifest as a share link has it: what its modules use isn't part of it (share.ts). */\nexport type SharedManifest = Omit<Manifest, 'uses'>;\n/** What each of a deck's modules uses of the deck itself, and what its stylesheet does. */\nexport interface Uses {\n /**\n * By specifier (`@deck/scenes/a.svelte`): the deck's modules it imports, statically or not; the\n * media.json names it imports; and its `import.meta.glob` patterns (`frames/*.png`), or in format\n * 1 its media() calls' (share.ts), which a share matches against media.json, so a pattern is here\n * once, not as every name it matches. Each is left out when it has none.\n */\n modules: Record<string, {\n imports?: string[];\n media?: string[];\n patterns?: string[];\n }>;\n /** The media.json names tokens.css links, which every page that shows the deck loads. */\n styles: string[];\n}\n/** A deck's files, from a directory or from a git revision. Paths use `/` and have no leading slash. */\nexport interface DeckTree {\n files(): string[];\n read(path: string): Uint8Array | undefined;\n}\n", "activities.d.ts": "/** What the server tells about a deck's activities: phones what is open, the projector the results. */\n/** An activity as a phone needs it: no more. */\nexport type PhoneActivity = {\n id: string;\n kind: 'choice';\n prompt: string;\n options: string[];\n} | {\n id: string;\n kind: 'text';\n prompt?: string;\n fields: {\n id: string;\n label: string;\n multiline?: boolean;\n max: number;\n }[];\n};\n/** Nothing live, or the session and its open activity, if any. */\nexport type PhoneState = {\n live: false;\n} | {\n live: true;\n show: string;\n activity: PhoneActivity | null;\n};\n/** What the projector hears: the session, and every activity answered in it. */\nexport interface Results {\n show: string | null;\n joined: number;\n activities: Record<string, {\n answered: number;\n counts?: number[];\n }>;\n}\n", "viewer/stream.d.ts": "/**\n * A server-sent events stream that outlasts the server going away. EventSource reconnects by\n * itself only when a connection drops; when a reconnect is answered with an error, as the proxy\n * answers 502 while the app restarts for a release, it gives up for good. This one opens it\n * again, waiting longer each time, up to a minute.\n *\n * `onOpen` runs on every connection, `again` on all but the first: what was sent while the\n * stream was away is missed, so that is the moment to read the state afresh.\n */\nexport declare function stream(url: string, listeners: Record<string, (data: string) => void>, onOpen?: (again: boolean) => void): () => void;\n", "viewer/events.d.ts": 'type Listener = (data: string) => void;\ndeclare const TYPES: readonly ["push", "results", "notes"];\nexport type EventType = (typeof TYPES)[number];\n/** Listen for one type of event on `url`, the window\'s stream: until the returned function runs. */\nexport declare function listen(url: string, type: EventType, listener: Listener, onReopen?: () => void): () => void;\nexport {};\n', "responses.svelte.d.ts": "/**\n * What the room has answered, for the projector: the audience and presenter windows, and the\n * preview on the deck's page, follow it from the server. Print and render, and a link that isn't\n * a presenter's, have zeros. It is live data, which the position can't recreate.\n */\nimport type { SharedManifest } from '@tobos/deck/types';\nimport type { Results } from './activities.ts';\n/** One activity's responses in the current session. */\nexport interface Responses {\n /**\n * The most phones that had the deck's join link open at once during this session, and never fewer\n * than answered.\n */\n readonly joined: number;\n /** People who have answered this activity during this session. */\n readonly answered: number;\n /** Multiple choice's responses per option, in the order the scene declares them; else empty. */\n readonly counts: number[];\n}\n/** The deck's activities, so a poll nobody answered yet has a zero per option. */\nexport declare function setActivities(manifest: SharedManifest): void;\n/** The current session's responses: reactive, for a scene or the presenter's view. */\nexport declare function liveResults(): Readonly<Results>;\n/**\n * The room's responses to an activity of this deck in the current session: how many joined, how\n * many answered, and a poll's counts per option. Call during component setup.\n */\nexport declare function useResponses(id: string): Responses;\n/** Follow the room's results on the window's stream (events.ts) until the returned function runs. */\nexport declare function followResponses(url: string): () => void;\n", "index.d.ts": `import { type Component } from 'svelte';
|
|
51
|
-
import { type JoinInfo } from './registry.ts';
|
|
52
|
-
export { playAudio, playVideo, type PlayAudioOptions, type PlayVideoOptions } from './playback.ts';
|
|
53
|
-
export { useResponses, type Responses } from './responses.svelte.ts';
|
|
54
|
-
export type { Activity, ChoiceActivity, TextActivity, TextField } from '@tobos/deck/types';
|
|
55
|
-
/** Finds elements inside the current scene only. */
|
|
56
|
-
export type Query = (selector: string) => Element[];
|
|
57
|
-
/** One click's worth of a scene: an ID, and the animation into it. */
|
|
58
|
-
export interface Beat {
|
|
59
|
-
id: string;
|
|
60
|
-
/** Add the animation into this beat to the scene's timeline. */
|
|
61
|
-
enter?: (tl: gsap.core.Timeline, q: Query) => unknown;
|
|
62
|
-
}
|
|
63
|
-
/** The props the engine passes to every scene. */
|
|
64
|
-
export interface SceneProps {
|
|
65
|
-
/** The current beat's ID. */
|
|
66
|
-
beat: string;
|
|
67
|
-
/** The current beat's index in the scene, from 0. */
|
|
68
|
-
index: number;
|
|
69
|
-
}
|
|
70
|
-
/** Where a scene sits in the deck, for layouts that show it (a wayfinder, an agenda). */
|
|
71
|
-
export interface DeckContext {
|
|
72
|
-
title: string;
|
|
73
|
-
chapters: {
|
|
74
|
-
id: string;
|
|
75
|
-
title: string;
|
|
76
|
-
scenes: {
|
|
77
|
-
id: string;
|
|
78
|
-
title: string;
|
|
79
|
-
}[];
|
|
80
|
-
}[];
|
|
81
|
-
chapter: {
|
|
82
|
-
id: string;
|
|
83
|
-
title: string;
|
|
84
|
-
};
|
|
85
|
-
scene: {
|
|
86
|
-
id: string;
|
|
87
|
-
title: string;
|
|
88
|
-
};
|
|
89
|
-
}
|
|
90
|
-
export declare const DECK_CONTEXT = "tobos:deck";
|
|
91
|
-
/** The deck, its chapters and the current scene. Call during component setup. */
|
|
92
|
-
export declare function useDeck(): DeckContext;
|
|
93
|
-
export type { JoinInfo } from './registry.ts';
|
|
94
|
-
/**
|
|
95
|
-
* The deck's join code, for a scene to show its own way: the digits, the link as people type
|
|
96
|
-
* it, the full URL, and the QR code as an image's address. Undefined while the deck has no
|
|
97
|
-
* activity.
|
|
98
|
-
*/
|
|
99
|
-
export declare function useJoin(): JoinInfo | undefined;
|
|
100
|
-
export interface JoinCodeProps {
|
|
101
|
-
/** The QR code's width and height, in stage pixels. */
|
|
102
|
-
size?: number;
|
|
103
|
-
}
|
|
104
|
-
/**
|
|
105
|
-
* The deck's join code: a QR code, and under it the link it holds, which phones open to answer
|
|
106
|
-
* the deck's activities. The scene sizes it; the link takes the scene's font.
|
|
107
|
-
*/
|
|
108
|
-
export declare const JoinCode: Component<JoinCodeProps>;
|
|
109
|
-
`, "media.d.ts": "// What a deck's code may write of media/, besides the engine's API: `tobos check --types`\n// declares it beside the engine's types (cli/build.ts), as the build compiles it\n// (deck/src/media-imports.ts).\n\n/** A file of media/: its URL. `import cow from '$media/cow.jpg'` */\ndeclare module '$media/*' {\n const url: string;\n export default url;\n}\n\ninterface ImportMeta {\n /**\n * The files of media/ a pattern matches, `import.meta.glob('$media/cow/*.png')`: each file's\n * URL by its specifier (`'$media/cow/a.png'`), in order. `*` matches within a folder's name, a\n * `**` folder any number of folders. The pattern is a string literal, or an array of them.\n */\n glob(pattern: string | string[]): Record<string, string>;\n}\n" };
|
|
110
|
-
}
|
|
111
|
-
});
|
|
112
|
-
|
|
113
|
-
// <define:TOBOS_SKILL>
|
|
114
|
-
var define_TOBOS_SKILL_default;
|
|
115
|
-
var init_define_TOBOS_SKILL = __esm({
|
|
116
|
-
"<define:TOBOS_SKILL>"() {
|
|
117
|
-
define_TOBOS_SKILL_default = { "SKILL.md": "---\nname: tobos-present\ndescription: Build presentations as code with Tobos Present. Use when the user wants a talk, lecture, pitch or slide deck made, changed, rendered, presented or exported as a PDF, or mentions Tobos or `tobos`.\n---\n\n<!-- Installed by the `tobos` CLI and overwritten when it updates, so changes made here don't last. -->\n\n# Tobos Present\n\nTobos hosts presentations written as code: a deck is a folder of files, one Svelte 5 file per scene, advancing one beat per click. You build it with the `tobos` command, which needs no git; Tobos checks every push, keeps every version, hosts the deck and puts it on stage. `tobos --help` lists every command, and each takes `--json`.\n\n## Get to the deck\n\n- `tobos ls` lists the decks the person can work on, by id. `tobos pull <id>` gets one; `tobos new \"Title\"` starts one and pulls it.\n- A new deck starts from Tobos standard's design. The person's own house styles are decks in `tobos ls`: start from one with `--from <id>`, which copies its master, and ask which when there are several.\n- Then read the deck's `AGENTS.md`: it points to the loop, the format and the deck's slide master.\n- The deck's outline, its chapters and scenes in order, their titles and which are hidden, isn't a file: Tobos holds it, and `tobos outline` shows and changes it, live at once. A new scene's file shows nowhere until `tobos outline place <scene>` puts it in. deck.json lists only the npm packages.\n- The person's decks are in folders, which `tobos --help` lists the commands for.\n\nExit code 3 means this machine isn't connected to the person's account. Run `tobos login`: it prints an address, which the person opens on any device, logs in at (a first login signs them up, and accepts https://tobos.ai/terms) and approves this machine. Give it to them in one line, then, once they did, run `tobos login` again. In CI or a sandbox with no one to ask, `TOBOS_TOKEN` and `TOBOS_SERVER` stand in for the login.\n\n## Follow the person\n\nThey decide what to make and how much of it you build: one scene at a time, or the whole deck at once. Build what they ask, at the size they ask, from what they have told you about the talk. When they ask how Tobos works or where to start, give them the tour, https://tobos.ai/tour, and nothing of your own: no explanation, no deck to try.\n\n## Folders\n\n- Look at the person's folders before you make or move a deck, and file it under a folder name they have already, as they wrote it, rather than a new one that means the same.\n- File every deck you make: once it is made, move it into the folder it belongs in.\n- Before you move more than a handful of decks, show the person the tree you propose, and make it once they say yes.\n- A reorganisation is taken back by moving the decks back where they were: note where they were before you move them.\n- A folder goes when it empties, by a move or a deck's deletion: there is no removing one. A folder with only archived decks in it isn't empty.\n\n## What stays the person's\n\n- **Exit code 5** is a limit or an archived deck. Show the person the message as it is, which says what they can do, and wait for their answer. The deck stays in Tobos: a deck built elsewhere to upload later, media shrunk or hosted elsewhere to fit, or someone else's account would decide for them what is theirs to decide.\n- **Archiving, opening again and deleting** a deck, and deleting a session's answers, are done by the person on the deck's page, in their own browser.\n- **Who is on a deck, and its link,** are the person's, on the deck's page: they put people on it, change what each may do, take them off, and turn the link on or off there. You neither see nor change any of it: `tobos ls` tells you only what you may do on each deck and whose it is. Can edit builds it with their own agent, can present presents it with its notes and polls and starts decks from its design, and can view sees the slides.\n- **Each scene's notes,** what the speaker says, are the person's: they write them under the stage on the deck's page, and the presenter sees them. You neither read nor write them, and a scene needs none from you.\n- **The URL `tobos open` prints** is the deck's page, where the person watches it, presents it and shares it. Presenting starts there alone: no link you can get presents the deck.\n" };
|
|
118
|
-
}
|
|
119
|
-
});
|
|
120
|
-
|
|
121
|
-
// <define:TOBOS_TOOLCHAIN>
|
|
122
|
-
var define_TOBOS_TOOLCHAIN_default;
|
|
123
|
-
var init_define_TOBOS_TOOLCHAIN = __esm({
|
|
124
|
-
"<define:TOBOS_TOOLCHAIN>"() {
|
|
125
|
-
define_TOBOS_TOOLCHAIN_default = { "svelte-check": "4.7.6", typescript: "6.0.3", svelte: "5.57.2", gsap: "3.15.0" };
|
|
126
|
-
}
|
|
127
|
-
});
|
|
128
|
-
|
|
129
|
-
// src/out.ts
|
|
130
|
-
init_define_TOBOS_PRESENT_TYPES();
|
|
131
|
-
init_define_TOBOS_SKILL();
|
|
132
|
-
init_define_TOBOS_TOOLCHAIN();
|
|
133
|
-
var EXIT = { ok: 0, error: 1, problems: 2, auth: 3, conflict: 4, limit: 5 };
|
|
134
|
-
var ASK_THE_PERSON = "This is for the person you work for to decide: show them the above, and wait for their answer. Don\u2019t work around it, for instance by building the deck outside Tobos.";
|
|
135
|
-
var CliError = class extends Error {
|
|
136
|
-
exit;
|
|
137
|
-
extra;
|
|
138
|
-
constructor(message, exit = EXIT.error, extra = {}) {
|
|
139
|
-
super(message);
|
|
140
|
-
this.exit = exit;
|
|
141
|
-
this.extra = extra;
|
|
142
|
-
}
|
|
143
|
-
};
|
|
144
|
-
var update;
|
|
145
|
-
function offerUpdate(line) {
|
|
146
|
-
update = line;
|
|
147
|
-
}
|
|
148
|
-
function createOutput(json) {
|
|
149
|
-
return {
|
|
150
|
-
json,
|
|
151
|
-
note(message, always = false) {
|
|
152
|
-
if (!json || always) process.stderr.write(`${message}
|
|
153
|
-
`);
|
|
154
|
-
},
|
|
155
|
-
result(value, human) {
|
|
156
|
-
if (json) process.stdout.write(`${JSON.stringify(update ? { ...value, update } : value)}
|
|
157
|
-
`);
|
|
158
|
-
else {
|
|
159
|
-
const text = human();
|
|
160
|
-
if (text) process.stdout.write(text.endsWith("\n") ? text : `${text}
|
|
161
|
-
`);
|
|
162
|
-
}
|
|
163
|
-
}
|
|
164
|
-
};
|
|
165
|
-
}
|
|
166
|
-
|
|
167
|
-
export {
|
|
168
|
-
__commonJS,
|
|
169
|
-
__export,
|
|
170
|
-
__toESM,
|
|
171
|
-
init_define_TOBOS_PRESENT_TYPES,
|
|
172
|
-
define_TOBOS_PRESENT_TYPES_default,
|
|
173
|
-
init_define_TOBOS_SKILL,
|
|
174
|
-
define_TOBOS_SKILL_default,
|
|
175
|
-
init_define_TOBOS_TOOLCHAIN,
|
|
176
|
-
define_TOBOS_TOOLCHAIN_default,
|
|
177
|
-
EXIT,
|
|
178
|
-
ASK_THE_PERSON,
|
|
179
|
-
CliError,
|
|
180
|
-
update,
|
|
181
|
-
offerUpdate,
|
|
182
|
-
createOutput
|
|
183
|
-
};
|