@warpgogol/forge 0.14.0 → 0.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/forge",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -15,107 +15,107 @@
     "framework"
   ],
   "homepage": "https://warpgogol.com",
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
   "bin": {
     "forge": "./bin/cli.js"
   },
   "exports": {
     ".": {
-      "types": "./dist/src/index.d.ts",
-      "default": "./dist/src/index.js"
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
     },
     "./types": {
-      "types": "./dist/src/types.d.ts",
-      "default": "./dist/src/types.js"
+      "types": "./src/types.ts",
+      "default": "./src/types.ts"
     },
     "./utils": {
-      "types": "./dist/src/utils/index.d.ts",
-      "default": "./dist/src/utils/index.js"
+      "types": "./src/utils/index.ts",
+      "default": "./src/utils/index.ts"
     },
     "./config": {
-      "types": "./dist/src/config/forge-config.d.ts",
-      "default": "./dist/src/config/forge-config.js"
+      "types": "./src/config/forge-config.ts",
+      "default": "./src/config/forge-config.ts"
     },
     "./os/core": {
-      "types": "./dist/os/core/core.module.d.ts",
-      "default": "./dist/os/core/core.module.js"
+      "types": "./os/core/core.module.ts",
+      "default": "./os/core/core.module.ts"
     },
     "./os/compass": {
-      "types": "./dist/os/compass/index.d.ts",
-      "default": "./dist/os/compass/index.js"
+      "types": "./os/compass/index.ts",
+      "default": "./os/compass/index.ts"
     },
     "./os/naming": {
-      "types": "./dist/os/naming/index.d.ts",
-      "default": "./dist/os/naming/index.js"
+      "types": "./os/naming/index.ts",
+      "default": "./os/naming/index.ts"
     },
     "./os/naming-module": {
-      "types": "./dist/os/naming/naming.module.d.ts",
-      "default": "./dist/os/naming/naming.module.js"
+      "types": "./os/naming/naming.module.ts",
+      "default": "./os/naming/naming.module.ts"
     },
     "./os/rfc": {
-      "types": "./dist/os/rfc/index.d.ts",
-      "default": "./dist/os/rfc/index.js"
+      "types": "./os/rfc/index.ts",
+      "default": "./os/rfc/index.ts"
     },
     "./os/rfc-module": {
-      "types": "./dist/os/rfc/rfc.module.d.ts",
-      "default": "./dist/os/rfc/rfc.module.js"
+      "types": "./os/rfc/rfc.module.ts",
+      "default": "./os/rfc/rfc.module.ts"
     },
     "./os/werkstatt": {
-      "types": "./dist/os/werkstatt/index.d.ts",
-      "default": "./dist/os/werkstatt/index.js"
+      "types": "./os/werkstatt/index.ts",
+      "default": "./os/werkstatt/index.ts"
     },
     "./os/workflow": {
-      "types": "./dist/os/workflow/index.d.ts",
-      "default": "./dist/os/workflow/index.js"
+      "types": "./os/workflow/index.ts",
+      "default": "./os/workflow/index.ts"
     },
     "./os/workflow-module": {
-      "types": "./dist/os/workflow/workflow.module.d.ts",
-      "default": "./dist/os/workflow/workflow.module.js"
+      "types": "./os/workflow/workflow.module.ts",
+      "default": "./os/workflow/workflow.module.ts"
     },
     "./os/spec-module": {
-      "types": "./dist/os/spec/spec.module.d.ts",
-      "default": "./dist/os/spec/spec.module.js"
+      "types": "./os/spec/spec.module.ts",
+      "default": "./os/spec/spec.module.ts"
     },
     "./os/adr": {
-      "types": "./dist/os/adr/index.d.ts",
-      "default": "./dist/os/adr/index.js"
+      "types": "./os/adr/index.ts",
+      "default": "./os/adr/index.ts"
     },
     "./os/adr-module": {
-      "types": "./dist/os/adr/adr.module.d.ts",
-      "default": "./dist/os/adr/adr.module.js"
+      "types": "./os/adr/adr.module.ts",
+      "default": "./os/adr/adr.module.ts"
     },
     "./os/plan": {
-      "types": "./dist/os/plan/index.d.ts",
-      "default": "./dist/os/plan/index.js"
+      "types": "./os/plan/index.ts",
+      "default": "./os/plan/index.ts"
     },
     "./os/plan-module": {
-      "types": "./dist/os/plan/plan.module.d.ts",
-      "default": "./dist/os/plan/plan.module.js"
+      "types": "./os/plan/plan.module.ts",
+      "default": "./os/plan/plan.module.ts"
     },
     "./os/audit": {
-      "types": "./dist/os/audit/index.d.ts",
-      "default": "./dist/os/audit/index.js"
+      "types": "./os/audit/index.ts",
+      "default": "./os/audit/index.ts"
     },
     "./os/audit-module": {
-      "types": "./dist/os/audit/audit.module.d.ts",
-      "default": "./dist/os/audit/audit.module.js"
+      "types": "./os/audit/audit.module.ts",
+      "default": "./os/audit/audit.module.ts"
     },
     "./os/session": {
-      "types": "./dist/os/session/index.d.ts",
-      "default": "./dist/os/session/index.js"
+      "types": "./os/session/index.ts",
+      "default": "./os/session/index.ts"
     },
     "./os/session-module": {
-      "types": "./dist/os/session/session.module.d.ts",
-      "default": "./dist/os/session/session.module.js"
+      "types": "./os/session/session.module.ts",
+      "default": "./os/session/session.module.ts"
     },
     "./os/mission": {
-      "types": "./dist/os/mission/index.d.ts",
-      "default": "./dist/os/mission/index.js"
+      "types": "./os/mission/index.ts",
+      "default": "./os/mission/index.ts"
     },
     "./os/mission-module": {
-      "types": "./dist/os/mission/mission.module.d.ts",
-      "default": "./dist/os/mission/mission.module.js"
+      "types": "./os/mission/mission.module.ts",
+      "default": "./os/mission/mission.module.ts"
     }
   },
   "files": [
@@ -129,6 +129,15 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "pnpm exec tsc -p tsconfig.json",
+    "build:check": "pnpm exec tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run clean && pnpm run build && node scripts/publish-check.mjs && node scripts/strip-workspace-deps.mjs",
+    "postpublish": "git checkout -- ./package.json",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.700.0",
     "trash": "^10.1.1",
@@ -145,13 +154,106 @@
     "node": ">=20.0.0"
   },
   "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "pnpm exec tsc -p tsconfig.json",
