@aelionsdk/project-schema 0.1.0-beta.1 → 1.1.0-rc.1

package/README.md

@@ -1,7 +1,29 @@
-# @aelionsdk/project-schema
+# `@aelionsdk/project-schema`
 
-Project v1 types, validation and canonical serialization for AelionSDK
+Project v1 types, bounded admission, validation and canonical serialization for
+AelionSDK.
 
-Install with `npm install @aelionsdk/project-schema@next`.
+## Install
 
-Version 0.1.0-beta.1 is a prerelease and its API may change before the first stable release. This package is part of [AelionSDK](https://github.com/FoyonaCZY/AelionSDK); see the repository README for supported browsers, examples and deployment requirements.
+```bash
+npm install @aelionsdk/project-schema@next
+```
+
+`next` currently resolves to `1.1.0-rc.1`. Use this package in importers,
+services and Project tooling that must validate data without creating a browser
+Session.
+
+## Public surface
+
+- Project v1 TypeScript types;
+- bounded plain-JSON admission;
+- `ProjectValidator` and stable diagnostics;
+- canonical clone and serialization helpers.
+
+Treat every file or network Project as untrusted input. Run admission before
+schema and semantic validation; never invoke accessors or iterators on
+untrusted values.
+
+See the [Project Schema reference](https://foyonaczy.github.io/AelionSDK/reference/project-schema/)
+and [API reference](https://foyonaczy.github.io/AelionSDK/api/aelionsdk/project-schema/overview/).
+Licensed under MIT.

package/dist/image-sequence.d.ts

@@ -0,0 +1,13 @@
+import type { ImageSequenceReference } from './types.js';
+/**
+ * Map an item time to the image-sequence frame whose interval contains it.
+ *
+ * Frames are uniform-duration and contiguous starting at zero. The mapping is
+ * deterministic and integer-based so preview and export agree on every frame
+ * boundary. Returns `undefined` when `itemTimeUs` is negative or at/after the
+ * last frame boundary, which callers must treat as fail-closed.
+ */
+export declare function imageSequenceFrameIndex(sequence: ImageSequenceReference, itemTimeUs: number): number | undefined;
+/** Total duration of the sequence in microseconds. */
+export declare function imageSequenceDurationUs(sequence: ImageSequenceReference): number;
+//# sourceMappingURL=image-sequence.d.ts.map

package/dist/image-sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-sequence.d.ts","sourceRoot":"","sources":["../src/image-sequence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,sBAAsB,EAChC,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAOpB;AAED,sDAAsD;AACtD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAEhF"}

package/dist/image-sequence.js

@@ -0,0 +1,23 @@
+/**
+ * Map an item time to the image-sequence frame whose interval contains it.
+ *
+ * Frames are uniform-duration and contiguous starting at zero. The mapping is
+ * deterministic and integer-based so preview and export agree on every frame
+ * boundary. Returns `undefined` when `itemTimeUs` is negative or at/after the
+ * last frame boundary, which callers must treat as fail-closed.
+ */
+export function imageSequenceFrameIndex(sequence, itemTimeUs) {
+    if (!Number.isSafeInteger(itemTimeUs) || itemTimeUs < 0)
+        return undefined;
+    const frameDurationUs = sequence.frameDurationUs;
+    if (!Number.isSafeInteger(frameDurationUs) || frameDurationUs <= 0)
+        return undefined;
+    const index = Math.floor(itemTimeUs / frameDurationUs);
+    if (index < 0 || index >= sequence.frameAssetIds.length)
+        return undefined;
+    return index;
+}
+/** Total duration of the sequence in microseconds. */
+export function imageSequenceDurationUs(sequence) {
+    return sequence.frameDurationUs * sequence.frameAssetIds.length;
+}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './admission.js';
 export * from './canonical.js';
+export * from './image-sequence.js';
 export * from './types.js';
 export * from './validate.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './admission.js';
 export * from './canonical.js';
+export * from './image-sequence.js';
 export * from './types.js';
 export * from './validate.js';

package/dist/types.d.ts

@@ -14,10 +14,49 @@ export interface ProjectSettings extends JsonObject {
     locale?: string;
     timezone?: string;
 }
+/**
+ * Frame manifest of an `image-sequence` asset. Frames are uniform-duration
+ * stills; each `frameAssetIds` entry references an `image` Asset in the same
+ * Project. Sampling a sequence at an item time maps to the frame whose
+ * interval contains that time (see {@link imageSequenceFrameIndex}).
+ */
+export interface ImageSequenceReference extends JsonObject {
+    /** Duration of every frame in microseconds. */
+    readonly frameDurationUs: number;
+    /** Ordered image Asset ids, one per frame, referencing `image` kind Assets. */
+    readonly frameAssetIds: EntityId[];
+}
 export interface ProjectEntity extends JsonObject {
     id: EntityId;
 }
+export interface SequenceColorFormat extends JsonObject {
+    width: number;
+    height: number;
+    pixelAspectRatio: Rational & JsonObject;
+    frameRate: Rational & JsonObject;
+    sampleRate: 44_100 | 48_000 | 96_000;
+    channelLayout: 'mono' | 'stereo' | '5.1';
+    workingColorSpace: 'srgb-linear' | 'display-p3-linear' | 'rec2020-linear';
+    /** Defaults to `bt709` for legacy Project v1 documents. */
+    colorPrimaries?: 'bt709' | 'display-p3' | 'bt2020';
+    /** Defaults to `srgb` for legacy Project v1 documents. */
+    transferFunction?: 'srgb' | 'gamma22' | 'pq' | 'hlg';
+    /** Defaults to `rgb` for the linear compositing surface. */
+    matrixCoefficients?: 'rgb' | 'bt709' | 'bt2020-ncl';
+    /** Defaults to `full` for the linear compositing surface. */
+    colorRange?: 'full' | 'limited';
+    /** Defaults to `4:4:4`; an encoder may require an explicit conversion to `4:2:0`. */
+    chromaSubsampling?: 'rgb' | '4:4:4' | '4:2:2' | '4:2:0';
+    /** Defaults to `premultiplied` inside the renderer. */
+    alphaMode?: 'opaque' | 'premultiplied';
+    /** Defaults to `none`; HDR must fail closed when it cannot be presented without conversion. */
+    toneMapping?: 'none' | 'bt2390' | 'reinhard';
+    /** Defaults to 8 for legacy Project v1 documents. */
+    bitDepth?: 8 | 10;
+    backgroundColor: JsonObject;
+}
 export interface SequenceEntity extends ProjectEntity {
+    format: SequenceColorFormat & JsonObject;
     trackIds: EntityId[];
     transitionIds: EntityId[];
     materialInstanceIds: EntityId[];

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAc,UAAU,EAAa,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGjF,OAAO,EAAoB,KAAK,aAAa,EAAuB,MAAM,YAAY,CAAC;AAmCvF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,sBAAsB,EAAE,UAAU,CAAC;CAC7C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAsrBD,qBAAa,gBAAgB;;gBAGR,OAAO,EAAE,uBAAuB;IAY5C,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,wBAAwB,CAAC;CA+ClE"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAc,UAAU,EAAa,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGjF,OAAO,EAAoB,KAAK,aAAa,EAAuB,MAAM,YAAY,CAAC;AAmCvF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,sBAAsB,EAAE,UAAU,CAAC;CAC7C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAkwBD,qBAAa,gBAAgB;;gBAGR,OAAO,EAAE,uBAAuB;IAY5C,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,wBAAwB,CAAC;CAgDlE"}

package/dist/validate.js

@@ -352,11 +352,43 @@ function validateAudioSemantics(project, diagnostics) {
 function validateColorSemantics(project, diagnostics) {
     for (const sequence of Object.values(project.sequences)) {
         const format = sequence.format;
-        if (format.transferFunction !== 'pq' && format.transferFunction !== 'hlg')
-            continue;
-        if (format.workingColorSpace !== 'rec2020-linear' || format.bitDepth !== 10) {
+        const expectedPrimaries = format.workingColorSpace === 'display-p3-linear'
+            ? 'display-p3'
+            : format.workingColorSpace === 'rec2020-linear'
+                ? 'bt2020'
+                : 'bt709';
+        if (format.colorPrimaries !== undefined && format.colorPrimaries !== expectedPrimaries) {
+            diagnostics.push(semanticDiagnostic('PROJECT_COLOR_PRIMARIES_MISMATCH', `Sequence ${sequence.id} color primaries do not match its linear working space`, ['sequences', sequence.id, 'format', 'colorPrimaries'], sequence.id));
+        }
+        const hdr = format.transferFunction === 'pq' || format.transferFunction === 'hlg';
+        if (hdr && (format.workingColorSpace !== 'rec2020-linear' || format.bitDepth !== 10)) {
             diagnostics.push(semanticDiagnostic('PROJECT_HDR_FORMAT_INVALID', `HDR Sequence ${sequence.id} requires rec2020-linear working space and 10-bit output`, ['sequences', sequence.id, 'format'], sequence.id));
         }
+        if (format.toneMapping !== undefined && format.toneMapping !== 'none' && !hdr) {
+            diagnostics.push(semanticDiagnostic('PROJECT_TONE_MAPPING_INPUT_INVALID', `Sequence ${sequence.id} tone mapping requires PQ or HLG input`, ['sequences', sequence.id, 'format', 'toneMapping'], sequence.id));
+        }
+        if (format.chromaSubsampling === 'rgb' && format.matrixCoefficients !== 'rgb') {
+            diagnostics.push(semanticDiagnostic('PROJECT_RGB_MATRIX_INVALID', `Sequence ${sequence.id} RGB chroma requires RGB matrix coefficients`, ['sequences', sequence.id, 'format', 'matrixCoefficients'], sequence.id));
+        }
+    }
+}
+function validateImageSequenceReferences(project, diagnostics) {
+    for (const asset of Object.values(project.assets)) {
+        if (asset.kind !== 'image-sequence')
+            continue;
+        const sequence = asset.imageSequence;
+        const frameAssetIds = sequence?.frameAssetIds;
+        if (frameAssetIds === undefined)
+            continue;
+        frameAssetIds.forEach((frameAssetId, index) => {
+            const frameAsset = project.assets[frameAssetId];
+            if (frameAsset === undefined) {
+                diagnostics.push(semanticDiagnostic('PROJECT_IMAGE_SEQUENCE_FRAME_MISSING', `Image sequence ${asset.id} references missing frame Asset ${frameAssetId}`, ['assets', asset.id, 'imageSequence', 'frameAssetIds', index], asset.id));
+            }
+            else if (frameAsset.kind !== 'image') {
+                diagnostics.push(semanticDiagnostic('PROJECT_IMAGE_SEQUENCE_FRAME_KIND_INVALID', `Frame Asset ${frameAssetId} of image sequence ${asset.id} must be an image Asset`, ['assets', asset.id, 'imageSequence', 'frameAssetIds', index], asset.id));
+            }
+        });
     }
 }
 export class ProjectValidator {
@@ -410,6 +442,7 @@ export class ProjectValidator {
         validateTimeMappingSemantics(project, diagnostics);
         validateAudioSemantics(project, diagnostics);
         validateColorSemantics(project, diagnostics);
+        validateImageSequenceReferences(project, diagnostics);
         return diagnostics.diagnostics.length === 0 ? ok({ project }) : err(...diagnostics.diagnostics);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aelionsdk/project-schema",
-  "version": "0.1.0-beta.1",
+  "version": "1.1.0-rc.1",
   "description": "Project v1 types, validation and canonical serialization for AelionSDK",
   "license": "MIT",
   "repository": {
@@ -27,15 +27,15 @@
     "!dist/.tsbuildinfo"
   ],
   "engines": {
-    "node": ">=20.19"
+    "node": ">=24 <25"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "@aelionsdk/core": "0.1.0-beta.1",
-    "ajv": "8.17.1",
+    "@aelionsdk/core": "1.1.0-rc.1",
+    "ajv": "8.18.0",
     "ajv-formats": "3.0.1"
   },
   "scripts": {