flomotion 0.0.0-stage → 0.2.0

package/dist/core.mjs

@@ -0,0 +1,340 @@
+import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
+import {
+  AT_PRESETS,
+  Adjustment,
+  BLEND_MODES,
+  CODECUT_DIR,
+  CODECUT_NAME,
+  CODECUT_SCOPE,
+  CacheMeasurer,
+  CollectingMeasurer,
+  Composition,
+  DEFAULT_LINT_CONFIG,
+  DIRECTIONS8,
+  EDIT_OPS,
+  FONT_SOURCES,
+  Font,
+  Fonts,
+  Fragment,
+  Group,
+  ID_PREFIX,
+  KEY_OPS,
+  Keyframes,
+  MOTION_DIRECTIONS,
+  Marker,
+  Precomp,
+  Registry,
+  Scene,
+  Sequence,
+  Stagger,
+  TRACK_KINDS,
+  TRANSITION_TYPES,
+  Track,
+  angle,
+  applyDefaults,
+  applyPatches,
+  assertProps,
+  asset,
+  assignMissingIds,
+  bakeHz,
+  bakeSignal,
+  bool,
+  buildIR,
+  buildSignal,
+  checkPurity,
+  clamp,
+  clamp01,
+  classifyFontLicense,
+  collectIds,
+  color,
+  color3,
+  compileProject,
+  constant,
+  contrastRatio,
+  cubicBezier,
+  curve,
+  curves,
+  defineComponent,
+  defineEffect,
+  defineLook,
+  deriveLintRules,
+  docsIndexMarkdown,
+  docsMarkdown,
+  ease,
+  edit_exports,
+  effectCommon,
+  emptyLedger,
+  enumOf,
+  estimateText,
+  evalColor,
+  evalDiscrete,
+  evalEase,
+  evalNumber,
+  evalProp,
+  evalSignal,
+  evalTrack,
+  evalVec,
+  exprSignal,
+  external_exports,
+  file,
+  fill,
+  findEntry,
+  formatTime,
+  framesToSeconds,
+  generateId,
+  getLook,
+  graphemes,
+  group,
+  halfPlanePolygon,
+  hashSeed,
+  int,
+  isConst,
+  isExpr,
+  isKeyframes,
+  isSignal,
+  json,
+  length,
+  lerp,
+  lerpColor,
+  lintProject,
+  lintTree,
+  list,
+  listLooks,
+  luminance,
+  makeCtx,
+  mcpToolSchemas,
+  measureKey,
+  motionContribution,
+  motionFields,
+  mulberry32,
+  noise1D,
+  noise2D,
+  normalizeTrack,
+  num,
+  parseAngle,
+  parseColor,
+  parseControlValue,
+  parseEase,
+  parseLength,
+  parseTimeLiteral,
+  parseTimeSpec,
+  pathAngle,
+  propsJsonSchema,
+  propsTypeSource,
+  ref,
+  registry,
+  remap,
+  resolveLength,
+  resolveProject,
+  richText,
+  runEdit,
+  runKeyOp,
+  secondsToFrames,
+  signalSpan,
+  smoothstep,
+  snapToFrame,
+  springEase,
+  springSettleTime,
+  springValue,
+  suggest,
+  text,
+  time,
+  timingControls,
+  toCss,
+  toGsapEase,
+  toHex,
+  toTimecode,
+  toVec2,
+  toVec3,
+  trackSpan,
+  transformControls,
+  transitionPlan,
+  undoEdit,
+  upsertEntry,
+  validateProps,
+  vec2,
+  vec3
+} from "./chunks/chunk-AVP5XX4G.mjs";
+import {
+  CodeCutError,
+  FRAGMENT,
+  cloneNode,
+  findById,
+  flattenChildren,
+  isCodeCutError,
+  isNode,
+  jsx,
+  jsxDEV,
+  jsxs,
+  serializeNode,
+  walk
+} from "./chunks/chunk-IUSYVGP6.mjs";
+export {
+  AT_PRESETS,
+  Adjustment,
+  BLEND_MODES,
+  CODECUT_DIR,
+  CODECUT_NAME,
+  CODECUT_SCOPE,
+  CacheMeasurer,
+  CodeCutError,
+  CollectingMeasurer,
+  Composition,
+  DEFAULT_LINT_CONFIG,
+  DIRECTIONS8,
+  EDIT_OPS,
+  FONT_SOURCES,
+  FRAGMENT,
+  Font,
+  Fonts,
+  Fragment,
+  Group,
+  ID_PREFIX,
+  KEY_OPS,
+  Keyframes,
+  MOTION_DIRECTIONS,
+  Marker,
+  Precomp,
+  Registry,
+  Scene,
+  Sequence,
+  Stagger,
+  TRACK_KINDS,
+  TRANSITION_TYPES,
+  Track,
+  angle,
+  applyDefaults,
+  applyPatches,
+  assertProps,
+  asset,
+  assignMissingIds,
+  bakeHz,
+  bakeSignal,
+  bool,
+  buildIR,
+  buildSignal,
+  checkPurity,
+  clamp,
+  clamp01,
+  classifyFontLicense,
+  cloneNode,
+  collectIds,
+  color,
+  color3,
+  compileProject,
+  constant,
+  contrastRatio,
+  cubicBezier,
+  curve,
+  curves,
+  defineComponent,
+  defineEffect,
+  defineLook,
+  deriveLintRules,
+  docsIndexMarkdown,
+  docsMarkdown,
+  ease,
+  edit_exports as edit,
+  effectCommon,
+  emptyLedger,
+  enumOf,
+  enumOf as enum_,
+  estimateText,
+  evalColor,
+  evalDiscrete,
+  evalEase,
+  evalNumber,
+  evalProp,
+  evalSignal,
+  evalTrack,
+  evalVec,
+  exprSignal,
+  file,
+  fill,
+  findById,
+  findEntry,
+  flattenChildren,
+  formatTime,
+  framesToSeconds,
+  generateId,
+  getLook,
+  graphemes,
+  group,
+  halfPlanePolygon,
+  hashSeed,
+  int,
+  isCodeCutError,
+  isConst,
+  isExpr,
+  isKeyframes,
+  isNode,
+  isSignal,
+  json,
+  jsx,
+  jsxDEV,
+  jsxs,
+  length,
+  lerp,
+  lerpColor,
+  lintProject,
+  lintTree,
+  list,
+  listLooks,
+  luminance,
+  makeCtx,
+  mcpToolSchemas,
+  measureKey,
+  motionContribution,
+  motionFields,
+  mulberry32,
+  noise1D,
+  noise2D,
+  normalizeTrack,
+  num,
+  parseAngle,
+  parseColor,
+  parseControlValue,
+  parseEase,
+  parseLength,
+  parseTimeLiteral,
+  parseTimeSpec,
+  pathAngle,
+  propsJsonSchema,
+  propsTypeSource,
+  ref,
+  registry,
+  remap,
+  resolveLength,
+  resolveProject,
+  richText,
+  runEdit,
+  runKeyOp,
+  secondsToFrames,
+  serializeNode,
+  signalSpan,
+  smoothstep,
+  snapToFrame,
+  springEase,
+  springSettleTime,
+  springValue,
+  suggest,
+  text,
+  time,
+  timingControls,
+  toCss,
+  toGsapEase,
+  toHex,
+  toTimecode,
+  toVec2,
+  toVec3,
+  trackSpan,
+  transformControls,
+  transitionPlan,
+  undoEdit,
+  upsertEntry,
+  validateProps,
+  vec2,
+  vec3,
+  walk,
+  external_exports as z
+};