-    "build:check": "pnpm exec tsc -p tsconfig.json --noEmit",
-    "clean": "rm -rf dist",
-    "test": "vitest run --passWithNoTests",
-    "test:watch": "vitest"
+    "access": "public",
+    "main": "./dist/src/index.js",
+    "types": "./dist/src/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/src/index.d.ts",
+        "default": "./dist/src/index.js"
+      },
+      "./types": {
+        "types": "./dist/src/types.d.ts",
+        "default": "./dist/src/types.js"
+      },
+      "./utils": {
+        "types": "./dist/src/utils/index.d.ts",
+        "default": "./dist/src/utils/index.js"
+      },
+      "./config": {
+        "types": "./dist/src/config/forge-config.d.ts",
+        "default": "./dist/src/config/forge-config.js"
+      },
+      "./os/core": {
+        "types": "./dist/os/core/core.module.d.ts",
+        "default": "./dist/os/core/core.module.js"
+      },
+      "./os/compass": {
+        "types": "./dist/os/compass/index.d.ts",
+        "default": "./dist/os/compass/index.js"
+      },
+      "./os/naming": {
+        "types": "./dist/os/naming/index.d.ts",
+        "default": "./dist/os/naming/index.js"
+      },
+      "./os/naming-module": {
+        "types": "./dist/os/naming/naming.module.d.ts",
+        "default": "./dist/os/naming/naming.module.js"
+      },
+      "./os/rfc": {
+        "types": "./dist/os/rfc/index.d.ts",
+        "default": "./dist/os/rfc/index.js"
+      },
+      "./os/rfc-module": {
+        "types": "./dist/os/rfc/rfc.module.d.ts",
+        "default": "./dist/os/rfc/rfc.module.js"
+      },
+      "./os/werkstatt": {
+        "types": "./dist/os/werkstatt/index.d.ts",
+        "default": "./dist/os/werkstatt/index.js"
+      },
+      "./os/workflow": {
+        "types": "./dist/os/workflow/index.d.ts",
+        "default": "./dist/os/workflow/index.js"
+      },
+      "./os/workflow-module": {
+        "types": "./dist/os/workflow/workflow.module.d.ts",
+        "default": "./dist/os/workflow/workflow.module.js"
+      },
+      "./os/spec-module": {
+        "types": "./dist/os/spec/spec.module.d.ts",
+        "default": "./dist/os/spec/spec.module.js"
+      },
+      "./os/adr": {
+        "types": "./dist/os/adr/index.d.ts",
+        "default": "./dist/os/adr/index.js"
+      },
+      "./os/adr-module": {
+        "types": "./dist/os/adr/adr.module.d.ts",
+        "default": "./dist/os/adr/adr.module.js"
+      },
+      "./os/plan": {
+        "types": "./dist/os/plan/index.d.ts",
+        "default": "./dist/os/plan/index.js"
+      },
+      "./os/plan-module": {
+        "types": "./dist/os/plan/plan.module.d.ts",
+        "default": "./dist/os/plan/plan.module.js"
+      },
+      "./os/audit": {
+        "types": "./dist/os/audit/index.d.ts",
+        "default": "./dist/os/audit/index.js"
+      },
+      "./os/audit-module": {
+        "types": "./dist/os/audit/audit.module.d.ts",
+        "default": "./dist/os/audit/audit.module.js"
+      },
+      "./os/session": {
+        "types": "./dist/os/session/index.d.ts",
+        "default": "./dist/os/session/index.js"
+      },
+      "./os/session-module": {
+        "types": "./dist/os/session/session.module.d.ts",
+        "default": "./dist/os/session/session.module.js"
+      },
+      "./os/mission": {
+        "types": "./dist/os/mission/index.d.ts",
+        "default": "./dist/os/mission/index.js"
+      },
+      "./os/mission-module": {
+        "types": "./dist/os/mission/mission.module.d.ts",
+        "default": "./dist/os/mission/mission.module.js"
+      }
+    }
   }
