@dantea/opencut 0.1.0 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/dist/commands.d.ts +1 -0
  2. package/dist/commands.js +3 -1
  3. package/dist/system-probe +0 -0
  4. package/dist/video.js +7 -0
  5. package/docs/CLI.md +40 -6
  6. package/docs/INSTALL.md +13 -8
  7. package/docs/SDK.md +10 -3
  8. package/docs/VIDEO_DEFINITIONS.md +13 -8
  9. package/node_modules/@opencut/core/dist/render-plan.d.ts +1 -0
  10. package/node_modules/@opencut/core/dist/render-plan.js +5 -4
  11. package/node_modules/@opencut/core/dist/render-sources.d.ts +1 -0
  12. package/node_modules/@opencut/core/dist/video-build.js +2 -2
  13. package/node_modules/@opencut/core/dist/video-media-cache.d.ts +15 -0
  14. package/node_modules/@opencut/core/dist/{video-recipe-cache.js → video-media-cache.js} +7 -7
  15. package/node_modules/@opencut/core/dist/video-picture-cache.d.ts +3 -0
  16. package/node_modules/@opencut/core/dist/video-picture-cache.js +29 -0
  17. package/node_modules/@opencut/core/dist/video-processing.js +2 -2
  18. package/node_modules/@opencut/core/dist/video-render.d.ts +4 -1
  19. package/node_modules/@opencut/core/dist/video-render.js +6 -1
  20. package/node_modules/@opencut/core/package.json +3 -3
  21. package/node_modules/@opencut/media/dist/enhance.js +11 -3
  22. package/node_modules/@opencut/media/dist/index.d.ts +1 -0
  23. package/node_modules/@opencut/media/dist/picture-cache.d.ts +39 -0
  24. package/node_modules/@opencut/media/dist/picture-cache.js +169 -0
  25. package/node_modules/@opencut/media/dist/picture-seek.d.ts +4 -0
  26. package/node_modules/@opencut/media/dist/picture-seek.js +77 -0
  27. package/node_modules/@opencut/media/dist/process-memory +0 -0
  28. package/node_modules/@opencut/media/dist/render.d.ts +5 -1
  29. package/node_modules/@opencut/media/dist/render.js +195 -109
  30. package/node_modules/@opencut/media/dist/transform-layer.d.ts +7 -1
  31. package/node_modules/@opencut/media/dist/transform-layer.js +32 -2
  32. package/node_modules/@opencut/media/dist/video-enhance +0 -0
  33. package/node_modules/@opencut/media/dist/video-filter.d.ts +2 -0
  34. package/node_modules/@opencut/media/dist/video-filter.js +4 -0
  35. package/node_modules/@opencut/media/dist/video-interpolate +0 -0
  36. package/node_modules/@opencut/media/package.json +2 -2
  37. package/node_modules/@opencut/sdk/package.json +3 -3
  38. package/node_modules/@opencut/shared/package.json +1 -1
  39. package/package.json +5 -5
  40. package/skills/video-editor/SKILL.md +7 -1
  41. package/skills/video-editor/references/cli.md +7 -0
  42. package/skills/video-editor/references/sdk.md +5 -0
  43. package/skills/video-editor/references/video-definitions.md +7 -3
  44. package/node_modules/@opencut/core/dist/video-recipe-cache.d.ts +0 -16
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@opencut/sdk",
3
- "version": "0.1.0",
3
+ "version": "0.1.3",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -9,8 +9,8 @@
9
9
  }
10
10
  },
11
11
  "dependencies": {
12
- "@opencut/core": "0.1.0",
13
- "@opencut/media": "0.1.0"
12
+ "@opencut/core": "0.1.3",
13
+ "@opencut/media": "0.1.3"
14
14
  },
15
15
  "license": "MIT"
16
16
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@opencut/shared",
3
- "version": "0.1.0",
3
+ "version": "0.1.3",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dantea/opencut",
3
- "version": "0.1.0",
3
+ "version": "0.1.3",
4
4
  "description": "OpenCut video-as-code CLI and TypeScript SDK for Apple Silicon",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -39,10 +39,10 @@
39
39
  "@img/sharp-libvips-darwin-arm64": "1.3.4",
40
40
  "@napi-rs/canvas": "1.1.0",
41
41
  "@napi-rs/canvas-darwin-arm64": "1.1.0",
42
- "@opencut/core": "0.1.0",
43
- "@opencut/media": "0.1.0",
44
- "@opencut/sdk": "0.1.0",
45
- "@opencut/shared": "0.1.0",
42
+ "@opencut/core": "0.1.3",
43
+ "@opencut/media": "0.1.3",
44
+ "@opencut/sdk": "0.1.3",
45
+ "@opencut/shared": "0.1.3",
46
46
  "detect-libc": "2.1.2",
47
47
  "lru-cache": "11.5.3",
48
48
  "semver": "7.8.5",
@@ -22,6 +22,8 @@ discover commands and `opencut render --help` for export controls.
22
22
  transcoding. Use `interpolateFrames` to preserve duration at a higher
23
23
  frame rate or `smoothSlowMotion` to extend picture duration and mute it.
24
24
  Use `superResolution` for AI upscaling and `denoise` on supported hardware.