package/dist/hooks.mjs

@@ -0,0 +1,66 @@
+// Node module hooks for the published CLI (registered by bin.ts; not used in the repo, where tsx does this).
+//
+// 1. Project files import "@codecut/components" and the JSX runtime "@codecut/core/jsx-runtime". In a published
+//    install those names are not in any node_modules, so map them (and the public "codecut/…" names) to the files
+//    of the running install. One copy of each module means one component registry, whatever else is installed.
+// 2. TypeScript and TSX files outside node_modules are compiled with esbuild using the JSX runtime of
+//    @codecut/core. Nothing depends on the working directory or on a tsconfig.json that may not exist yet.
+import { readFileSync, existsSync, statSync } from "node:fs";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { transformSync } from "esbuild";
+
+const here = new URL("./", import.meta.url);
+const LIBS = new Map([
+  ["@codecut/core", "core.mjs"],
+  ["@codecut/components", "components.mjs"],
+  ["@codecut/core/jsx-runtime", "jsx-runtime.mjs"],
+  ["@codecut/core/jsx-dev-runtime", "jsx-dev-runtime.mjs"],
+  ["codecut/core", "core.mjs"],
+  ["codecut/components", "components.mjs"],
+  ["codecut/jsx-runtime", "jsx-runtime.mjs"],
+  ["codecut/jsx-dev-runtime", "jsx-dev-runtime.mjs"],
+  ["flomotion/core", "core.mjs"],
+  ["flomotion/components", "components.mjs"],
+  ["flomotion/jsx-runtime", "jsx-runtime.mjs"],
+  ["flomotion/jsx-dev-runtime", "jsx-dev-runtime.mjs"],
+]);
+const TS = /\.(tsx?|jsx|mts)$/;
+const isFile = (p) => existsSync(p) && statSync(p).isFile();
+
+export async function resolve(specifier, context, nextResolve) {
+  const lib = LIBS.get(specifier);
+  if (lib) return { url: new URL(lib, here).href, format: "module", shortCircuit: true };
+  // relative imports of project files: "./helpers" -> helpers.ts / helpers.tsx / helpers/index.ts, "./a.js" -> a.ts
+  if (
+    /^\.\.?\//.test(specifier) &&
+    context.parentURL?.startsWith("file:") &&
+    !context.parentURL.includes("/node_modules/")
+  ) {
+    const base = fileURLToPath(new URL(specifier, context.parentURL));
+    const tries = [];
+    if (/\.[cm]?js$/.test(base))
+      tries.push(base.replace(/\.[cm]?js$/, ".ts"), base.replace(/\.[cm]?js$/, ".tsx"));
+    if (!/\.\w+$/.test(base))
+      tries.push(`${base}.tsx`, `${base}.ts`, `${base}/index.tsx`, `${base}/index.ts`);
+    const hit = tries.find(isFile);
+    if (hit && !isFile(base)) return { url: pathToFileURL(hit).href, shortCircuit: true };
+  }
+  return nextResolve(specifier, context);
+}
+
+export async function load(url, context, nextLoad) {
+  const path = url.startsWith("file:") ? fileURLToPath(url.split("?")[0]) : "";
+  if (path && TS.test(path) && !path.includes("/node_modules/")) {
+    const { code } = transformSync(readFileSync(path, "utf8"), {
+      loader: path.endsWith("x") ? "tsx" : "ts",
+      format: "esm",
+      target: "es2023",
+      jsx: "automatic",
+      jsxImportSource: "@codecut/core",
+      sourcefile: path,
+      sourcemap: "inline",
+    });
+    return { format: "module", source: code, shortCircuit: true };
+  }
+  return nextLoad(url, context);
+}