-}
+}

package/profiles/editframe-templates/composition-agents.md

@@ -0,0 +1,70 @@
+# Composition Workspace
+
+This workspace contains an Editframe video composition.
+
+## Domain terminology
+
+- **Composition** — the artifact this workspace produces (a `.tsx` file using `@editframe/react` components).
+- **Scene** — a structural module within a composition (a `Timegroup` block).
+- **Director** — the operator who creates and renders the composition.
+
+## Quality invariants
+
+| ID | Description | Severity |
+| --- | --- | --- |
+| VIDEO-01 | Composition filenames must use kebab-case (lowercase letters, digits, hyphens only). | error |
+| VIDEO-02 | Scene durations must use `contain` fit mode by default to avoid unexpected cropping. Use `cover` or `fill` only when intentionally overriding. | warning |
+| VIDEO-03 | All speech audio elements (`Audio` with speech content) must have corresponding `Captions` components for accessibility. | error |
+
+Additional time model invariants (VIDEO-04 through VIDEO-09) may be available. Run `forge doctor` to check the full invariant set enforced by the active profile.
+
+## Time model concepts
+
+Editframe compositions use a time model based on `Timegroup` components from `@editframe/react`:
+
+- **`TimelineRoot`** — the root container for the composition.
+- **`Timegroup`** — a container that groups scenes and controls timing. The root Timegroup defines the composition's total duration.
+- **`mode`** — timing behavior for children: `sequence` (play one after another), `fixed` (play at absolute offset), `contain` (fit within parent duration), `fit` (scale to fit).
+- **`duration`** — CSS time string (e.g. `5s`, `300ms`, `2.5s`) defining how long the element plays.
+- **`offset`** — CSS time string defining when the element starts relative to its parent.
+- **`fps`** — positive integer defining frames per second (e.g. `30`, `60`).
+- **`loop`** — boolean, only on the root Timegroup. Nested Timegroups should not loop.
+
+## Workflow
+
+1. Create a `.tsx` file with `@editframe/react` components (`TimelineRoot`, `Timegroup`, `Video`, `Audio`, `Text`, `Captions`).
+2. Run `editframe preview` to preview the composition in the browser.
+3. Run `ef-composition-review` to review the composition for time model correctness, accessibility, and best practices.
+4. Run `editframe check` to validate the composition structure.
+5. Run `editframe render -o dist/<name>.mp4` to produce the final video output.
+6. Run `ef-render-verify` to verify the render — validation, build, determinism, output inspection.
+
+## Skills
+
+- **ef-onboard** — onboard a new project: prerequisites, discovery, scaffold, preview. Trigger: "create a new video project".
+- **ef-composition-review** — review a composition for time model correctness, accessibility, and best practices before rendering. Trigger: "review this composition".
+- **ef-render-verify** — verify a render: validate, build, check determinism, inspect output. Trigger: "render and verify".
+- **ef-composition** — guide creating a new video composition with Editframe React components. Trigger: "create a video composition".
+- **ef-dev-server** — set up and manage the Editframe dev server for live preview. Trigger: "set up editframe dev server".
+- **ef-editor-gui** — configure the Editframe editor GUI for visual composition editing. Trigger: "open editframe editor".
+- **ef-webhooks** — configure Editframe webhooks for render status notifications. Trigger: "set up editframe webhooks".
+- **ef-brand-video-generator** — generate brand video compositions from templates. Trigger: "generate a brand video".
+- **ef-motion-design** — apply motion design patterns to compositions. Trigger: "add motion design".
+
+## External resources
+
+- [Editframe llms.txt](https://editframe.com/llms.txt) — machine-readable index of Editframe domain skills
+- [Editframe composition skill](https://editframe.com/skills/composition.md) — full reference for time model, elements, and rendering
+- [Editframe getting started](https://editframe.com/getting-started) — step-by-step guide and agent prompt
+
+## Reference template
+
+A sample composition template is available at `editframe-templates/composition.tsx` in the forge profiles directory. Copy it to start a new composition:
+
+```sh
+cp node_modules/@warpgogol/forge/profiles/editframe-templates/composition.tsx compositions/my-new-video/composition.tsx
+```
+
+## File naming
+
+Composition files use kebab-case: `my-video.tsx`, `product-demo.tsx`, `intro-clip.tsx`.

package/profiles/editframe-templates/composition.tsx

@@ -0,0 +1,33 @@
+/*
+  Editframe React composition template
+  Copy this file to start a new composition. @editframe/react components:
+  - TimelineRoot: root container for the composition
+  - Timegroup: groups elements into a timed sequence
+  - Video: video source with fit mode (contain, cover, fill)
+  - Audio: audio source
+  - Text: text overlay with positioning
+  - Captions: accessibility captions for speech audio
+  Run `editframe preview` to preview, `editframe render` to produce output.
+*/
+import { TimelineRoot, Timegroup, Video, Text, Audio, Captions } from "@editframe/react";
+
+export default function Composition() {
+  return (
+    <TimelineRoot>
+      <Timegroup duration="10s">
+        <Video src="assets/background.mp4" fit="contain" duration="10s" />
+        <Text
+          text="Your text here"
+          x="50%"
+          y="50%"
+          fontSize="48px"
+          color="white"
+          textAlign="center"
+          duration="5s"
+        />
+        <Audio src="assets/narration.mp3" />
+        <Captions src="assets/captions.vtt" />
+      </Timegroup>
+    </TimelineRoot>
+  );
+}

package/profiles/{editframe-html-templates/composition-agents.md → editframe-templates/html-composition-agents.md}

@@ -1,10 +1,10 @@
-# Composition Workspace
+# HTML Composition Workspace
 
-This workspace contains an Editframe video composition.
+This workspace contains an Editframe video composition using HTML web components.
 
 ## Domain terminology
 
-- **Composition** — the artifact this workspace produces (an HTML file using Editframe custom elements).
+- **Composition** — the artifact this workspace produces (an `.html` file using Editframe web components).
 - **Scene** — a structural module within a composition (an `ef-timegroup` block).
 - **Director** — the operator who creates and renders the composition.
 
@@ -14,24 +14,25 @@ This workspace contains an Editframe video composition.
 | --- | --- | --- |
 | VIDEO-01 | Composition filenames must use kebab-case (lowercase letters, digits, hyphens only). | error |
 | VIDEO-02 | Scene durations must use `contain` fit mode by default to avoid unexpected cropping. Use `cover` or `fill` only when intentionally overriding. | warning |
-| VIDEO-03 | All speech audio elements (`ef-audio` with speech content) must have corresponding `ef-captions` elements for accessibility. | error |
+| VIDEO-03 | All speech audio elements (`ef-audio` with speech content) must have corresponding `ef-captions` components for accessibility. | error |
 
 Additional time model invariants (VIDEO-04 through VIDEO-09) may be available. Run `forge doctor` to check the full invariant set enforced by the active profile.
 
 ## Time model concepts
 
-Editframe compositions use a time model based on `ef-timegroup` elements:
+Editframe HTML compositions use a time model based on web components:
 
-- **`ef-timegroup`** — a container that groups scenes and controls timing. The root timegroup defines the composition's total duration.
+- **`ef-timeline`** — the root container for the composition.
+- **`ef-timegroup`** — a container that groups scenes and controls timing. The root ef-timegroup defines the composition's total duration.
 - **`mode`** — timing behavior for children: `sequence` (play one after another), `fixed` (play at absolute offset), `contain` (fit within parent duration), `fit` (scale to fit).
 - **`duration`** — CSS time string (e.g. `5s`, `300ms`, `2.5s`) defining how long the element plays.
 - **`offset`** — CSS time string defining when the element starts relative to its parent.
 - **`fps`** — positive integer defining frames per second (e.g. `30`, `60`).
-- **`loop`** — boolean, only on the root timegroup. Nested timegroups should not loop.
+- **`loop`** — boolean, only on the root ef-timegroup. Nested ef-timegroups should not loop.
 
 ## Workflow
 
-1. Create a `.html` file with Editframe custom elements (`ef-timegroup`, `ef-video`, `ef-audio`, `ef-text`, `ef-captions`).
+1. Create an `.html` file with Editframe web components (`ef-timeline`, `ef-timegroup`, `ef-video`, `ef-audio`, `ef-text`, `ef-captions`).
 2. Run `editframe preview` to preview the composition in the browser.
 3. Run `ef-composition-review` to review the composition for time model correctness, accessibility, and best practices.
 4. Run `editframe check` to validate the composition structure.
@@ -43,6 +44,12 @@ Editframe compositions use a time model based on `ef-timegroup` elements:
 - **ef-onboard** — onboard a new project: prerequisites, discovery, scaffold, preview. Trigger: "create a new video project".
 - **ef-composition-review** — review a composition for time model correctness, accessibility, and best practices before rendering. Trigger: "review this composition".
 - **ef-render-verify** — verify a render: validate, build, check determinism, inspect output. Trigger: "render and verify".
+- **ef-composition** — guide creating a new video composition with Editframe HTML components. Trigger: "create a video composition".
+- **ef-dev-server** — set up and manage the Editframe dev server for live preview. Trigger: "set up editframe dev server".
+- **ef-editor-gui** — configure the Editframe editor GUI for visual composition editing. Trigger: "open editframe editor".
+- **ef-webhooks** — configure Editframe webhooks for render status notifications. Trigger: "set up editframe webhooks".
+- **ef-brand-video-generator** — generate brand video compositions from templates. Trigger: "generate a brand video".
+- **ef-motion-design** — apply motion design patterns to compositions. Trigger: "add motion design".
 
 ## External resources
 
@@ -50,14 +57,6 @@ Editframe compositions use a time model based on `ef-timegroup` elements:
 - [Editframe composition skill](https://editframe.com/skills/composition.md) — full reference for time model, elements, and rendering
 - [Editframe getting started](https://editframe.com/getting-started) — step-by-step guide and agent prompt
 
-## Reference template
-
-A sample composition template is available at `editframe-html-templates/composition.html` in the forge profiles directory. Copy it to start a new composition:
-
-```sh
-cp node_modules/@warpgogol/forge/profiles/editframe-html-templates/composition.html compositions/my-new-video/composition.html
-```
-
 ## File naming
 
 Composition files use kebab-case: `my-video.html`, `product-demo.html`, `intro-clip.html`.