25
+ Preserve authored quality; never silently downsize a source or substitute a
26
+ lighter model to satisfy an unsupported processor.
25
27
  Check [AI recipe support and scene boundaries](references/video-definitions.md#media-recipes).
26
28
  2. Set canvas size, frame rate, ordered tracks, and clip ranges. Use integer
27
29
  frame positions or exact rationals as documented. Add subtitles, effects,
@@ -34,7 +36,11 @@ discover commands and `opencut render --help` for export controls.
34
36
  contact sheet from `opencut preview --help`. Preview defaults to `fast`.
35
37
  Use `--quality quality` to review offline AI processing, such as 4×
36
38
  super-resolution. A failed watch rebuild leaves the last valid preview
37
- available.
39
+ available. Desktop review keeps the playhead at the same timeline time
40
+ across rebuilds, including frame-rate changes, and clamps it to the last
41
+ frame if the revision ends earlier. Select a clip, subtitle, or transition
42
+ to pause on the first frame at or after its start. A selection made during
43
+ loading takes effect when the preview is ready.
38
44
  5. Deliver a new MP4 with `opencut render DEFINITION --output final.mp4`.
39
45
  The CLI defaults to `quality` and runs directly. Use `--quality maximum`
40
46
  for slower MP4 encoding with the same AI algorithms as `quality`.
@@ -24,6 +24,13 @@ automatically processes referenced recipes and reuses completed steps. The
24
24
  `--recipe-cache` to choose a cache and `--recipe-workers` and the other
25
25
  [recipe flags](../../../docs/CLI.md#media-recipes) to set processing limits.
26
26
 
27
+ For revisions, pass the same `--picture-cache <directory>` on the initial
28
+ export and each subsequent `render`. OpenCut can reuse lossless picture
29
+ ranges after a timeline shift, including ranges with captions that shift
30
+ together with picture. Audio is mixed on the revised timeline. Read
31
+ `pictureRanges` in JSON for the status of each half-open project-frame range.
32
+ See [picture cache options](../../../docs/CLI.md#reuse-picture-between-exports).
33
+
27
34
  On macOS, `opencut system inspect --json` reports the VideoToolbox processor
28
35
  and tested formats and dimensions. Recipe inspection checks declarations
29
36
  and input streams. Use normal `validate` with the same recipe limits as
@@ -10,6 +10,11 @@ Use `renderVideo` to compile and render in one call. If `renderCompiledVideo`
10
10
  reports that source media changed, recompile before retrying.
11
11
  See the repository's [SDK guide](../../../docs/SDK.md) for the public API.
12
12
 
13
+ For picture reuse, pass the same `pictureCacheDirectory` to `renderVideo`
14
+ or `renderCompiledVideo` on the initial export and revisions. Read
15
+ `pictureRanges` for the status of each range in project frames.
16
+ See [picture cache behavior](../../../docs/CLI.md#reuse-picture-between-exports).
17
+
13
18
  Use `inspectVideoRecipes(file)` for recipe validation and inspection without
14
19
  transcoding. `compileVideo`, `renderVideo`, and `watchVideo` accept `processing`
15
20
  options for the cache, worker limits, and step progress.
@@ -145,14 +145,18 @@ enhancement to select a range on the source container's clock. A later
145
145
  `trim` uses the derived clock, where the first retained stream starts at
146
146
  zero and the relative audio delay is preserved. `fast` uses a size-dependent
147
147
  1.5× or 2× model.
148
- `quality` and `maximum` use Apple's temporal 4× model and resize to the target.
148
+ `quality` and `maximum` compute the temporal model's full 4× output before
149
+ resizing to the target. The model's input limit applies after earlier recipe
150
+ steps. OpenCut reports unsupported dimensions.
149
151
  For `denoise`, set `strength` to `light`, `medium`, or `strong` and check temporal
150
152
  noise-filter support before use. AI enhancement accepts constant-rate,
151
153
  progressive, square-pixel, 8-bit video-range SDR input. If the color matrix
152
154
  tag is missing, OpenCut resolves it from the input dimensions and codec
153
155
  before enhancement. Recipe order determines whether enhancement runs
154
- before or after interpolation. Compare
155
- the processed sequence with a Lanczos resize when judging detail and
156
+ before or after interpolation. Enhancing before doubling the frame rate halves
157
+ the number of enhanced frames, but requires interpolation support at the larger
158
+ size. Interpolating first keeps interpolation smaller and doubles enhancement
159
+ work. Compare the processed sequence with a Lanczos resize when judging detail and
156
160
  temporal consistency. See the [enhancement reference](../../../docs/VIDEO_DEFINITIONS.md#ai-enhancement).
157
161
 
158
162
  ## Parameterized composition
@@ -1,16 +0,0 @@
1
- import type { MediaMetadata } from '@opencut/media';
2
- import type { IdentifiedMedia } from './video-input.js';
3
- import type { RecipeFormat } from './video-recipe-schema.js';
4
- type RecipeEntry = IdentifiedMedia & {
5
- sha256: string;
6
- };
7
- export declare function materializeRecipeEntry(directory: string, key: string, format: RecipeFormat, signal: AbortSignal, encode: (output: string) => Promise<MediaMetadata>): Promise<{
8
- entry: RecipeEntry;
9
- reused: boolean;
10
- }>;
11
- /** Find validated media without publishing or removing anything. */
12
- export declare function findRecipeEntry(directory: string, key: string, format: RecipeFormat, signal?: AbortSignal): Promise<{
13
- directory: string;
14
- entry: RecipeEntry;
15
- } | undefined>;
16
- export {};