package/dist/jsx-dev-runtime.mjs

@@ -0,0 +1,13 @@
+import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
+import {
+  Fragment,
+  jsx,
+  jsxDEV,
+  jsxs
+} from "./chunks/chunk-IUSYVGP6.mjs";
+export {
+  Fragment,
+  jsx,
+  jsxDEV,
+  jsxs
+};

package/dist/jsx-runtime.mjs

@@ -0,0 +1,11 @@
+import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
+import {
+  Fragment,
+  jsx,
+  jsxs
+} from "./chunks/chunk-IUSYVGP6.mjs";
+export {
+  Fragment,
+  jsx,
+  jsxs
+};

package/docs/components/Adjustment.md

@@ -0,0 +1,74 @@
+# Adjustment
+
+*component, category: structure, **stub** (schema only, not rendered yet)*
+
+Adjustment layer: effects apply to everything below it. Typed stub: not implemented yet.
+
+Children: effects only.
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `id` | `string` |  | Stable unique id. Written back as cc_… when missing. |
+| `label` | `string` |  |  |
+| `start` | `Time` |  | Start relative to the parent Scene/Precomp. Use "@12s" for absolute time.; unit s |
+| `duration` | `Time` |  | Defaults to the rest of the parent.; unit s |
+| `end` | `Time` |  | Alternative to duration.; unit s |
+| `hidden` | `boolean` | `false` |  |
+| `link` | `string` |  | Link group id: linked clips move, trim and split together. |
+| `position` | `number | Vec2 | Vec3` | `[0,0,0]` | animatable; unit px; ui vec |
+| `rotation` | `number | Vec2 | Vec3` | `[0,0,0]` | animatable; unit deg; ui vec |
+| `scale` | `number | Vec2 | Vec3` | `[1,1,1]` | animatable; step 0.01; ui vec |
+| `skew` | `number | Vec2` | `[0,0]` | animatable; unit deg; ui vec |
+| `anchor` | `number | Vec2 | Vec3` | `[50,50,0]` | Transform origin as % of the layer box (z in px).; animatable; unit %; ui vec |
+| `opacity` | `number` | `1` | animatable; range 0..1; step 0.01; ui slider |
+| `crop` | `{ top?: Animatable<Length>; right?: Animatable<Length>; bottom?: Animatable<Length>; left?: Animatable<Length> }` |  |  |
+| `flip` | `none` \| `x` \| `y` \| `xy` | `"none"` |  |
+| `blend` | `normal` \| `multiply` \| `screen` \| `overlay` \| `darken` \| `lighten` \| `color-dodge` \| `color-burn` \| `soft-light` \| `hard-light` \| `difference` \| `exclusion` \| `hue` \| `saturation` \| `color` \| `luminosity` \| `add` | `"normal"` | ui dropdown |
+| `perspective` | `number` | `0` | animatable; range 0..∞; unit px |
+| `z` | `number` | `0` | Stacking override among siblings.; step 1 |
+| `enter` | `{ from?: "n" | "ne" | "e" | "se" | "s" | "sw" | "w" | "nw" | "center" | "z+" | "z-"; to?: "n" | "ne" | "e" | "se" | "s" | "sw" | "w" | "nw" | "center" | "z+" | "z-"; distance?: Length; ease?: Ease; duration?: Time; delay?: Time; fade?: boolean; blur?: number; scale?: number; rotate?: Angle }` |  | Entrance motion at the start of the layer. |
+| `exit` | `{ from?: "n" | "ne" | "e" | "se" | "s" | "sw" | "w" | "nw" | "center" | "z+" | "z-"; to?: "n" | "ne" | "e" | "se" | "s" | "sw" | "w" | "nw" | "center" | "z+" | "z-"; distance?: Length; ease?: Ease; duration?: Time; delay?: Time; fade?: boolean; blur?: number; scale?: number; rotate?: Angle }` |  | Exit motion ending at the end of the layer. |
+
+```ts
+export interface AdjustmentProps {
+  /** Stable unique id. Written back as cc_… when missing. */
+  id?: string;
+  label?: string;
+  /** Start relative to the parent Scene/Precomp. Use "@12s" for absolute time.; unit s */
+  start?: Time;
+  /** Defaults to the rest of the parent.; unit s */
+  duration?: Time;
+  /** Alternative to duration.; unit s */
+  end?: Time;
+  /** default false */
+  hidden?: boolean;
+  /** Link group id: linked clips move, trim and split together. */
+  link?: string;
+  /** unit px; default [0,0,0] */
+  position?: Animatable<number | Vec2 | Vec3>;
+  /** unit deg; default [0,0,0] */
+  rotation?: Animatable<number | Vec2 | Vec3>;
+  /** default [1,1,1] */
+  scale?: Animatable<number | Vec2 | Vec3>;
+  /** unit deg; default [0,0] */
+  skew?: Animatable<number | Vec2>;
+  /** Transform origin as % of the layer box (z in px).; unit %; default [50,50,0] */
+  anchor?: Animatable<number | Vec2 | Vec3>;
+  /** range 0..1; default 1 */
+  opacity?: Animatable<number>;
+  crop?: { top?: Animatable<Length>; right?: Animatable<Length>; bottom?: Animatable<Length>; left?: Animatable<Length> };
+  /** default "none" */
+  flip?: "none" | "x" | "y" | "xy";
+  /** default "normal" */
+  blend?: "normal" | "multiply" | "screen" | "overlay" | "darken" | "lighten" | "color-dodge" | "color-burn" | "soft-light" | "hard-light" | "difference" | "exclusion" | "hue" | "saturation" | "color" | "luminosity" | "add";
+  /** range 0..∞; unit px; default 0 */
+  perspective?: Animatable<number>;
+  /** Stacking override among siblings.; default 0 */
+  z?: number;
+  /** Entrance motion at the start of the layer. */
+  enter?: { from?: "n" | "ne" | "e" | "se" | "s" | "sw" | "w" | "nw" | "center" | "z+" | "z-"; to?: "n" | "ne" | "e" | "se" | "s" | "sw" | "w" | "nw" | "center" | "z+" | "z-"; distance?: Length; ease?: Ease; duration?: Time; delay?: Time; fade?: boolean; blur?: number; scale?: number; rotate?: Angle };
+  /** Exit motion ending at the end of the layer. */
+  exit?: { from?: "n" | "ne" | "e" | "se" | "s" | "sw" | "w" | "nw" | "center" | "z+" | "z-"; to?: "n" | "ne" | "e" | "se" | "s" | "sw" | "w" | "nw" | "center" | "z+" | "z-"; distance?: Length; ease?: Ease; duration?: Time; delay?: Time; fade?: boolean; blur?: number; scale?: number; rotate?: Angle };
+  children?: unknown;
+}
+```

