Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
feat(distribution): publish under @hypit/hypit and unify studio command
kashorinbb1af2996fc6
diff --git a/bin/hypit-studio.mjs b/bin/hypit-studio.mjsdeleted file mode 100755index 8c2ccadd..00000000--- a/bin/hypit-studio.mjs+++ /dev/null@@ -1,20 +0,0 @@-#!/usr/bin/env node--import { register } from "tsx/esm/api";-import { dirname, resolve } from "node:path";-import { fileURLToPath } from "node:url";--// Keep author-relative paths anchored to the caller even though Studio itself-// is executed from the replaceable Hypit Distribution checkout.-process.env.INIT_CWD ??= process.cwd();-const distributionRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");-process.env.HYPIT_DISTRIBUTION_ROOT ??= distributionRoot;-register();-const {- installDistributionPackageResolution,- installExternalPackageResolution,-} = await import("../packages/package-loader-node/src/distribution-resolution.ts");-installDistributionPackageResolution([distributionRoot]);-const { hypitHostPackageRoot } = await import("../packages/runtime-host-node/src/index.ts");-installExternalPackageResolution([hypitHostPackageRoot()]);-await import("../packages/studio/start.ts");diff --git a/bin/hypit.mjs b/bin/hypit.mjsindex b12ab643..0b63931a 100755--- a/bin/hypit.mjs+++ b/bin/hypit.mjs@@ -29,4 +29,18 @@ const {installDistributionPackageResolution([distributionRoot]);const { hypitHostPackageRoot } = await import("../packages/runtime-host-node/src/index.ts");installExternalPackageResolution([hypitHostPackageRoot()]);-await import("../packages/video-cli/src/cli.ts");+const args = process.argv.slice(2);+if (args[0] === "studio" || (args[0] === "help" && args[1] === "studio")) {+ const { runStudio } = await import("../packages/studio/start.ts");+ try {+ await runStudio(args[0] === "help" ? ["--help"] : args.slice(1).filter((arg) => arg !== "--debug"), {+ write: (text) => process.stdout.write(text),+ });+ } catch (error) {+ const { renderCliError } = await import("../packages/cli/src/index.ts");+ process.stderr.write(renderCliError(error, { debug: args.includes("--debug") }));+ process.exitCode = 1;+ }+} else {+ await import("../packages/video-cli/src/cli.ts");+}diff --git a/docs/guide/author-packages.md b/docs/guide/author-packages.mdindex bb3c159a..9252210c 100644--- a/docs/guide/author-packages.md+++ b/docs/guide/author-packages.md@@ -12,7 +12,7 @@ with independent captions remaining separate.## Start from a complete package-The installed `hypit` Distribution includes+The installed `@hypit/hypit` Distribution includes[`examples/minimal-author-package/packages/example-component`](https://github.com/hypit-ai/hypit/tree/main/examples/minimal-author-package/packages/example-component).Copy that directory into your video's `packages/` directory. Give its package and Module your ownscope and name, and replace the fixture's `workspace:*` Hypit development dependency with the@@ -21,7 +21,7 @@ Distribution release used by the project.From the copied package directory:```bash-npm install --save-dev hypit@<selected-release>+npm install --save-dev @hypit/hypit@<selected-release>npm run build```@@ -50,7 +50,7 @@ chosen names and the accepted values in the component's own vocabulary and READM## Implement and inspect the scene-Use `hypit/author-kit` for the author package API and public domain subpaths for the values you+Use `@hypit/hypit/author-kit` for the author package API and public domain subpaths for the values youconsume. [Component Anatomy](./component-anatomy.md) explains how the Manifest, Surface, Fragment andProducer cooperate. Keep project copy and media as inputs; draw the component's own panels, framesand decoration in its implementation.diff --git a/docs/guide/conventions.md b/docs/guide/conventions.mdindex 231d4ebc..ddb023b0 100644--- a/docs/guide/conventions.md+++ b/docs/guide/conventions.md@@ -5,7 +5,7 @@ description: Naming, module boundaries, TypeScript configuration and wire data.# Conventions-These conventions describe work inside the Hypit repository. Project extensions use their owner's scope and the public `hypit/*` SDK subpaths; see [Packages and Extension](./packages.md).+These conventions describe work inside the Hypit repository. Project extensions use their owner's scope and the public `@hypit/hypit/*` SDK subpaths; see [Packages and Extension](./packages.md).## Namingdiff --git a/docs/guide/packages.md b/docs/guide/packages.mdindex 4a961368..6a50f077 100644--- a/docs/guide/packages.md+++ b/docs/guide/packages.md@@ -18,7 +18,7 @@ interface and implementation; the execution system runs the resulting dependency| Provider Endpoint | Executes supported requests through an API or local tool | Runtime Profile || Credential store | Resolves the named credentials for an Endpoint | Runtime Profile || Result repository | Keeps a project's Build records and produced files | Project Result configuration |-| Distribution | Supplies the executable applications and official packages | Installed `hypit` release |+| Distribution | Supplies the executable applications and official packages | Installed `@hypit/hypit` release |For example, a Model describes a requested video, while a Provider maps that request to a service.A ranking component describes how a board behaves, while the renderer draws its contribution into@@ -43,7 +43,7 @@ The consumer installs a chosen version and keeps its lockfile with the project.## Installation and Source importsThe Skill, executable Distribution and video project are installed and updated separately. The-`hypit` Distribution includes the official author packages and public extension APIs. Its selected+`@hypit/hypit` Distribution includes the official author packages and public extension APIs. Its selectedRuntime adapters can prepare additional service dependencies through `hypit runtime up`; optionalauthor assets can be installed with the precise `hypit packages install` command reported by the CLI.A project's own component dependencies are managed in that project.@@ -55,8 +55,8 @@ install them.## Write and share an extension-An external package develops against public subpaths such as `hypit/author-kit`,-`hypit/composition`, `hypit/model-kit` or `hypit/endpoint-kit`. Use the selected `hypit` release as a+An external package develops against public subpaths such as `@hypit/hypit/author-kit`,+`@hypit/hypit/composition`, `@hypit/hypit/model-kit` or `@hypit/hypit/endpoint-kit`. Use the selected `@hypit/hypit` release as adevelopment dependency, compile the extension to JavaScript, and ship its own code and assets. Its`package.json` names an activation entry describing what it provides. The active Distributionsupplies the public Hypit APIs when it loads the selected extension.diff --git a/docs/guide/providers.md b/docs/guide/providers.mdindex 7f7b06e4..eba5fe9c 100644--- a/docs/guide/providers.md+++ b/docs/guide/providers.md@@ -29,7 +29,7 @@ preparing their dependencies. [Runs and Builds](../quickstart/run.md) shows the## Add a Model-Develop a project package against `hypit/model-kit`, `hypit/generation` and `hypit/author-kit`.+Develop a project package against `@hypit/hypit/model-kit`, `@hypit/hypit/generation` and `@hypit/hypit/author-kit`.Declare the exact request ports, parameter values, result type and capability. Its author Surfaceconnects prompt Text and reference media to the request, then publishes the resulting media as anormal graph Output.@@ -40,11 +40,11 @@ HTTP mapping belong to the Provider.## Add a Provider-Use the selected `hypit` release as a development dependency and import the public SDK:+Use the selected `@hypit/hypit` release as a development dependency and import the public SDK:```ts-import { defineEndpointPackage } from "hypit/endpoint-kit";-import type { AsyncEndpoint, CredentialRef, EndpointRequest } from "hypit/endpoint-kit";+import { defineEndpointPackage } from "@hypit/hypit/endpoint-kit";+import type { AsyncEndpoint, CredentialRef, EndpointRequest } from "@hypit/hypit/endpoint-kit";```Implement the exact capabilities and result types the service supports. Map request ports to thediff --git a/docs/quickstart/preview.md b/docs/quickstart/preview.mdindex 6946e29d..99a631f6 100644--- a/docs/quickstart/preview.md+++ b/docs/quickstart/preview.md@@ -13,7 +13,7 @@ It is also a useful way to hand over a finished project alongside the exported v```bashcd /path/to/my-video-hypit-studio --run build.svrun+hypit studio --run build.svrun```Open the address printed by the command. Studio uses the Author Source and material selected indiff --git a/docs/zh/guide/author-packages.md b/docs/zh/guide/author-packages.mdindex edff98b3..70333446 100644--- a/docs/zh/guide/author-packages.md+++ b/docs/zh/guide/author-packages.md@@ -9,12 +9,12 @@ description: 制作项目组件、将其用于视频,并在有需要时分享## 从完整的包开始-安装的 `hypit` Distribution 包含 [`examples/minimal-author-package/packages/example-component`](https://github.com/hypit-ai/hypit/tree/main/examples/minimal-author-package/packages/example-component)。将该目录复制到视频项目的 `packages/`,把包名与 Module 改为自己的 scope 和名称,将示例中的 `workspace:*` Hypit 开发依赖改成项目所用的 Distribution 版本。+安装的 `@hypit/hypit` Distribution 包含 [`examples/minimal-author-package/packages/example-component`](https://github.com/hypit-ai/hypit/tree/main/examples/minimal-author-package/packages/example-component)。将该目录复制到视频项目的 `packages/`,把包名与 Module 改为自己的 scope 和名称,将示例中的 `workspace:*` Hypit 开发依赖改成项目所用的 Distribution 版本。在复制后的包目录执行:```bash-npm install --save-dev hypit@<selected-release>+npm install --save-dev @hypit/hypit@<selected-release>npm run build```@@ -30,7 +30,7 @@ Style 一类 Surface 在裸作者 id 下公开其值,例如 `style={board-styl## 实现并查看场景-作者包 API 使用 `hypit/author-kit`,消费的领域值使用对应公开子路径。[组件结构](./component-anatomy.md) 介绍 Manifest、Surface、Fragment 和 Producer 如何配合。项目文案与素材作为输入,组件自己的面板、边框与装饰由实现绘制。+作者包 API 使用 `@hypit/hypit/author-kit`,消费的领域值使用对应公开子路径。[组件结构](./component-anatomy.md) 介绍 Manifest、Surface、Fragment 和 Producer 如何配合。项目文案与素材作为输入,组件自己的面板、边框与装饰由实现绘制。preview Source 为作者提供可打开或渲染的小例子。查看能说明行为的状态:进入、关键变化、停留布局和退出。也要在实际编排中查看,这时内容、空间和时机才有具体用途。diff --git a/docs/zh/guide/conventions.md b/docs/zh/guide/conventions.mdindex 84e285bb..bdc9f86a 100644--- a/docs/zh/guide/conventions.md+++ b/docs/zh/guide/conventions.md@@ -5,7 +5,7 @@ description: 命名、模块边界、TypeScript 配置与 wire 数据。# 代码规范-这些规范面向 Hypit 仓库内的工作。项目扩展使用所有者自己的 scope 和公开的 `hypit/*` SDK 子路径,见 [包与扩展](./packages.md)。+这些规范面向 Hypit 仓库内的工作。项目扩展使用所有者自己的 scope 和公开的 `@hypit/hypit/*` SDK 子路径,见 [包与扩展](./packages.md)。## 命名diff --git a/docs/zh/guide/packages.md b/docs/zh/guide/packages.mdindex 29f3b99f..03274033 100644--- a/docs/zh/guide/packages.md+++ b/docs/zh/guide/packages.md@@ -30,13 +30,13 @@ Hypit 把视频需要什么,与哪些代码和服务完成它,分别表达## 安装与 Source 导入-Skill、可执行 Distribution 和视频项目分别安装与更新。`hypit` Distribution 包含官方作者包和公开扩展 API。所选 Runtime Adapter 可以通过 `hypit runtime up` 准备额外服务依赖;可选作者素材可以按 CLI 给出的准确 `hypit packages install` 命令安装。项目组件自己的依赖由项目管理。+Skill、可执行 Distribution 和视频项目分别安装与更新。`@hypit/hypit` Distribution 包含官方作者包和公开扩展 API。所选 Runtime Adapter 可以通过 `hypit runtime up` 准备额外服务依赖;可选作者素材可以按 CLI 给出的准确 `hypit packages install` 命令安装。项目组件自己的依赖由项目管理。Source 使用 `@your-studio/scoreboard@1` 这样的逻辑 Module 地址。npm 安装的包版本决定实际实现,逻辑 `@1` 标识作者接口。视频 Build 使用这些已安装的版本;缺包时会报告安装所需的信息。## 编写与分享扩展-外部包使用 `hypit/author-kit`、`hypit/composition`、`hypit/model-kit` 或 `hypit/endpoint-kit` 等公开子路径。将选定的 `hypit` 版本作为开发依赖,把扩展编译为 JavaScript,分发它自己的代码与素材。`package.json` 中的 activation 入口描述它提供的能力;加载选中的扩展时,当前 Distribution 提供公开 Hypit API。+外部包使用 `@hypit/hypit/author-kit`、`@hypit/hypit/composition`、`@hypit/hypit/model-kit` 或 `@hypit/hypit/endpoint-kit` 等公开子路径。将选定的 `@hypit/hypit` 版本作为开发依赖,把扩展编译为 JavaScript,分发它自己的代码与素材。`package.json` 中的 activation 入口描述它提供的能力;加载选中的扩展时,当前 Distribution 提供公开 Hypit API。- [添加作者包](./author-packages.md):从随发行包提供的可构建组件开始。- [组件结构](./component-anatomy.md):组件内部各部分的职责。diff --git a/docs/zh/guide/providers.md b/docs/zh/guide/providers.mdindex 66a0552b..498a0c7a 100644--- a/docs/zh/guide/providers.md+++ b/docs/zh/guide/providers.md@@ -22,17 +22,17 @@ description: 选择账户、连接服务或添加模型,沿用同一套视频## 添加 Model-项目包使用 `hypit/model-kit`、`hypit/generation` 和 `hypit/author-kit`。声明准确的请求端口、参数取值、输出类型和能力。作者 Surface 把 Prompt Text 与参考素材连接到请求,再将生成素材作为普通图输出公开。+项目包使用 `@hypit/hypit/model-kit`、`@hypit/hypit/generation` 和 `@hypit/hypit/author-kit`。声明准确的请求端口、参数取值、输出类型和能力。作者 Surface 把 Prompt Text 与参考素材连接到请求,再将生成素材作为普通图输出公开。[Model SDK](https://github.com/hypit-ai/hypit/blob/main/packages/model-kit/README.md) 提供请求定义与 activation 示例。包拥有模型接口;凭据与 HTTP 映射由 Provider 负责。## 添加 Provider-将选定的 `hypit` 版本作为开发依赖,使用公开 SDK:+将选定的 `@hypit/hypit` 版本作为开发依赖,使用公开 SDK:```ts-import { defineEndpointPackage } from "hypit/endpoint-kit";-import type { AsyncEndpoint, CredentialRef, EndpointRequest } from "hypit/endpoint-kit";+import { defineEndpointPackage } from "@hypit/hypit/endpoint-kit";+import type { AsyncEndpoint, CredentialRef, EndpointRequest } from "@hypit/hypit/endpoint-kit";```实现服务支持的准确能力与输出类型,将请求端口映射到服务 API,解析声明的凭据并返回结果。即时操作可以直接返回;远程任务可以先提交得到 ID,再轮询完成情况、收集输出文件。并发和动作限制由 Endpoint 的资源声明负责。diff --git a/docs/zh/quickstart/preview.md b/docs/zh/quickstart/preview.mdindex 909e675e..f81b39ae 100644--- a/docs/zh/quickstart/preview.md+++ b/docs/zh/quickstart/preview.md@@ -11,7 +11,7 @@ Studio 在浏览器中打开可编辑的视频项目。你可以播放编排、```bashcd /path/to/my-video-hypit-studio --run build.svrun+hypit studio --run build.svrun```打开命令打印的网址。Studio 使用这份 Run 选择的 Author Source 和素材。编辑时要保留已生成素材,可以通过 [`build-record` 与 `satisfy`](./run.md) 选择已完成的 Output。diff --git a/examples/minimal-author-package/packages/example-component/README.md b/examples/minimal-author-package/packages/example-component/README.mdindex 78b45e4b..8628d3b0 100644--- a/examples/minimal-author-package/packages/example-component/README.md+++ b/examples/minimal-author-package/packages/example-component/README.md@@ -1,15 +1,15 @@# Example component fixtureA small complete package for learning Manifest, Surface, Fragment, Producer and activation wiring. Framework-facing imports come from-`hypit/author-kit`; video-domain imports use their owning `hypit/*` subpaths. Its only Hypit-framework dependency is the released `hypit` Distribution; TypeScript and Node types are ordinary+`@hypit/hypit/author-kit`; video-domain imports use their owning `@hypit/hypit/*` subpaths. Its only Hypit+framework dependency is the released `@hypit/hypit` Distribution; TypeScript and Node types are ordinarybuild tooling. No Runtime dependency is bundled into its tarball.It contains a Module Manifest with nominal Types and deterministic Producers, validators, a structuredSurface decoder returning `records`, `components`, `fragments` and `exports`, and sealed Fragments withliteral `fragment-input`, `fragment-operation` and `output` references. `src/temporal.ts` shows the-Surface-side `hypit/temporal-markup` Window/Moment projections; that package is distinct from the-graph-side `hypit/temporal` Producers.+Surface-side `@hypit/hypit/temporal-markup` Window/Moment projections; that package is distinct from the+graph-side `@hypit/hypit/temporal` Producers.The Surfaces demonstrate a box, a text surface, a media slot and a Style decoder. The slot is a graphinput; it is not a file bundled by the package. `preview/Box.png` is a real catalogue frame supplied@@ -29,7 +29,7 @@ name. The checked-in fixture's `workspace:*` dependency connects it to the reposdevelopment. In the copied package, replace that development dependency with the selected release:```bash-npm install --save-dev hypit@<selected-release>+npm install --save-dev @hypit/hypit@<selected-release>npm run buildnpm pack```diff --git a/examples/minimal-author-package/packages/example-component/package.json b/examples/minimal-author-package/packages/example-component/package.jsonindex 3075ee9e..56ef6198 100644--- a/examples/minimal-author-package/packages/example-component/package.json+++ b/examples/minimal-author-package/packages/example-component/package.json@@ -21,7 +21,7 @@},"devDependencies": {"@types/node": "24.10.1",- "hypit": "workspace:*",+ "@hypit/hypit": "workspace:*","typescript": "5.9.3"}}diff --git a/examples/minimal-author-package/packages/example-component/src/activation.ts b/examples/minimal-author-package/packages/example-component/src/activation.tsindex a9259005..147e6828 100644--- a/examples/minimal-author-package/packages/example-component/src/activation.ts+++ b/examples/minimal-author-package/packages/example-component/src/activation.ts@@ -1,4 +1,4 @@-import { createMarkupSurfaceHostFacet } from "hypit/author-kit";+import { createMarkupSurfaceHostFacet } from "@hypit/hypit/author-kit";import { decodeExampleSurface, exampleComponent, exampleManifest, exampleMarkupSurfaces, exampleModuleRef } from "./index.js";export const hypitPackage = {diff --git a/examples/minimal-author-package/packages/example-component/src/component.ts b/examples/minimal-author-package/packages/example-component/src/component.tsindex 7a5a120b..e117a9a1 100644--- a/examples/minimal-author-package/packages/example-component/src/component.ts+++ b/examples/minimal-author-package/packages/example-component/src/component.ts@@ -1,8 +1,8 @@-import { sealVisualTrack } from "hypit/composition";-import type { ProgramSpace } from "hypit/program-space";-import { canonicalize } from "hypit/author-kit";-import type { BlobRef, ComponentPackage, ProducerHandler, TypedRecord } from "hypit/author-kit";-import { VISUAL_IR_V1 } from "hypit/visual-ir";+import { sealVisualTrack } from "@hypit/hypit/composition";+import type { ProgramSpace } from "@hypit/hypit/program-space";+import { canonicalize } from "@hypit/hypit/author-kit";+import type { BlobRef, ComponentPackage, ProducerHandler, TypedRecord } from "@hypit/hypit/author-kit";+import { VISUAL_IR_V1 } from "@hypit/hypit/visual-ir";import { exampleProducers, exampleTypes } from "./manifest.js";const inline = <T>(record: { readonly value: { readonly kind: string; readonly value?: unknown } } | undefined): T => {diff --git a/examples/minimal-author-package/packages/example-component/src/fragment.ts b/examples/minimal-author-package/packages/example-component/src/fragment.tsindex 92f850be..c82e584c 100644--- a/examples/minimal-author-package/packages/example-component/src/fragment.ts+++ b/examples/minimal-author-package/packages/example-component/src/fragment.ts@@ -1,8 +1,8 @@-import { compositionTypes } from "hypit/composition";-import { artifactTypes } from "hypit/artifact";-import { sealGraphFragment } from "hypit/author-kit";-import { semanticTrackProducers, semanticTrackTypes } from "hypit/semantic-track";-import { programSpaceTypes } from "hypit/program-space";+import { compositionTypes } from "@hypit/hypit/composition";+import { artifactTypes } from "@hypit/hypit/artifact";+import { sealGraphFragment } from "@hypit/hypit/author-kit";+import { semanticTrackProducers, semanticTrackTypes } from "@hypit/hypit/semantic-track";+import { programSpaceTypes } from "@hypit/hypit/program-space";import { exampleProducers } from "./manifest.js";import { exampleTypes } from "./manifest.js";diff --git a/examples/minimal-author-package/packages/example-component/src/manifest.ts b/examples/minimal-author-package/packages/example-component/src/manifest.tsindex 026822e2..5814d8f9 100644--- a/examples/minimal-author-package/packages/example-component/src/manifest.ts+++ b/examples/minimal-author-package/packages/example-component/src/manifest.ts@@ -1,12 +1,12 @@import { readFile } from "node:fs/promises";-import { compositionTypes } from "hypit/composition";-import type { ModuleManifest, ProducerRef, TypeRef } from "hypit/author-kit";-import { programSpaceTypes } from "hypit/program-space";-import { semanticTrackTypes } from "hypit/semantic-track";-import { temporalTypes } from "hypit/temporal";-import { mediaTypes } from "hypit/media";-import { svsRecipeType } from "hypit/svs";-import { artifactTypes } from "hypit/artifact";+import { compositionTypes } from "@hypit/hypit/composition";+import type { ModuleManifest, ProducerRef, TypeRef } from "@hypit/hypit/author-kit";+import { programSpaceTypes } from "@hypit/hypit/program-space";+import { semanticTrackTypes } from "@hypit/hypit/semantic-track";+import { temporalTypes } from "@hypit/hypit/temporal";+import { mediaTypes } from "@hypit/hypit/media";+import { svsRecipeType } from "@hypit/hypit/svs";+import { artifactTypes } from "@hypit/hypit/artifact";const previewImage = (file: string) => ({mediaType: "image/png",diff --git a/examples/minimal-author-package/packages/example-component/src/style.ts b/examples/minimal-author-package/packages/example-component/src/style.tsindex 2f83dbd1..8d9231a9 100644--- a/examples/minimal-author-package/packages/example-component/src/style.ts+++ b/examples/minimal-author-package/packages/example-component/src/style.ts@@ -1,5 +1,5 @@-import type { FontStackRef } from "hypit/media";-import type { SvsRecipe } from "hypit/svs";+import type { FontStackRef } from "@hypit/hypit/media";+import type { SvsRecipe } from "@hypit/hypit/svs";/** The two values a Style decoder receives after author references are resolved. */export type ExampleStyleInput = {diff --git a/examples/minimal-author-package/packages/example-component/src/surface.ts b/examples/minimal-author-package/packages/example-component/src/surface.tsindex 9a4f76d1..c73fc119 100644--- a/examples/minimal-author-package/packages/example-component/src/surface.ts+++ b/examples/minimal-author-package/packages/example-component/src/surface.ts@@ -1,9 +1,9 @@-import type { StructuredElement, StructuredSurfaceHandler, SurfaceComponentDraft, SurfaceRecordDraft, SurfaceResolvedReference } from "hypit/author-kit";+import type { StructuredElement, StructuredSurfaceHandler, SurfaceComponentDraft, SurfaceRecordDraft, SurfaceResolvedReference } from "@hypit/hypit/author-kit";import { exampleBoxFragment, exampleMediaFragment, exampleTextFragment } from "./fragment.js";import { exampleMarkupSurfaces, exampleTypes } from "./manifest.js";-import { mediaTypes } from "hypit/media";-import { svsRecipeType } from "hypit/svs";-import { artifactTypes } from "hypit/artifact";+import { mediaTypes } from "@hypit/hypit/media";+import { svsRecipeType } from "@hypit/hypit/svs";+import { artifactTypes } from "@hypit/hypit/artifact";function text(element: StructuredElement, name: string): string {const value = element.attributes[name];diff --git a/examples/minimal-author-package/packages/example-component/src/temporal.ts b/examples/minimal-author-package/packages/example-component/src/temporal.tsindex 96e54457..2e6794db 100644--- a/examples/minimal-author-package/packages/example-component/src/temporal.ts+++ b/examples/minimal-author-package/packages/example-component/src/temporal.ts@@ -1,4 +1,4 @@-import { createTemporalInstantProjection, createTemporalWindowProjection, temporalInstantAttributeNames, temporalWindowAttributeNames } from "hypit/temporal-markup";+import { createTemporalInstantProjection, createTemporalWindowProjection, temporalInstantAttributeNames, temporalWindowAttributeNames } from "@hypit/hypit/temporal-markup";/** The fixture intentionally exposes both projection helpers and their vocabularies. */export { temporalInstantAttributeNames, temporalWindowAttributeNames };diff --git a/examples/semantic-composition/README.md b/examples/semantic-composition/README.mdindex 5f61a596..9478bf92 100644--- a/examples/semantic-composition/README.md+++ b/examples/semantic-composition/README.md@@ -6,7 +6,7 @@ video continues playing. A projected Moment triggers the layout change; an indepWindow defines the scene's lifetime. Captions and other independent contributions can remain peers.The package demonstrates HTML, CSS, SVG and frame-driven JavaScript inside one VisualTrack Present,-with typed child video sampling and exact-font text. It uses public `hypit/*` imports. No component+with typed child video sampling and exact-font text. It uses public `@hypit/hypit/*` imports. No componentname is registered in Core or in the renderer.Copy the package into a video's `packages/`, select the installed Hypit version for its development@@ -31,5 +31,5 @@ node bin/hypit.mjs build examples/semantic-composition/chat.svrun --workspace exThe Profile selects local HyperFrames and FFmpeg. Use the machine's prepared browser/media tools;there is no hosted generation account in this example. The final Output is `final.video`. The sameRun can be opened in Studio, where its component lane and physical clock work without a Script lane.-For an independent project, install `hypit`, copy the component into `packages/`, replace its workspace+For an independent project, install `@hypit/hypit`, copy the component into `packages/`, replace its workspacedependency with the installed Hypit version, and build the package normally.diff --git a/examples/semantic-composition/packages/chat-scene/README.md b/examples/semantic-composition/packages/chat-scene/README.mdindex 4d319c65..4870ec8d 100644--- a/examples/semantic-composition/packages/chat-scene/README.md+++ b/examples/semantic-composition/packages/chat-scene/README.md@@ -23,7 +23,7 @@ graph. The rendering function receives ProgramSpace, Window and Instants, so itScript parsing, speech models or Runtime. The browser program evaluates any requested frame directly,including frames reached by scrubbing, range rendering or concurrent workers.-Compile with `npm run build`. The package uses the public `hypit/*` interfaces and can live in any+Compile with `npm run build`. The package uses the public `@hypit/hypit/*` interfaces and can live in anyvideo project's `packages/`. It is an example to adapt, not an official component to install for everyanimation. The complete runnable Source is [chat.svml](../../chat.svml); see the surroundingexample README for commands. `font` receives a FontStack, for example from `fonts:Stack`.diff --git a/examples/semantic-composition/packages/chat-scene/package.json b/examples/semantic-composition/packages/chat-scene/package.jsonindex 0faf8c02..65d51fa2 100644--- a/examples/semantic-composition/packages/chat-scene/package.json+++ b/examples/semantic-composition/packages/chat-scene/package.json@@ -7,5 +7,5 @@"exports": { ".": "./dist/render.js" },"files": ["dist", "README.md"],"scripts": { "build": "tsc -p tsconfig.json", "prepack": "npm run build" },- "devDependencies": { "hypit": "workspace:*", "typescript": "5.9.3", "@types/node": "24.10.1" }+ "devDependencies": { "@hypit/hypit": "workspace:*", "typescript": "5.9.3", "@types/node": "24.10.1" }}diff --git a/examples/semantic-composition/packages/chat-scene/src/activation.ts b/examples/semantic-composition/packages/chat-scene/src/activation.tsindex a480725e..32db0e5e 100644--- a/examples/semantic-composition/packages/chat-scene/src/activation.ts+++ b/examples/semantic-composition/packages/chat-scene/src/activation.ts@@ -1,18 +1,18 @@-import { assertAttributes, assertEmptyElement, canonicalize, createMarkupSurfaceHostFacet, sameType, sealGraphFragment, textAttribute } from "hypit/author-kit";-import type { ComponentPackage, FragmentOperation, ModuleManifest, StructuredSurfaceHandler, SurfaceResolvedReference, TypeRef } from "hypit/author-kit";-import { compositionTypes } from "hypit/composition";-import { mediaTypes } from "hypit/media";-import type { FontStackRef } from "hypit/media";-import { programSpaceTypes } from "hypit/program-space";-import type { ProgramSpace } from "hypit/program-space";-import { semanticTrackTypes } from "hypit/semantic-track";-import { spatialTypes } from "hypit/spatial";-import type { CanvasSpace } from "hypit/spatial";-import { assertTemporalInstantFor, temporalTypes } from "hypit/temporal";-import type { TemporalInstant, TemporalWindow } from "hypit/temporal";+import { assertAttributes, assertEmptyElement, canonicalize, createMarkupSurfaceHostFacet, sameType, sealGraphFragment, textAttribute } from "@hypit/hypit/author-kit";+import type { ComponentPackage, FragmentOperation, ModuleManifest, StructuredSurfaceHandler, SurfaceResolvedReference, TypeRef } from "@hypit/hypit/author-kit";+import { compositionTypes } from "@hypit/hypit/composition";+import { mediaTypes } from "@hypit/hypit/media";+import type { FontStackRef } from "@hypit/hypit/media";+import { programSpaceTypes } from "@hypit/hypit/program-space";+import type { ProgramSpace } from "@hypit/hypit/program-space";+import { semanticTrackTypes } from "@hypit/hypit/semantic-track";+import { spatialTypes } from "@hypit/hypit/spatial";+import type { CanvasSpace } from "@hypit/hypit/spatial";+import { assertTemporalInstantFor, temporalTypes } from "@hypit/hypit/temporal";+import type { TemporalInstant, TemporalWindow } from "@hypit/hypit/temporal";import { createTemporalInstantProjection, createTemporalSpace, createTemporalWindowProjection, resolveTemporalContext,temporalContextAttributeVocabulary, temporalInstantAttributeNames, temporalInstantAttributeVocabulary,- temporalWindowAttributeNames, temporalWindowAttributeVocabulary } from "hypit/temporal-markup";+ temporalWindowAttributeNames, temporalWindowAttributeVocabulary } from "@hypit/hypit/temporal-markup";import { renderChat } from "./render.js";import type { ChatOptions, Message } from "./render.js";diff --git a/examples/semantic-composition/packages/chat-scene/src/render.ts b/examples/semantic-composition/packages/chat-scene/src/render.tsindex 877d671c..eebc8808 100644--- a/examples/semantic-composition/packages/chat-scene/src/render.ts+++ b/examples/semantic-composition/packages/chat-scene/src/render.ts@@ -1,11 +1,11 @@-import { sealVisualTrack } from "hypit/composition";-import type { VisualElement } from "hypit/composition";-import { browserProgram } from "hypit/hyperframes";-import type { FontStackRef } from "hypit/media";-import type { ProgramSpace } from "hypit/program-space";-import type { CanvasSpace } from "hypit/spatial";-import { assertTemporalWindowFor } from "hypit/temporal";-import type { TemporalInstant, TemporalWindow } from "hypit/temporal";+import { sealVisualTrack } from "@hypit/hypit/composition";+import type { VisualElement } from "@hypit/hypit/composition";+import { browserProgram } from "@hypit/hypit/hyperframes";+import type { FontStackRef } from "@hypit/hypit/media";+import type { ProgramSpace } from "@hypit/hypit/program-space";+import type { CanvasSpace } from "@hypit/hypit/spatial";+import { assertTemporalWindowFor } from "@hypit/hypit/temporal";+import type { TemporalInstant, TemporalWindow } from "@hypit/hypit/temporal";export type Message = { id: string; sender: string; text: string; side: "left" | "right"; at: TemporalInstant };export type ChatOptions = { id: string; title: string; entranceFrames: number };diff --git a/examples/semantic-composition/packages/chat-scene/test/render.test.ts b/examples/semantic-composition/packages/chat-scene/test/render.test.tsindex ed7ed686..1c338503 100644--- a/examples/semantic-composition/packages/chat-scene/test/render.test.ts+++ b/examples/semantic-composition/packages/chat-scene/test/render.test.ts@@ -1,6 +1,6 @@import assert from "node:assert/strict";import test from "node:test";-import type { BrowserProgram } from "hypit/hyperframes";+import type { BrowserProgram } from "@hypit/hypit/hyperframes";import type { FontStackRef } from "@hypit/media";import type { ProgramSpace } from "@hypit/program-space";import { composeTemporalWindow, projectMomentInstant, projectProgramInstant } from "@hypit/temporal";diff --git a/examples/semantic-composition/packages/responsive-explainer/README.md b/examples/semantic-composition/packages/responsive-explainer/README.mdindex d8dfffcd..67e35d58 100644--- a/examples/semantic-composition/packages/responsive-explainer/README.md+++ b/examples/semantic-composition/packages/responsive-explainer/README.md@@ -39,7 +39,7 @@ The original audio stays independently selectable as `speech.audio`.function computes state directly from local frame time, supporting direct seeking, range rendersand independent workers.-The package builds against `hypit` and emits JavaScript. In a standalone project, replace the+The package builds against `@hypit/hypit` and emits JavaScript. In a standalone project, replace therepository's `workspace:*` development dependency with the Hypit version you use. Run `npm run build`and connect this directory through an ordinary `file:` dependency during development. Cross-projectsharing can use a tarball or a versioned package under the owner's scope.diff --git a/examples/semantic-composition/packages/responsive-explainer/package.json b/examples/semantic-composition/packages/responsive-explainer/package.jsonindex c84cfe94..70432ae6 100644--- a/examples/semantic-composition/packages/responsive-explainer/package.json+++ b/examples/semantic-composition/packages/responsive-explainer/package.json@@ -7,5 +7,5 @@"exports": { ".": "./dist/render.js" },"files": ["dist", "README.md"],"scripts": { "build": "tsc -p tsconfig.json", "prepack": "npm run build" },- "devDependencies": { "hypit": "workspace:*", "typescript": "5.9.3", "@types/node": "24.10.1" }+ "devDependencies": { "@hypit/hypit": "workspace:*", "typescript": "5.9.3", "@types/node": "24.10.1" }}diff --git a/examples/semantic-composition/packages/responsive-explainer/src/activation.ts b/examples/semantic-composition/packages/responsive-explainer/src/activation.tsindex 23a09086..26469636 100644--- a/examples/semantic-composition/packages/responsive-explainer/src/activation.ts+++ b/examples/semantic-composition/packages/responsive-explainer/src/activation.ts@@ -1,18 +1,18 @@import { assertAttributes, assertEmptyElement, canonicalize, createMarkupSurfaceHostFacet, sameType,- sealGraphFragment, textAttribute } from "hypit/author-kit";-import type { ComponentPackage, ModuleManifest, StructuredSurfaceHandler, SurfaceResolvedReference, TypeRef } from "hypit/author-kit";-import { compositionTypes } from "hypit/composition";-import { mediaTypes } from "hypit/media";-import type { FontStackRef } from "hypit/media";-import { narrativeTypes } from "hypit/narrative";-import { semanticTrackTypes } from "hypit/semantic-track";-import type { SemanticTrack } from "hypit/semantic-track";-import { spatialTypes } from "hypit/spatial";-import type { CanvasSpace } from "hypit/spatial";-import { temporalTypes } from "hypit/temporal";-import type { TemporalInstant, TemporalWindow } from "hypit/temporal";+ sealGraphFragment, textAttribute } from "@hypit/hypit/author-kit";+import type { ComponentPackage, ModuleManifest, StructuredSurfaceHandler, SurfaceResolvedReference, TypeRef } from "@hypit/hypit/author-kit";+import { compositionTypes } from "@hypit/hypit/composition";+import { mediaTypes } from "@hypit/hypit/media";+import type { FontStackRef } from "@hypit/hypit/media";+import { narrativeTypes } from "@hypit/hypit/narrative";+import { semanticTrackTypes } from "@hypit/hypit/semantic-track";+import type { SemanticTrack } from "@hypit/hypit/semantic-track";+import { spatialTypes } from "@hypit/hypit/spatial";+import type { CanvasSpace } from "@hypit/hypit/spatial";+import { temporalTypes } from "@hypit/hypit/temporal";+import type { TemporalInstant, TemporalWindow } from "@hypit/hypit/temporal";import { createTemporalInstantProjection, createTemporalWindowProjection, temporalWindowAttributeNames,- temporalWindowAttributeVocabulary } from "hypit/temporal-markup";+ temporalWindowAttributeVocabulary } from "@hypit/hypit/temporal-markup";import { renderExplainer } from "./render.js";import type { ExplainerOptions } from "./render.js";diff --git a/examples/semantic-composition/packages/responsive-explainer/src/render.ts b/examples/semantic-composition/packages/responsive-explainer/src/render.tsindex 43a20b2b..d3af26d4 100644--- a/examples/semantic-composition/packages/responsive-explainer/src/render.ts+++ b/examples/semantic-composition/packages/responsive-explainer/src/render.ts@@ -1,11 +1,11 @@-import { sealVisualTrack } from "hypit/composition";-import type { VisualElement } from "hypit/composition";-import { browserProgram } from "hypit/hyperframes";-import type { FontArtifactRef } from "hypit/media";-import { projectSemanticMedia, projectSemanticProgramSpace } from "hypit/semantic-track";-import type { SemanticTrack } from "hypit/semantic-track";-import type { CanvasSpace } from "hypit/spatial";-import type { TemporalInstant, TemporalWindow } from "hypit/temporal";+import { sealVisualTrack } from "@hypit/hypit/composition";+import type { VisualElement } from "@hypit/hypit/composition";+import { browserProgram } from "@hypit/hypit/hyperframes";+import type { FontArtifactRef } from "@hypit/hypit/media";+import { projectSemanticMedia, projectSemanticProgramSpace } from "@hypit/hypit/semantic-track";+import type { SemanticTrack } from "@hypit/hypit/semantic-track";+import type { CanvasSpace } from "@hypit/hypit/spatial";+import type { TemporalInstant, TemporalWindow } from "@hypit/hypit/temporal";export type ExplainerOptions = { id: string; title: string; transitionFrames: number; stackingOrder: number };diff --git a/package.json b/package.jsonindex 11c2288f..3808e852 100644--- a/package.json+++ b/package.json@@ -1,5 +1,5 @@{- "name": "hypit",+ "name": "@hypit/hypit","version": "0.1.0","description": "Hypit video authoring Distribution for AI agents","license": "SEE LICENSE IN LICENSE",@@ -95,8 +95,7 @@}},"bin": {- "hypit": "./bin/hypit.mjs",- "hypit-studio": "./bin/hypit-studio.mjs"+ "hypit": "./bin/hypit.mjs"},"packageManager": "[email protected]","files": [@@ -155,7 +154,7 @@"test:whisperx-service": "uv run --project services/whisperx --frozen python -m unittest discover -s services/whisperx/tests -p \"test_*.py\"","test:image-opencv": "node test/run.mjs image-opencv","hypit": "node bin/hypit.mjs",- "studio": "pnpm --filter @hypit/studio exec node --import tsx start.ts",+ "studio": "node bin/hypit.mjs studio","prepack": "npm run build:public-types"},"engines": {diff --git a/packages/author-kit/README.md b/packages/author-kit/README.mdindex a119746e..b62afe92 100644--- a/packages/author-kit/README.md+++ b/packages/author-kit/README.md@@ -1,4 +1,4 @@-# `hypit/author-kit`+# `@hypit/hypit/author-kit`Small public framework API for an Author Package.@@ -7,14 +7,14 @@ handlers, sealed Graph Fragments and Markup Surface handlers. Domain facts stillowners—for example `@hypit/composition`, `@hypit/semantic-track` and `@hypit/spatial`. This packagedoes not re-export the video vocabulary or turn those packages into one central object.-`hypit/author-kit` contains no registry, package search, installer, Runtime, Provider or Studio+`@hypit/hypit/author-kit` contains no registry, package search, installer, Runtime, Provider or Studioselection. Importing it makes no component visible. A project's Source explicitly selects aninstalled Author Package; the Host then consumes only the contribution exported by that package'sdeclared activation entry.-An external Author Package normally has one development dependency on the released `hypit`-Distribution. It imports this boundary from `hypit/author-kit` and the relevant domain owners from-subpaths such as `hypit/composition`, compiles its activation to JavaScript, and publishes only its+An external Author Package normally has one development dependency on the released `@hypit/hypit`+Distribution. It imports this boundary from `@hypit/hypit/author-kit` and the relevant domain owners from+subpaths such as `@hypit/hypit/composition`, compiles its activation to JavaScript, and publishes only itsown built files and assets. At execution time the active Hypit Distribution supplies those exactpublic subpaths. This keeps one framework implementation in the process and prevents a componenttarball from carrying private copies of Core.diff --git a/packages/browser-capture/README.md b/packages/browser-capture/README.mdindex 36aa43c9..af3707c3 100644--- a/packages/browser-capture/README.md+++ b/packages/browser-capture/README.md@@ -78,5 +78,5 @@ belong in those scripts through normal Puppeteer APIs. A simple screenshot waits`--wait-for` and `--wait-ms` add an authored readiness condition. The package does not interpretwebsites or silently rewrite page content.-For a library import in an installed Distribution, use `hypit/browser-capture`. The workspace package+For a library import in an installed Distribution, use `@hypit/hypit/browser-capture`. The workspace packagealso exports the same API as `@hypit/browser-capture`.diff --git a/packages/caption/README.md b/packages/caption/README.mdindex 4197201e..5f86413a 100644--- a/packages/caption/README.md+++ b/packages/caption/README.md@@ -1,6 +1,6 @@# `@hypit/caption`-External components use `hypit/caption` from their `hypit` development dependency. The package+External components use `@hypit/hypit/caption` from their `@hypit/hypit` development dependency. The packageowns the types and helpers below; Source imports retain the `@hypit/caption@1` Module identity.diff --git a/packages/component-kit/README.md b/packages/component-kit/README.mdindex f050eabb..9ebb9ba9 100644--- a/packages/component-kit/README.md+++ b/packages/component-kit/README.md@@ -22,19 +22,19 @@ Distribution reserves `@hypit/*`. A Source imports the package's logical Module`<import as="score" from="@studio/score-strip@1"/>`. That `1` is not its npm release version.External Author Packages use the released Distribution's public subpaths. The small framework-facing-surface is `hypit/author-kit`; domain values continue to come from their own owners:+surface is `@hypit/hypit/author-kit`; domain values continue to come from their own owners:| Owner | Interface || --- | --- |-| `hypit/author-kit` | Module declarations, deterministic handlers, sealed Fragments and Markup Surface handlers |-| `hypit/temporal-markup` | author-time semantic Window/Instant projection helpers |-| `hypit/composition`, `hypit/visual-ir` | peer Track values and renderer-independent visual representation |-| `hypit/studio-adapter` (optional, in Companion code) | editor entity projection, Inspector bindings and executed temporal lineage |+| `@hypit/hypit/author-kit` | Module declarations, deterministic handlers, sealed Fragments and Markup Surface handlers |+| `@hypit/hypit/temporal-markup` | author-time semantic Window/Instant projection helpers |+| `@hypit/hypit/composition`, `@hypit/hypit/visual-ir` | peer Track values and renderer-independent visual representation |+| `@hypit/hypit/studio-adapter` (optional, in Companion code) | editor entity projection, Inspector bindings and executed temporal lineage |-The Author Package keeps one development dependency on `hypit`, compiles its activation to+The Author Package keeps one development dependency on `@hypit/hypit`, compiles its activation toJavaScript, and publishes only its own files. The active Distribution supplies these subpaths atexecution, so a component does not carry a second Core or choose its own framework version. This-package remains the internal deterministic-handler owner; `hypit/author-kit` is the deliberately+package remains the internal deterministic-handler owner; `@hypit/hypit/author-kit` is the deliberatelysmall public composition boundary, not a facade for every video domain.An ESM package names its activation entry in `package.json`, for example@@ -46,7 +46,7 @@ The activation module connects the implementation pieces; this is a wiring excerlocal Manifest, ComponentPackage and Surface declarations/handlers already exist:```ts-import { createMarkupSurfaceHostFacet } from "hypit/author-kit";+import { createMarkupSurfaceHostFacet } from "@hypit/hypit/author-kit";import { manifest, moduleRef, surfaces } from "./manifest.js";import { component } from "./component.js";import { decodeTrack } from "./surface.js";diff --git a/packages/endpoint-kit/README.md b/packages/endpoint-kit/README.mdindex 77236c75..eae62ea2 100644--- a/packages/endpoint-kit/README.md+++ b/packages/endpoint-kit/README.md@@ -1,21 +1,21 @@-# `hypit/endpoint-kit`+# `@hypit/hypit/endpoint-kit`SDK for packages that fulfill exact external capabilities.-External Provider packages import this public subpath from the `hypit` Distribution. Use `hypit` as+External Provider packages import this public subpath from the `@hypit/hypit` Distribution. Use `@hypit/hypit` asa development dependency, compile the Provider to JavaScript, and ship its code plus any ordinaryruntime dependencies. The active Distribution supplies this API when loading the package.No Hypit checkout is needed to develop or install the extension.```ts-import { defineEndpointPackage } from "hypit/endpoint-kit";-import type { AsyncEndpoint, CredentialRef, EndpointRequest } from "hypit/endpoint-kit";-import { generationTypes, compileWireRequest, sealGeneratedImageSet } from "hypit/generation";+import { defineEndpointPackage } from "@hypit/hypit/endpoint-kit";+import type { AsyncEndpoint, CredentialRef, EndpointRequest } from "@hypit/hypit/endpoint-kit";+import { generationTypes, compileWireRequest, sealGeneratedImageSet } from "@hypit/hypit/generation";```For an existing model, name its exact versioned Capability and expected result Type. Map its requestports into the service's wire format; the Provider need not import the model's implementation.-`hypit/generation` supplies the common generated-media values and optional wire-mapping helpers.+`@hypit/hypit/generation` supplies the common generated-media values and optional wire-mapping helpers.One Provider can implement multiple capabilities, and another Provider can implement those samecapabilities. The Profile selects the implementation used by a project.diff --git a/packages/generation/README.md b/packages/generation/README.mdindex c689d672..1d1ad80d 100644--- a/packages/generation/README.md+++ b/packages/generation/README.md@@ -1,8 +1,8 @@-# `hypit/generation`+# `@hypit/hypit/generation`Provider-neutral generated-media contracts shared by exact image, video and audio model packages.-External Model and Provider packages import this public subpath from the `hypit` Distribution.+External Model and Provider packages import this public subpath from the `@hypit/hypit` Distribution.It gives both sides the same request and result vocabulary without a dependency between theirimplementations. `sealGenerationPortTable` describes a model's inputs; `GenerationWireMapping` and`compileWireRequest` can translate those inputs to one Provider's documented wire fields.diff --git a/packages/hyperframes/README.md b/packages/hyperframes/README.mdindex d6ec44f2..2f5c8ff1 100644--- a/packages/hyperframes/README.md+++ b/packages/hyperframes/README.md@@ -61,7 +61,7 @@ material preparation before rendering; browser resources belong in the program'sUse `hyperframesResourceUri(artifact.resource)` in resource-bearing markup or CSS.Ordinary child sampling follows the Present clock. Reframing the parent leaves source playback-unchanged. `projectSemanticMedia` from `hypit/semantic-track` gives a component selected prepared+unchanged. `projectSemanticMedia` from `@hypit/hypit/semantic-track` gives a component selected preparedclips with their exact program and source spans. Speech audio is an independently selected Track.`program.format` is explicit: this backend reports an unsupported format rather than interpretingdiff --git a/packages/media-track/README.md b/packages/media-track/README.mdindex 99da1fdc..47d93cd5 100644--- a/packages/media-track/README.md+++ b/packages/media-track/README.md@@ -55,7 +55,7 @@ interval, while the two Sampling keys direct a gradual push-in inside the unchanFor a fixed card, full picture, circle or cutout this is ordinary Media presentation. If video andgraphics must resize, mask or move together, write a project component that owns that relationship.`projectSemanticMedia` supplies the same material spans to its drawing function. The component can-use a browser program from `hypit/hyperframes` while Caption and independent overlays remain peers.+use a browser program from `@hypit/hypit/hyperframes` while Caption and independent overlays remain peers.## Place the frame, then fit its contentsdiff --git a/packages/model-kit/README.md b/packages/model-kit/README.mdindex d606b420..5952981e 100644--- a/packages/model-kit/README.md+++ b/packages/model-kit/README.md@@ -1,10 +1,10 @@-# `hypit/model-kit`+# `@hypit/hypit/model-kit`Author-model package helper for defining exact generated-media requests without repeating thenominal Type → Producer → Need → Graph Fragment shell.-An external model package develops against the public `hypit/model-kit`, `hypit/generation`, and-`hypit/author-kit` subpaths. The released `hypit` Distribution is its framework development+An external model package develops against the public `@hypit/hypit/model-kit`, `@hypit/hypit/generation`, and+`@hypit/hypit/author-kit` subpaths. The released `@hypit/hypit` Distribution is its framework developmentdependency; the model ships its own compiled JavaScript, Sources, and assets.## Declare the authored request@@ -12,8 +12,8 @@ dependency; the model ships its own compiled JavaScript, Sources, and assets.For example, a model's request can have one prompt and a chosen output shape:```ts-import { defineExactModelModule } from "hypit/model-kit";-import { sealGenerationPortTable } from "hypit/generation";+import { defineExactModelModule } from "@hypit/hypit/model-kit";+import { sealGenerationPortTable } from "@hypit/hypit/generation";const ports = sealGenerationPortTable({model: "studio-image-v1",@@ -38,7 +38,7 @@ Adding a new service for this request leaves the Model unchanged.The definition supplies the Module Manifest, component handlers, exact-model Host facet, and eachendpoint's request Types and generation Fragment. Export the Manifest in the package activation's`modules`, the component in `components`, and its Host facet in `hostFacets`. An Author Surface uses-`hypit/author-kit` to read Source and connects authored Text and media edges through+`@hypit/hypit/author-kit` to read Source and connects authored Text and media edges through`createExactModelPrimaryGenerationFragment`. It publishes the resulting image, video, or audio as anormal Output. See the public function types for the returned values and Fragment inputs.diff --git a/packages/narrative/README.md b/packages/narrative/README.mdindex 0c66025c..79b8f41f 100644--- a/packages/narrative/README.md+++ b/packages/narrative/README.md@@ -1,6 +1,6 @@# `@hypit/narrative`-External components use `hypit/narrative` from their `hypit` development dependency. The package+External components use `@hypit/hypit/narrative` from their `@hypit/hypit` development dependency. The packageowns the types and helpers below; Source imports retain the `@hypit/narrative@1` Module identity.diff --git a/packages/package-loader-node/src/distribution-resolution.ts b/packages/package-loader-node/src/distribution-resolution.tsindex 7c748f36..8213d3d6 100644--- a/packages/package-loader-node/src/distribution-resolution.ts+++ b/packages/package-loader-node/src/distribution-resolution.ts@@ -1,6 +1,6 @@import { registerHooks } from "node:module";import { join, resolve } from "node:path";-import { readFileSync } from "node:fs";+import { existsSync, readFileSync } from "node:fs";import { pathToFileURL } from "node:url";import {@@ -47,8 +47,10 @@ function distributionPackageEntry(root: string, specifier: string): string | und}function distributionPublicEntry(root: string, specifier: string): string | undefined {- if (!specifier.startsWith("hypit/")) return undefined;+ const address = packageAddress(specifier);+ if (address === undefined) return undefined;const manifestPath = join(root, "package.json");+ if (!existsSync(manifestPath)) return undefined;const manifest = JSON.parse(readFileSync(manifestPath, "utf8")) as {readonly name?: string;readonly exports?: Readonly<Record<string, string | {@@ -56,16 +58,17 @@ function distributionPublicEntry(root: string, specifier: string): string | undereadonly default?: string;}>>;};- if (manifest.name !== "hypit") return undefined;- const declared = manifest.exports?.[`./${specifier.slice("hypit/".length)}`];+ if (manifest.name !== address.name) return undefined;+ const declared = manifest.exports?.[address.subpath.length === 0 ? "." : `./${address.subpath}`];const target = typeof declared === "string" ? declared : declared?.import ?? declared?.default;return target === undefined ? undefined : resolve(root, target);}/** Resolve one import owned by an explicit Hypit Distribution. */export function resolveDistributionPackageImport(root: string, specifier: string): string | undefined {- if (specifier.startsWith("@hypit/")) return distributionPackageEntry(resolve(root), specifier);- if (specifier.startsWith("hypit/")) return distributionPublicEntry(resolve(root), specifier);+ if (specifier.startsWith("@hypit/")) {+ return distributionPublicEntry(resolve(root), specifier) ?? distributionPackageEntry(resolve(root), specifier);+ }return undefined;}@@ -82,7 +85,7 @@ export function installDistributionPackageResolution(roots: readonly string[]):const rootUrls = installed.map((root) => pathToFileURL(`${root}/`).href);registerHooks({resolve(specifier, context, nextResolve) {- if (specifier.startsWith("@hypit/") || specifier.startsWith("hypit/")) {+ if (specifier.startsWith("@hypit/")) {// A contributor checkout may resolve through workspace links. An installed// monolithic Distribution resolves from its own packages/services tree.// Accept ordinary resolution only when its real target remains inside this@@ -123,7 +126,7 @@ export function installExternalPackageResolution(roots: readonly string[]): voidconst parentUrls = externalInstalled.map((root) => pathToFileURL(join(root, "__hypit_external__.mjs")).href);registerHooks({resolve(specifier, context, nextResolve) {- if (specifier.startsWith("@hypit/") || specifier.startsWith("hypit/") || !barePackageSpecifier(specifier)) {+ if (specifier.startsWith("@hypit/") || !barePackageSpecifier(specifier)) {return nextResolve(specifier, context);}try {diff --git a/packages/package-loader-node/test/distribution-resolution.test.ts b/packages/package-loader-node/test/distribution-resolution.test.tsindex 8dee1467..e1e0a3d4 100644--- a/packages/package-loader-node/test/distribution-resolution.test.ts+++ b/packages/package-loader-node/test/distribution-resolution.test.ts@@ -14,7 +14,7 @@ test("one Distribution resolves its internal and public package spellings", () =resolve(process.cwd(), "packages/svs/src/index.ts"),);assert.equal(- resolveDistributionPackageImport(process.cwd(), "hypit/svs"),+ resolveDistributionPackageImport(process.cwd(), "@hypit/hypit/svs"),resolve(process.cwd(), "packages/svs/src/index.ts"),);assert.equal(resolveDistributionPackageImport(process.cwd(), "example-package"), undefined);@@ -22,8 +22,8 @@ test("one Distribution resolves its internal and public package spellings", () =test("an external Author Package imports the active Distribution public API", async () => {installDistributionPackageResolution([process.cwd()]);- const author = await import(String("hypit/author-kit")) as { readonly sealGraphFragment?: unknown };- const composition = await import(String("hypit/composition")) as { readonly sealVisualTrack?: unknown };+ const author = await import(String("@hypit/hypit/author-kit")) as { readonly sealGraphFragment?: unknown };+ const composition = await import(String("@hypit/hypit/composition")) as { readonly sealVisualTrack?: unknown };assert.equal(typeof author.sealGraphFragment, "function");assert.equal(typeof composition.sealVisualTrack, "function");});diff --git a/packages/ranking/README.md b/packages/ranking/README.mdindex f1408c65..63d88e54 100644--- a/packages/ranking/README.md+++ b/packages/ranking/README.md@@ -57,7 +57,7 @@ The following files are included in the Distribution and show how the responsibi| [Ranking Companion](../ranking-studio/src/index.ts) | Read the same program, present persistent rows and activation lanes, and connect edits to actual Source inputs. |A project component can use these relationships with its own behavior. External TypeScript uses-`hypit/author-kit`, `hypit/temporal-markup` and the appropriate `hypit/*` domain APIs; the official+`@hypit/hypit/author-kit`, `@hypit/hypit/temporal-markup` and the appropriate `@hypit/hypit/*` domain APIs; the officialimplementation's `@hypit/*` imports are internal workspace spellings. Copy the relevant idea intothe project's own package, with its own Module identity, instead of editing the installed Ranking.diff --git a/packages/runtime-kit/README.md b/packages/runtime-kit/README.mdindex a6804bb8..09b61371 100644--- a/packages/runtime-kit/README.md+++ b/packages/runtime-kit/README.md@@ -1,11 +1,11 @@-# `hypit/runtime-kit`+# `@hypit/hypit/runtime-kit`Host facets for the two environmental choices a Local Runtime Profile may select:* an Endpoint implements external capabilities;* a Credential Store resolves explicit credential references.-External packages use this public subpath from their `hypit` development dependency. The built+External packages use this public subpath from their `@hypit/hypit` development dependency. The builtpackage's `hypit.activation` entry exports a default package contribution with`format: "hypit.node-package@1"` and the declared `hostFacets`.diff --git a/packages/speech-track/README.md b/packages/speech-track/README.mdindex fbec4b3f..a7462ff4 100644--- a/packages/speech-track/README.md+++ b/packages/speech-track/README.md@@ -42,7 +42,7 @@ fit, clipping, rounded corners, border and other presentation choices. A selecteinside a Take begins at the matching source frame. Presentation continues across Take boundaries.A project component can also consume `.semantic` and use `projectSemanticMedia` from-`hypit/semantic-track` to obtain selected material spans and their source positions. When video and+`@hypit/hypit/semantic-track` to obtain selected material spans and their source positions. When video andgraphics share layout or motion, that component can own both in one visual program. IndependentCaption or other overlays can remain separate Tracks.diff --git a/packages/speech/README.md b/packages/speech/README.mdindex 7e8f6c48..632c5e5c 100644--- a/packages/speech/README.md+++ b/packages/speech/README.md@@ -1,6 +1,6 @@# `@hypit/speech`-External components use `hypit/speech` from their `hypit` development dependency. The package+External components use `@hypit/hypit/speech` from their `@hypit/hypit` development dependency. The packageowns the types and helpers below; Source imports retain the `@hypit/speech@1` Module identity.diff --git a/packages/studio-adapter/README.md b/packages/studio-adapter/README.mdindex 8d47bcad..6a3a3158 100644--- a/packages/studio-adapter/README.md+++ b/packages/studio-adapter/README.md@@ -1,11 +1,11 @@-# `hypit/studio-adapter`+# `@hypit/hypit/studio-adapter`The stable companion-package ABI understood by Hypit Studio. It carries onlypresentation, lineage, inspector and interaction DTOs plus helpers that do notencode the official video UI policy. Domain computation and manifests do not depend on it;package activation can combine domain facets with a separate Companion implementation.-External packages use the public imports below with `hypit` as a development dependency, then ship+External packages use the public imports below with `@hypit/hypit` as a development dependency, then shipcompiled JavaScript. The active Distribution supplies these APIs when Studio loads the component.## A minimal project Track Companion@@ -15,8 +15,8 @@ accepts a literal string `label` attribute. The Companion can reuse generic termadding package-specific presentation and one Inspector field:```ts-import { compositionTypes } from "hypit/composition";-import type { StudioTrackCompanion } from "hypit/studio-adapter";+import { compositionTypes } from "@hypit/hypit/composition";+import type { StudioTrackCompanion } from "@hypit/hypit/studio-adapter";export const companions: readonly StudioTrackCompanion[] = [{id: "score-strip",@@ -52,7 +52,7 @@ Merge the facet into the package's existing activation. In this example `authorCexports its existing modules, deterministic component and Markup facets:```ts-import { createStudioTrackCompanionHostFacet } from "hypit/studio-adapter";+import { createStudioTrackCompanionHostFacet } from "@hypit/hypit/studio-adapter";import authorContribution from "./author-activation.js";import { companions } from "./studio.js";diff --git a/packages/studio/README.md b/packages/studio/README.mdindex f99e5857..412d1ce6 100644--- a/packages/studio/README.md+++ b/packages/studio/README.md@@ -7,7 +7,7 @@ resulting Tracks with HyperFrames.```bashcd /path/to/external-video-project-hypit-studio --run build.svrun+hypit studio --run build.svrun```When `--runtime` is omitted, Studio reads the resolved project's `.hypit/runtime`@@ -69,8 +69,8 @@ project nor its packages are added to the Hypit Distribution or contributor workThe Host resolves selected project packages from the project first and official`@hypit/*` imports from the read-only tool Distribution. The `@hypit/*`namespace is Distribution-owned and cannot be shadowed by a project install.-External Companions compile against `hypit/studio-adapter` and the other public `hypit/*`-subpaths, with `hypit` as a development dependency. The active Distribution supplies those APIs+External Companions compile against `@hypit/hypit/studio-adapter` and the other public `@hypit/hypit/*`+subpaths, with `@hypit/hypit` as a development dependency. The active Distribution supplies those APIsat runtime. Ship the Companion's compiled JavaScript with its component package.The companion owns what its Track means: matching, required same-Surface values,diff --git a/packages/studio/start.ts b/packages/studio/start.tsindex 8f928071..032778c2 100644--- a/packages/studio/start.ts+++ b/packages/studio/start.ts@@ -1,31 +1,24 @@import { dirname, resolve } from "node:path";import { fileURLToPath } from "node:url";--import { createServer } from "vite";-import { findRuntimeProfile, resolveProjectRoot } from "@hypit/cli";-import { resolveDistributionPackageImport } from "@hypit/package-loader-node";-import { videoCliDistribution, videoStudioCompanionPackages } from "@hypit/video-cli";--import { openStudioBuildLibrary } from "./src/build-library.js";-import { loadStudioCompanionRegistry } from "./src/companion-assembly.js";-import { loadStudioDomain } from "./src/domain.js";-import { loadStudioRun } from "./src/run.js";-import { studioPlugin } from "./src/server.js";-import { inspectStudioRun } from "./src/studio-preflight.js";+import type { CliIo } from "@hypit/cli";const here = dirname(fileURLToPath(import.meta.url));-function usage(message?: string): never {- if (message !== undefined) process.stderr.write(`${message}\n\n`);- process.stderr.write(`Usage:- hypit-studio --run <build.svrun> [--runtime <hypit.runtime.json>]+export function writeStudioHelp(io: Pick<CliIo, "write">): void {+ io.write(`hypit studio+Open a Run in the browser to inspect its composition, Sources and Results.++ hypit studio --run <build.svrun> [--runtime <hypit.runtime.json>][--port <number>] [--workspace <directory>] [--package-root <directory>]-Studio opens one explicit Run Source, requires a Film/Render target and a-resolved deterministic composition, and writes only the selected file-inside that exact Run and Author Source closure.+Paths are relative to the invoking project. Without --runtime, Studio uses+that project's selected Runtime Profile. The server prints its browser URL;+press Ctrl+C to stop it.`);- process.exit(1);+}++function invalidArguments(message: string): never {+ throw new Error(`${message}. See hypit studio --help.`);}function argumentsByName(argv: readonly string[]): ReadonlyMap<string, string> {@@ -35,101 +28,116 @@ function argumentsByName(argv: readonly string[]): ReadonlyMap<string, string> {const flag = argv[index];const value = argv[index + 1];if (flag === undefined || !flag.startsWith("--") || value === undefined || value.startsWith("--")) {- usage(`Malformed argument near ${flag ?? "end of command"}`);+ invalidArguments(`Malformed argument near ${flag ?? "end of command"}`);}const name = flag.slice(2);- if (!accepted.has(name)) usage(`Unknown option --${name}`);+ if (!accepted.has(name)) invalidArguments(`Unknown option --${name}`);result.set(name, value);}return result;}-const raw = process.argv.slice(2);-const values = argumentsByName(raw[0] === "--" ? raw.slice(1) : raw);-const invokedFrom = process.env.INIT_CWD ?? process.cwd();-const runArgument = values.get("run");-if (runArgument === undefined || runArgument.trim().length === 0) usage("Missing --run");-const runPath = resolve(invokedFrom, runArgument);-const packageRootArgument = values.get("package-root");-const workspaceArgument = values.get("workspace");-const requestedWorkspaceRoot = workspaceArgument === undefined- ? undefined- : resolve(invokedFrom, workspaceArgument);-const workspaceRoot = await resolveProjectRoot({- ...(requestedWorkspaceRoot === undefined ? {} : { workspaceRoot: requestedWorkspaceRoot }),- cwd: invokedFrom,-});-const packageRoot = packageRootArgument === undefined- ? workspaceRoot- : resolve(invokedFrom, packageRootArgument);-const runtimeArgument = values.get("runtime");-const selectedRuntime = runtimeArgument === undefined- ? await findRuntimeProfile(workspaceRoot)- : undefined;-const runtimePath = runtimeArgument === undefined- ? selectedRuntime?.profile- : resolve(invokedFrom, runtimeArgument);-const port = Number(values.get("port") ?? "5179");-if (!Number.isSafeInteger(port) || port <= 0) usage("--port must be a positive integer");+export async function runStudio(argv: readonly string[], io: Pick<CliIo, "write">): Promise<void> {+ if (argv.includes("--help") || argv.includes("-h")) {+ writeStudioHelp(io);+ return;+ }+ const values = argumentsByName(argv[0] === "--" ? argv.slice(1) : argv);+ const invokedFrom = process.env.INIT_CWD ?? process.cwd();+ const runArgument = values.get("run");+ if (runArgument === undefined || runArgument.trim().length === 0) invalidArguments("Missing --run");+ const { createServer } = await import("vite");+ const { findRuntimeProfile, resolveProjectRoot } = await import("@hypit/cli");+ const { resolveDistributionPackageImport } = await import("@hypit/package-loader-node");+ const { videoCliDistribution, videoStudioCompanionPackages } = await import("@hypit/video-cli");+ const { openStudioBuildLibrary } = await import("./src/build-library.js");+ const { loadStudioCompanionRegistry } = await import("./src/companion-assembly.js");+ const { loadStudioDomain } = await import("./src/domain.js");+ const { loadStudioRun } = await import("./src/run.js");+ const { studioPlugin } = await import("./src/server.js");+ const { inspectStudioRun } = await import("./src/studio-preflight.js");+ const runPath = resolve(invokedFrom, runArgument);+ const packageRootArgument = values.get("package-root");+ const workspaceArgument = values.get("workspace");+ const requestedWorkspaceRoot = workspaceArgument === undefined+ ? undefined+ : resolve(invokedFrom, workspaceArgument);+ const workspaceRoot = await resolveProjectRoot({+ ...(requestedWorkspaceRoot === undefined ? {} : { workspaceRoot: requestedWorkspaceRoot }),+ cwd: invokedFrom,+ });+ const packageRoot = packageRootArgument === undefined+ ? workspaceRoot+ : resolve(invokedFrom, packageRootArgument);+ const runtimeArgument = values.get("runtime");+ const selectedRuntime = runtimeArgument === undefined+ ? await findRuntimeProfile(workspaceRoot)+ : undefined;+ const runtimePath = runtimeArgument === undefined+ ? selectedRuntime?.profile+ : resolve(invokedFrom, runtimeArgument);+ const port = Number(values.get("port") ?? "5179");+ if (!Number.isSafeInteger(port) || port <= 0) invalidArguments("--port must be a positive integer");-const distributionPackageRoot = videoCliDistribution.packageRoot ?? resolve(here, "../..");-const domain = await loadStudioDomain({ run: runPath, workspaceRoot, packageRoot });-const registry = await loadStudioCompanionRegistry({- distributionPackageRoot,- distributionPackages: videoStudioCompanionPackages,- sourcePackages: domain.packages,-});-const buildLibrary = await openStudioBuildLibrary(runtimePath, packageRoot, workspaceRoot, distributionPackageRoot);-let run;-try {- run = await loadStudioRun({- run: runPath,- domain,- registry,- buildLibrary,+ const distributionPackageRoot = videoCliDistribution.packageRoot ?? resolve(here, "../..");+ const domain = await loadStudioDomain({ run: runPath, workspaceRoot, packageRoot });+ const registry = await loadStudioCompanionRegistry({+ distributionPackageRoot,+ distributionPackages: videoStudioCompanionPackages,+ sourcePackages: domain.packages,});-} catch (error) {- await buildLibrary.close();- throw error;-}-const source = run.authorSource;-try {- inspectStudioRun(registry, run.source, run);-} catch (error) {- await buildLibrary.close();- throw error;-}-const distributionImports = {- name: "hypit-distribution-imports",- enforce: "pre" as const,- resolveId(specifier: string): string | undefined {- return resolveDistributionPackageImport(distributionPackageRoot, specifier);- },-};-const server = await createServer({- configFile: false,- root: here,- server: {- port,- // Vite resolves package assets through pnpm's real paths. The package root- // must therefore be readable for self-hosted fonts and other declared- // Studio dependencies, while the author workspace remains separately- // available for Source and material previews.- fs: { allow: [workspaceRoot, packageRoot, distributionPackageRoot, here] },- },- plugins: [distributionImports, studioPlugin({- source,- runPath,- workspaceRoot,- domain,- registry,- ...(buildLibrary === undefined ? {} : { buildLibrary }),- })],-});-server.httpServer?.once("close", () => {- void buildLibrary.close().catch((error: unknown) => {- console.error(error instanceof Error ? error.message : String(error));+ const buildLibrary = await openStudioBuildLibrary(runtimePath, packageRoot, workspaceRoot, distributionPackageRoot);+ let run;+ try {+ run = await loadStudioRun({+ run: runPath,+ domain,+ registry,+ buildLibrary,+ });+ } catch (error) {+ await buildLibrary.close();+ throw error;+ }+ const source = run.authorSource;+ try {+ inspectStudioRun(registry, run.source, run);+ } catch (error) {+ await buildLibrary.close();+ throw error;+ }+ const distributionImports = {+ name: "hypit-distribution-imports",+ enforce: "pre" as const,+ resolveId(specifier: string): string | undefined {+ return resolveDistributionPackageImport(distributionPackageRoot, specifier);+ },+ };+ const server = await createServer({+ configFile: false,+ root: here,+ server: {+ port,+ // Vite resolves package assets through pnpm's real paths. The package root+ // must therefore be readable for self-hosted fonts and other declared+ // Studio dependencies, while the author workspace remains separately+ // available for Source and material previews.+ fs: { allow: [workspaceRoot, packageRoot, distributionPackageRoot, here] },+ },+ plugins: [distributionImports, studioPlugin({+ source,+ runPath,+ workspaceRoot,+ domain,+ registry,+ ...(buildLibrary === undefined ? {} : { buildLibrary }),+ })],+ });+ server.httpServer?.once("close", () => {+ void buildLibrary.close().catch((error: unknown) => {+ console.error(error instanceof Error ? error.message : String(error));+ });});-});-await server.listen();-server.printUrls();+ await server.listen();+ server.printUrls();+}diff --git a/packages/text/README.md b/packages/text/README.mdindex 4179eb55..f654cbb0 100644--- a/packages/text/README.md+++ b/packages/text/README.md@@ -1,7 +1,7 @@# `@hypit/text`-External components use `hypit/text` for graph Text types, template helpers and Producer references,-with `hypit` as a development dependency. Source imports retain `@hypit/text@1`.+External components use `@hypit/hypit/text` for graph Text types, template helpers and Producer references,+with `@hypit/hypit` as a development dependency. Source imports retain `@hypit/text@1`.Domain-neutral text values and deterministic text programs.diff --git a/packages/video-cli/README.md b/packages/video-cli/README.mdindex 5c013268..5832ac21 100644--- a/packages/video-cli/README.md+++ b/packages/video-cli/README.md@@ -105,7 +105,7 @@ what `--to` names and refuse to overwrite. `vocabulary` reads the installedmanifests: every package with its tags and models, or one package's Surfaces with their attributes,children and example, or the value shapes a drawing Producer must emit.-Install the `hypit` Distribution globally once. It resolves its own TypeScript loader and CLI, so it+Install the `@hypit/hypit` Distribution globally once. It resolves its own TypeScript loader and CLI, so itneither invokes npm per command nor requires a project to contain Hypit's `package.json`.`hypit capture screenshot <url-or-file> --to <image>` saves browser material, anddiff --git a/packages/video-cli/src/cli.ts b/packages/video-cli/src/cli.tsindex fe9f8ade..c8fee77c 100644--- a/packages/video-cli/src/cli.ts+++ b/packages/video-cli/src/cli.ts@@ -64,7 +64,9 @@ const io: CliIo = {async function main(): Promise<void> {const commandArgs = argv[0] === "capture" && argv.includes("--") ? argv.slice(0, argv.indexOf("--")) : argv;if (argv.length === 0 || argv[0] === "help" || commandArgs.includes("--help")) {- const topic = argv[0] === "help" ? argv[1] : argv.includes("--help") ? argv[0] : undefined;+ const topic = argv[0] === "help" ? argv[1]+ : argv[0] === "--help" ? undefined+ : argv.includes("--help") ? argv[0] : undefined;if (isCreationCommand(topic)) {writeCreationHelp(io, topic);return;@@ -86,7 +88,7 @@ async function main(): Promise<void> {if (topic === undefined) {io.write(`\nCreation tools (one request through the selected Runtime Profile, no Build)\n${creationCommands.map((item) => ` ${item}`).join("\n")}\n hypit help <tool> for each\n`- + `\nPreparation (local tools and project files)\n media ${mediaCommands.join(" | ")}\n capture screenshot | run | install-browser\n vocabulary\n hypit help media, hypit help capture, hypit help vocabulary\n`);+ + `\nStudio\n studio --run <build.svrun>\n hypit studio --help for session options\n\nPreparation (local tools and project files)\n media ${mediaCommands.join(" | ")}\n capture screenshot | run | install-browser\n vocabulary\n hypit help media, hypit help capture, hypit help vocabulary\n`);}return;}diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex 373efa1f..28222fec 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -300,36 +300,36 @@ importers:examples/minimal-author-package/packages/example-component:devDependencies:+ '@hypit/hypit':+ specifier: workspace:*+ version: link:../../../..'@types/node':specifier: 24.10.1version: 24.10.1- hypit:- specifier: workspace:*- version: link:../../../..typescript:specifier: 5.9.3version: 5.9.3examples/semantic-composition/packages/chat-scene:devDependencies:+ '@hypit/hypit':+ specifier: workspace:*+ version: link:../../../..'@types/node':specifier: 24.10.1version: 24.10.1- hypit:- specifier: workspace:*- version: link:../../../..typescript:specifier: 5.9.3version: 5.9.3examples/semantic-composition/packages/responsive-explainer:devDependencies:+ '@hypit/hypit':+ specifier: workspace:*+ version: link:../../../..'@types/node':specifier: 24.10.1version: 24.10.1- hypit:- specifier: workspace:*- version: link:../../../..typescript:specifier: 5.9.3version: 5.9.3diff --git a/skills/hypit/references/environment/distribution.md b/skills/hypit/references/environment/distribution.mdindex 768ce6df..2b0e818e 100644--- a/skills/hypit/references/environment/distribution.md+++ b/skills/hypit/references/environment/distribution.md@@ -5,10 +5,10 @@ Read this to locate, install, or update the executable Hypit Distribution after## Keep three lifecycles separateThe installed Skill supplies production judgment. The executable Distribution supplies `hypit`,-`hypit-studio`, official packages, and Runtime hosts. A video project supplies the work's Sources,+`hypit studio`, official packages, and Runtime hosts. A video project supplies the work's Sources,Runs, assets, local packages, Profile selection, and Results. They can live in unrelated locationsand none is installed as a side effect of another. `npx skills add hypit-ai/hypit -g` installs the-Skill's knowledge; the executable is the separate npm package `hypit`.+Skill's knowledge; the executable is the separate npm package `@hypit/hypit`.## Find the installation already available@@ -26,8 +26,8 @@ a separate setup question from whether the executable is installed.If the shell cannot find `hypit`, inspect the project's and npm's global package records:```bash-npm ls hypit --depth=0-npm ls --global hypit --depth=0+npm ls @hypit/hypit --depth=0+npm ls --global @hypit/hypit --depth=0npm prefix --global```@@ -42,13 +42,13 @@ launcher, and retain the working command and location in project notes when usefThe usual machine-wide installation command for a published release is:```bash-npm install --global hypit+npm install --global @hypit/hypit```A project can instead keep Hypit in its own dependencies and lockfile:```bash-npm install --save-dev hypit+npm install --save-dev @hypit/hypitnpm exec --no -- hypit --help```diff --git a/skills/hypit/references/environment/model-and-provider.md b/skills/hypit/references/environment/model-and-provider.mdindex 5b97a9b0..445aae7b 100644--- a/skills/hypit/references/environment/model-and-provider.md+++ b/skills/hypit/references/environment/model-and-provider.md@@ -75,22 +75,22 @@ A custom Provider or Model can live in the project's `packages/` directory or arpackage. Source selects Model contributions; the Runtime Profile selects Provider contributions by`use`. The package's `hypit.activation` entry supplies the corresponding facets to those hosts.-The public APIs are supplied by the executable `hypit` Distribution:+The public APIs are supplied by the executable `@hypit/hypit` Distribution:| Import | Responsibility || --- | --- |-| `hypit/author-kit` | Author Module, Surface, component, and Fragment declarations |-| `hypit/model-kit` | Exact model requests and their Producer/Need construction |-| `hypit/generation` | Shared generated-media inputs, results, validation, and wire-mapping helpers |-| `hypit/endpoint-kit` | Capability handlers, credentials, receipts, and capacity declarations |-| `hypit/runtime-kit` | Profile-selected activation, configuration, diagnostics, and Managed Programs |+| `@hypit/hypit/author-kit` | Author Module, Surface, component, and Fragment declarations |+| `@hypit/hypit/model-kit` | Exact model requests and their Producer/Need construction |+| `@hypit/hypit/generation` | Shared generated-media inputs, results, validation, and wire-mapping helpers |+| `@hypit/hypit/endpoint-kit` | Capability handlers, credentials, receipts, and capacity declarations |+| `@hypit/hypit/runtime-kit` | Profile-selected activation, configuration, diagnostics, and Managed Programs |Each API's package README owns its exact fields and examples. Locate those files in the activeDistribution reported by `hypit paths`: `packages/model-kit/README.md`,`packages/generation/README.md`, `packages/endpoint-kit/README.md`, and`packages/runtime-kit/README.md`. They ship with the executable; a repository checkout is unnecessary.-Compile a TypeScript extension against the selected `hypit` development dependency and ship its+Compile a TypeScript extension against the selected `@hypit/hypit` development dependency and ship itsJavaScript and required assets. [Sharing a package](../production/component-sharing.md) explains directtarball handoff and registry releases. Creating an implementation of an existing public extensionpoint belongs in that package. Changing a shared port type, host protocol, or framework behavior isdiff --git a/skills/hypit/references/production/caption-authoring.md b/skills/hypit/references/production/caption-authoring.mdindex 7cda1aa7..6c9fb1c6 100644--- a/skills/hypit/references/production/caption-authoring.md+++ b/skills/hypit/references/production/caption-authoring.md@@ -52,7 +52,7 @@ projection + family parameters → explicit family scheduleschedule + document + program + ProgramSpace → VisualTrack```-Use `hypit/caption` for the common Program and timing helpers and `hypit/narrative` for the Script's+Use `@hypit/hypit/caption` for the common Program and timing helpers and `@hypit/hypit/narrative` for the Script'sdocument and unit types. The common Caption layer handles display-versus-spokenwording, N:M alignment units and complete-unit Selection boundaries. Do not transcribe again,rebuild timing by splitting a string, or use the video model's requested duration as speech evidence.diff --git a/skills/hypit/references/production/component-sharing.md b/skills/hypit/references/production/component-sharing.mdindex 8b5bfcfe..61104c72 100644--- a/skills/hypit/references/production/component-sharing.md+++ b/skills/hypit/references/production/component-sharing.md@@ -116,8 +116,8 @@ JavaScript entry. Declare third-party runtime dependencies in `dependencies`. Inan actual Source example, the public outputs, any companion or asset requirements, and the Hypitrelease used to check it. Inspect the tarball contents with `npm pack --dry-run`.-An executable Author Package develops against `hypit/author-kit` and the relevant `hypit/*` domain-subpaths, with `hypit` as a development dependency. Its release contains its own code and assets;+An executable Author Package develops against `@hypit/hypit/author-kit` and the relevant `@hypit/hypit/*` domain+subpaths, with `@hypit/hypit` as a development dependency. Its release contains its own code and assets;the active Hypit Distribution supplies the framework APIs when loading it. Check the package from aseparate consumer project so local source links do not conceal omitted files or dependencies.diff --git a/skills/hypit/references/production/component-visuals.md b/skills/hypit/references/production/component-visuals.mdindex 4420c0e7..42fe37aa 100644--- a/skills/hypit/references/production/component-visuals.md+++ b/skills/hypit/references/production/component-visuals.md@@ -38,7 +38,7 @@ visual relationships rather than the nesting of tags in Source.## A working drawing function[visuals.ts](examples/visuals.ts) contains `renderCard`, a complete pure drawing function using-`sealVisualTrack` from `hypit/composition`. It receives a projected span and a resolved Frame,+`sealVisualTrack` from `@hypit/hypit/composition`. It receives a projected span and a resolved Frame,draws a colored box with exact-font text, and optionally fades in relative to the Present's start.Its colors, size, padding, layer and entrance duration are supplied by the caller.@@ -53,7 +53,7 @@ then publish the Track through the Fragment and Surface as described in[Track authoring](track-authoring.md#connect-the-implementation-at-its-real-boundaries). Surface outputsmap the Fragment's export name to a public Source name such as `answers.track`.-Use `programSpaceFrameCount` from `hypit/program-space` for the full program's frame count and+Use `programSpaceFrameCount` from `@hypit/hypit/program-space` for the full program's frame count and`assertVisualTrackIdentity(track, space)` to check a produced Track against that space. Direct seekingand range rendering evaluate the same declared keyframes at the requested frame.@@ -92,7 +92,7 @@ make the required materials available both in Studio and in a render of any sele## Compose video and graphics in one browser programWhen a scene's video viewport and graphics share motion or layout, one component can draw them-together. `browserProgram` from `hypit/hyperframes` creates a `program` element's payload. Its HTML+together. `browserProgram` from `@hypit/hypit/hyperframes` creates a `program` element's payload. Its HTMLowns the local structure; CSS supplies layout, stacking, masks, filters and blending; optional`setup(root, data)` code returns `render(localFrame)`. This function sets the complete state at thatframe. A range render may start in the middle, so compute state from the frame and authored inputs.@@ -110,7 +110,7 @@ used by the program belong in its `artifacts` list; `hyperframesResourceUri` supURLs. The rendering environment materializes those references.For a semantic performance, `projectSemanticMedia(semantic, window.span)` from-`hypit/semantic-track` returns each intersecting Take's prepared media, program span and source+`@hypit/hypit/semantic-track` returns each intersecting Take's prepared media, program span and sourcespan. Subtract the outer Window's start to obtain Present-local video sampling intervals. Preservethe returned source offset: moving or reframing a video changes its presentation while playbackcontinues from the same place. Original sound can remain `speech.audio` in Film.diff --git a/skills/hypit/references/production/examples/visuals.ts b/skills/hypit/references/production/examples/visuals.tsindex 9adc7b85..ab47e791 100644--- a/skills/hypit/references/production/examples/visuals.ts+++ b/skills/hypit/references/production/examples/visuals.ts@@ -1,8 +1,8 @@-import { sealVisualTrack } from "hypit/composition";-import type { FrameSpan } from "hypit/composition";-import type { FontArtifactRef } from "hypit/media";-import type { ProgramSpace } from "hypit/program-space";-import { VISUAL_IR_V1 } from "hypit/visual-ir";+import { sealVisualTrack } from "@hypit/hypit/composition";+import type { FrameSpan } from "@hypit/hypit/composition";+import type { FontArtifactRef } from "@hypit/hypit/media";+import type { ProgramSpace } from "@hypit/hypit/program-space";+import { VISUAL_IR_V1 } from "@hypit/hypit/visual-ir";// The caller supplies its projected Window, resolved Frame and selected font faces.export function renderCard(input: {diff --git a/skills/hypit/references/production/studio.md b/skills/hypit/references/production/studio.mdindex cc544a92..ab193f33 100644--- a/skills/hypit/references/production/studio.md+++ b/skills/hypit/references/production/studio.md@@ -9,7 +9,7 @@ useful Studio presentation. [Review](review.md) owns the judgment made from theFrom the video project, use the installed Distribution's command:```bash-hypit-studio --run build.svrun+hypit studio --run build.svrun```Supply `--runtime <profile>` when intentionally using a different Profile from the project's@@ -102,8 +102,8 @@ project package can supply its own without editing Studio or adding a Studio Prootherwise unselected package does not activate a plugin. The installed `@hypit/studio-adapter`README gives the exact ABI, a minimal Companion and the activation wiring.-An external Companion imports `hypit/studio-adapter` and the relevant public `hypit/*` domain APIs,-with `hypit` as a development dependency. Ship the compiled Companion with the component. Its+An external Companion imports `@hypit/hypit/studio-adapter` and the relevant public `@hypit/hypit/*` domain APIs,+with `@hypit/hypit` as a development dependency. Ship the compiled Companion with the component. ItsSource-selected activation contributes the editor facet alongside the component's existing facets.Expose meaningful deterministic schedule/program outputs when the Companion needs more than thediff --git a/skills/hypit/references/production/track-authoring.md b/skills/hypit/references/production/track-authoring.mdindex d0125e00..16cfbe1e 100644--- a/skills/hypit/references/production/track-authoring.md+++ b/skills/hypit/references/production/track-authoring.md@@ -55,7 +55,7 @@ receives its own appropriate projection, but all refer to the same authored evenmoves the event without asking each component to search for a word or inspect the Script parser.For a component that also serves authored animation, `resolveTemporalContext` and `createTemporalSpace`-from `hypit/temporal-markup` supply the chosen film clock. Clock expressions project directly through+from `@hypit/hypit/temporal-markup` supply the chosen film clock. Clock expressions project directly throughthat space; Script references use its semantic context. The drawing code consumes the resolvedvalues in either case. The installed `examples/semantic-composition/packages/chat-scene` demonstratesrepeated content children with their own events and a program drawn entirely in code.@@ -119,7 +119,7 @@ are ordinary Source and Recipe decisions.## Write the smallest component that expresses the roleDeclare the new package in the project's `packages/` and ordinary package configuration. Read the-installed `hypit/author-kit` README for the public package boundary and inspect a close installed sibling for+installed `@hypit/hypit/author-kit` README for the public package boundary and inspect a close installed sibling forthe relevant implementation, rather than depending on a monorepo example directory being present.`@hypit/interview-emoji-reveal` demonstrates persistent Moment-driven state; `@hypit/ranking`demonstrates reveal Windows and settled rows; `@hypit/media-track` demonstrates occupancy and Handoffs.@@ -169,7 +169,7 @@ A Moment needs the semantic context that locates its Script anchor.Keep each child's `subjectId` meaningful to the component while qualifying graph ids by its owningTrack, so multiple instances can coexist. A finite create/append/finalize graph supports any authorednumber of messages or cards with ordinary fixed Producer ports. The exact helpers and vocabulary-live in `hypit/temporal-markup`; the `@example/chat-scene` package demonstrates both time sources.+live in `@hypit/hypit/temporal-markup`; the `@example/chat-scene` package demonstrates both time sources.A scene may publish computed event times when another component needs them, just as it publishes aTrack. This shares pre-render data. When the author already specifies a common trigger, consumers@@ -180,7 +180,7 @@ draw nothing; inside it, each slot shows its preset/activated answer or its placentrance motion relative to that slot's activation frame. Deriving state directly from declared inputsand the requested frame keeps Studio scrubbing and partial or concurrent rendering deterministic.-Emit the public VisualTrack representation through `hypit/composition` and `hypit/visual-ir`.+Emit the public VisualTrack representation through `@hypit/hypit/composition` and `@hypit/hypit/visual-ir`.[Component visuals](component-visuals.md) explains Presents, element trees, local animation,prepared surfaces and a complete drawing function. [Spatial layout](spatial.md) explains incomingFrames, and [Fonts and text](fonts-and-text.md) explains font resources.diff --git a/skills/hypit/references/production/vocabulary.md b/skills/hypit/references/production/vocabulary.mdindex 272076e6..24aa91bb 100644--- a/skills/hypit/references/production/vocabulary.md+++ b/skills/hypit/references/production/vocabulary.md@@ -68,12 +68,12 @@ Keep the boundary useful:- Runtime Profiles own external execution and credentials;- Provider packages implement media tools and external services.-Read the installed `hypit/author-kit` README for the public package boundary and a relevant component+Read the installed `@hypit/hypit/author-kit` README for the public package boundary and a relevant componentfor an implementation example. Give the new package its own Module identity and use the projectowner's scope; the selected Distribution owns the reserved `@hypit/*` namespace.-TypeScript imports use public SDK paths such as `hypit/author-kit`, `hypit/composition`,-`hypit/text`, `hypit/caption` or `hypit/studio-adapter`. Source imports instead name logical Modules,+TypeScript imports use public SDK paths such as `@hypit/hypit/author-kit`, `@hypit/hypit/composition`,+`@hypit/hypit/text`, `@hypit/hypit/caption` or `@hypit/hypit/studio-adapter`. Source imports instead name logical Modules,such as `@hypit/caption@1`. When learning from installed official source, translate its internalworkspace imports to the corresponding public SDK paths in the project package.