package/docs/components/Animate.md

@@ -0,0 +1,45 @@
+# Animate
+
+*effect, category: motion*
+
+Animates one transform property of the parent from `from` to `to`. Position, rotation and skew are added to the layer's own values; scale and opacity multiply them.
+
+Children: none.
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `id` | `string` |  |  |
+| `start` | `Time` |  | Start relative to the parent layer.; unit s |
+| `duration` | `Time` |  | unit s |
+| `enabled` | `boolean` | `true` |  |
+| `prop` | `x` \| `y` \| `z` \| `rotation` \| `rotationX` \| `rotationY` \| `scale` \| `scaleX` \| `scaleY` \| `skewX` \| `skewY` \| `opacity` \| `blur` | `"opacity"` |  |
+| `from` | `number` | `0` |  |
+| `to` | `number` | `1` |  |
+| `ease` | `string` | `"expo.out"` |  |
+| `delay` | `Time` | `0` | unit s |
+| `hold` | `boolean` | `true` | Stay at `to` afterwards (otherwise return to `from`). |
+
+```ts
+export interface AnimateProps {
+  id?: string;
+  /** Start relative to the parent layer.; unit s */
+  start?: Time;
+  /** unit s */
+  duration?: Time;
+  /** default true */
+  enabled?: boolean;
+  /** default "opacity" */
+  prop?: "x" | "y" | "z" | "rotation" | "rotationX" | "rotationY" | "scale" | "scaleX" | "scaleY" | "skewX" | "skewY" | "opacity" | "blur";
+  /** default 0 */
+  from?: number;
+  /** default 1 */
+  to?: number;
+  /** default "expo.out" */
+  ease?: string;
+  /** unit s; default 0 */
+  delay?: Time;
+  /** Stay at `to` afterwards (otherwise return to `from`).; default true */
+  hold?: boolean;
+  children?: unknown;
+}
+```

package/docs/components/Audio.md

@@ -0,0 +1,56 @@
+# Audio
+
+*component, category: media*
+
+Background audio (music or ambience) on a bus. Mixed offline with FFmpeg; music ducks under voice.
+
+Children: none.
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `id` | `string` |  | Stable unique id. Written back as cc_… when missing. |
+| `label` | `string` |  |  |
+| `start` | `Time` |  | Start relative to the parent Scene/Precomp. Use "@12s" for absolute time.; unit s |
+| `duration` | `Time` |  | Defaults to the rest of the parent.; unit s |
+| `end` | `Time` |  | Alternative to duration.; unit s |
+| `hidden` | `boolean` | `false` |  |
+| `link` | `string` |  | Link group id: linked clips move, trim and split together. |
+| `src` | `string` |  |  |
+| `in` | `Time` | `0` | unit s |
+| `gain` | `number` | `0` | range -60..12; unit dB |
+| `bus` | `music` \| `sfx` \| `voice` | `"music"` |  |
+| `fadeIn` | `number` | `0` | range 0..∞; unit s |
+| `fadeOut` | `number` | `0` | range 0..∞; unit s |
+| `speed` | `number` | `1` | range 0.1..10 |
+
+```ts
+export interface AudioProps {
+  /** Stable unique id. Written back as cc_… when missing. */
+  id?: string;
+  label?: string;
+  /** Start relative to the parent Scene/Precomp. Use "@12s" for absolute time.; unit s */
+  start?: Time;
+  /** Defaults to the rest of the parent.; unit s */
+  duration?: Time;
+  /** Alternative to duration.; unit s */
+  end?: Time;
+  /** default false */
+  hidden?: boolean;
+  /** Link group id: linked clips move, trim and split together. */
+  link?: string;
+  src?: string;
+  /** unit s; default 0 */
+  in?: Time;
+  /** range -60..12; unit dB; default 0 */
+  gain?: number;
+  /** default "music" */
+  bus?: "music" | "sfx" | "voice";
+  /** range 0..∞; unit s; default 0 */
+  fadeIn?: number;
+  /** range 0..∞; unit s; default 0 */
+  fadeOut?: number;
+  /** range 0.1..10; default 1 */
+  speed?: number;
+  children?: unknown;
+}
+```

package/docs/components/B.md

@@ -0,0 +1,22 @@
+# B
+
+*component, category: text*
+
+Bold run inside Text.
+
+Children: any layers and effects.
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `weight` | `number` | `700` | range 1..1000 |
+| `id` | `string` |  | Stable unique id. Written back as cc_… when missing. |
+
+```ts
+export interface BProps {
+  /** range 1..1000; default 700 */
+  weight?: number;
+  /** Stable unique id. Written back as cc_… when missing. */
+  id?: string;
+  children?: unknown;
+}
+```

package/docs/components/Blur.md

@@ -0,0 +1,30 @@
+# Blur
+
+*effect, category: layer-styles*
+
+Gaussian blur of the layer.
+
+Children: none.
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `id` | `string` |  |  |
+| `start` | `Time` |  | Start relative to the parent layer.; unit s |
+| `duration` | `Time` |  | unit s |
+| `enabled` | `boolean` | `true` |  |
+| `radius` | `number` | `8` | animatable; range 0..200; unit px |
+
+```ts
+export interface BlurProps {
+  id?: string;
+  /** Start relative to the parent layer.; unit s */
+  start?: Time;
+  /** unit s */
+  duration?: Time;
+  /** default true */
+  enabled?: boolean;
+  /** range 0..200; unit px; default 8 */
+  radius?: Animatable<number>;
+  children?: unknown;
+}
+```