screenci 0.0.75 → 0.0.78

package/dist/src/stillCapture.js.map

@@ -1 +1 @@
-{"version":3,"file":"stillCapture.js","sourceRoot":"","sources":["../../src/stillCapture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,eAAe,CAAA;AAGtB,8EAA8E;AAC9E,MAAM,oBAAoB,GAAG,gBAAgB,CAAA;AAuB7C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAwB,EACxB,IAAwB,EACxB,IAAiB;IAEjB,IAAI,IAAI,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,SAAS,CAAA;IACpC,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnD,IAAI;YACF,IAAI;iBACD,KAAK,CAAC,OAAO,CAAC;iBACd,GAAG,EAAE;gBACN,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,SAAS,CAAA;IAC5C,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,GAAG,YAAY,CAAA;IACrB,CAAC;IAED,IAAI,SAAS,GAAG,IAAI,CAAA;IACpB,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAA;QAC1B,CAAC,EAAE,CAAA;IACL,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACnB,OAAO,SAAS,CAAA;AAClB,CAAC;AAgBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAWzC;IACC,MAAM,EACJ,IAAI,EACJ,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,IAAI,EACJ,YAAY,EACZ,SAAS,EACT,aAAa,EACb,aAAa,EACb,IAAI,GACL,GAAG,MAAM,CAAA;IAEV,MAAM,EAAE,GACN,IAAI,CAAC,EAAE,EAAE,EAAE;QACX,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAClE,MAAM,KAAK,GACT,IAAI,CAAC,EAAE,EAAE,KAAK;QACd,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;IAC9E,MAAM,YAAY,GAChB,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAA;IAEhE,+EAA+E;IAC/E,iEAAiE;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAA;IAEhE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAA;IACb,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAEhB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAA;IAElE,MAAM,UAAU,GAAmB;QACjC,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,iBAAiB,CAAC;QACvD,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,iBAAiB,CAAC;QACzD,iBAAiB;KAClB,CAAA;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,aAAa,EAAE,aAAa,CAAC,CAAA;IAC3D,QAAQ,CAAC,KAAK,EAAE,CAAA;IAChB,8EAA8E;IAC9E,oDAAoD;IACpD,MAAM,QAAQ,CAAC,WAAW,CACxB,GAAG,EACH,IAAI,EACJ,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,EACrE,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAC1E,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAU;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IAEnC,MAAM,OAAO,GAAG,KAAK,EACnB,OAAkC,EACjB,EAAE;QACnB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,iBAAiB,EAAE,GAAG,OAAO,IAAI,EAAE,CAAA;QAEtE,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,EAAE,CAAC;YAC9C,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAA;QACpC,CAAC;QAED,MAAM,GAAG,GAAG,yBAAyB,EAAE,CAAA;QACvC,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,IAAI,qBAAqB,CAAA;QAChE,MAAM,WAAW,GAAG,aAAa,CAAC,WAAW,IAAI,oBAAoB,CAAA;QACrE,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,eAAe,CAAA;QACxD,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;QAEtD,MAAM,YAAY,GAAG,gBAAgB,CACnC,IAAI,EACJ,OAAO,iBAAiB,CAAC,IAAI,KAAK,QAAQ;YACxC,CAAC,CAAC,iBAAiB,CAAC,IAAI;YACxB,CAAC,CAAC,SAAS,EACb,SAAS,CACV,CAAA;QAED,IAAI,IAAsC,CAAA;QAC1C,IAAI,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAClD,IAAI,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;QAChD,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;QAElE,OAAO,mBAAmB,CAAC;YACzB,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC;YAC7C,UAAU;YACV,2EAA2E;YAC3E,gEAAgE;YAChE,iBAAiB,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;YACnC,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,SAAS;YACT,aAAa;YACb,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,IAAI,EAAE;gBACJ,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAG,iBAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;aACxE;SACF,CAAC,CAAA;IACJ,CAAC,CAEA;IAAC,IAAkD,CAAC,UAAU,GAAG,OAAO,CAAA;IAEzE,OAAO,GAAG,EAAE;QACV,CAAC;QAAC,IAAmD,CAAC,UAAU,GAAG,QAAQ,CAAA;IAC7E,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"stillCapture.js","sourceRoot":"","sources":["../../src/stillCapture.ts"],"names":[],"mappings":"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"}

package/dist/src/studio.d.ts

@@ -1,66 +1,78 @@
+import type { ContentMajor, LanguageMajor } from './declare.js';
 /**
- * Studio mode — configure render/record options, narration, on-screen text,
- * overlays, and background audio from the ScreenCI web app instead of code.
- * Business tier only.
- *
- * Opt in with a single `video.studio({...})` (or `screenshot.studio({...})`)
- * declaration, chainable with `.localize()` / `.each()`:
- *
- * - `renderOptions: true` / `recordOptions: true` defer those option groups to
- *   Studio. `recordOptions` (aspect ratio, quality, fps) changes the capture, so
- *   it is fetched before recording; `renderOptions` is applied at render.
- * - `narration`, `text`, `overlays`, `audio` are name lists declaring the cues /
- *   fields / overlays / tracks whose content is owned by Studio. The matching
- *   `narration` / `text` / `overlays` / `audio` fixtures expose typed
- *   controllers/values for them.
- *
- * On the first upload of a studio-mode video, rendering is held until the video
- * is configured in Studio (the CLI prints a direct link); later uploads reuse
- * the saved configuration automatically.
- *
- * @example
- * ```ts
- * import { video } from 'screenci'
- *
- * video
- *   .studio({ renderOptions: true, narration: ['intro'], overlays: ['logo'] })
- *   .localize({ languages: ['en', 'fi'] })(
- *   'Product demo',
- *   async ({ page, narration, overlays }) => {
- *     await overlays.logo()
- *     await narration.intro()
- *   }
- * )
- * ```
+ * The studio axes deferred to the ScreenCI web app, read by the recorder to
+ * stamp `metadata.studio`. `renderOptions`/`recordOptions` come from the
+ * matching `'studio'` sentinel; `languages` is set when the recording's
+ * language set is web-owned (`video.languages(studio())`).
  */
-export type StudioDeclaration = {
-    /** Defer render options to Studio. Applied at render time. */
-    renderOptions?: boolean;
-    /**
-     * Defer record options (aspect ratio, quality, fps) to Studio. Fetched before
-     * recording, since they change the captured viewport/encode.
-     */
-    recordOptions?: boolean;
-    /** Studio-managed narration cue names (text and voice configured in Studio). */
-    narration?: readonly string[];
-    /** Studio-managed on-screen text field names (values configured in Studio). */
-    text?: readonly string[];
-    /** Studio-managed overlay names (file and placement configured in Studio). */
-    overlays?: readonly string[];
-    /** Studio-managed background-audio track names (file/volume configured in Studio). */
-    audio?: readonly string[];
-};
-/** The studio option groups deferred to render/record. */
 export type StudioOptionFlags = {
     renderOptions: boolean;
     recordOptions: boolean;
+    /** Whether the language set is owned by the web app (`video.languages(studio())`). */
+    languages?: boolean;
 };
-/** Returns the render/record deferral flags for a (possibly absent) declaration. */
-export declare function studioOptionFlags(declaration: StudioDeclaration | undefined): StudioOptionFlags;
+/** Brand marking a value produced by {@link studio}. */
+export declare const STUDIO: unique symbol;
 /**
- * Validates a studio declaration against the seeded localize names: each name
- * list is unique and non-empty, and Studio-managed narration/text names are
- * disjoint from the names seeded in `localize()`. Pure; throws on violation.
+ * A Studio-owned declaration produced by {@link studio}: the content (or, for
+ * `languages`, the set) is owned by the ScreenCI web app. `names` lists the
+ * declared keys (cue / overlay / audio names, or language codes); `seed`, when
+ * present, supplies initial values the web app starts from but may override.
+ *
+ * `S` carries the seed shape so the consuming feature method validates seed
+ * values against its own value type (e.g. narration seeds are checked as
+ * narration cues). A blank declaration (`studio([...])`) has `seed` undefined.
  */
-export declare function validateStudioDeclaration(declaration: StudioDeclaration | null, seededNarrationNames: readonly string[], seededTextNames: readonly string[]): void;
+export type StudioMarker<S = unknown> = {
+    readonly [STUDIO]: true;
+    readonly names: readonly string[];
+    readonly seed?: S;
+};
+/** A blank Studio declaration: names only, no seed. */
+export type StudioNames = StudioMarker<undefined> & {
+    readonly seed?: undefined;
+    /** Phantom guard: keeps the keyless form ({@link StudioPending}) out of feature args. */
+    readonly languagesOnly?: never;
+};
+/** A seeded Studio declaration: the web app starts from `seed` but may override it. */
+export type StudioSeeded<S> = StudioMarker<S> & {
+    readonly seed: S;
+    readonly languagesOnly?: never;
+};
+/**
+ * The keyless form, `studio()`: the web app owns the entire set. Only
+ * `video.languages(studio())` accepts it (a content feature has no keys to
+ * defer, so its keyless form is rejected by {@link FeatureArg}). The
+ * `languagesOnly` brand is what makes it unassignable to {@link StudioNames}.
+ */
+export type StudioPending = StudioMarker<undefined> & {
+    readonly names: readonly [];
+    readonly seed?: undefined;
+    readonly languagesOnly: true;
+};
+/** Whether a value was produced by {@link studio}. */
+export declare function isStudioMarker(value: unknown): value is StudioMarker;
+/**
+ * Declare something Studio-owned: its content is configured in the ScreenCI web
+ * app, and code only declares that it exists. Three forms:
+ *
+ * - `studio(['intro', 'cta'])`: blank names. The keys exist in code (so the test
+ *   body can reference `narration.intro`), but the web app owns their content.
+ * - `studio({ intro: 'Welcome' })`: seeded. The web app starts from these values
+ *   but owns them: once edited in Studio, the Studio value wins (a seed never
+ *   clobbers an existing Studio edit).
+ * - `studio()`: keyless. Only `video.languages(studio())` accepts it: the web app
+ *   owns the entire language set. Content features have keys to declare, so their
+ *   keyless form does not type-check.
+ *
+ * For `video.languages`, the names are language codes: `studio(['en', 'fi'])`
+ * seeds the initial set (web-owned, but starts with those languages).
+ */
+export declare function studio(): StudioPending;
+export declare function studio<const N extends readonly string[]>(names: N): StudioNames & {
+    readonly names: N;
+};
+export declare function studio<const S extends ContentMajor<unknown> | LanguageMajor<unknown>>(seed: S): StudioSeeded<S> & {
+    readonly names: readonly (keyof S & string)[];
+};
 //# sourceMappingURL=studio.d.ts.map

package/dist/src/studio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../src/studio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,sFAAsF;IACtF,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,OAAO,CAAA;IACtB,aAAa,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,iBAAiB,GAAG,SAAS,GACzC,iBAAiB,CAKnB;AAmCD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,iBAAiB,GAAG,IAAI,EACrC,oBAAoB,EAAE,SAAS,MAAM,EAAE,EACvC,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC,IAAI,CAcN"}
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../src/studio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,OAAO,CAAA;IACtB,aAAa,EAAE,OAAO,CAAA;IACtB,sFAAsF;IACtF,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,wDAAwD;AACxD,eAAO,MAAM,MAAM,EAAE,OAAO,MAAsC,CAAA;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI;IACtC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;CAClB,CAAA;AAED,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,yFAAyF;IACzF,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAA;CAC/B,CAAA;AAED,uFAAuF;AACvF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG;IAC9C,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAChB,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAA;CAC/B,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG;IACpD,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAA;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAA;CAC7B,CAAA;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAMpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,IAAI,aAAa,CAAA;AACvC,wBAAgB,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EACtD,KAAK,EAAE,CAAC,GACP,WAAW,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAA;AACtC,wBAAgB,MAAM,CACpB,KAAK,CAAC,CAAC,SAAS,YAAY,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,EAC9D,IAAI,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAA;CAAE,CAAA"}

package/dist/src/studio.js

@@ -1,42 +1,20 @@
-/** Returns the render/record deferral flags for a (possibly absent) declaration. */
-export function studioOptionFlags(declaration) {
+/** Brand marking a value produced by {@link studio}. */
+export const STUDIO = Symbol.for('screenci.studio');
+/** Whether a value was produced by {@link studio}. */
+export function isStudioMarker(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value[STUDIO] === true);
+}
+export function studio(arg) {
+    if (arg === undefined)
+        return { [STUDIO]: true, names: [] };
+    if (Array.isArray(arg))
+        return { [STUDIO]: true, names: [...arg] };
     return {
-        renderOptions: declaration?.renderOptions === true,
-        recordOptions: declaration?.recordOptions === true,
+        [STUDIO]: true,
+        names: Object.keys(arg),
+        seed: arg,
     };
 }
-function assertUniqueStudioNames(label, names) {
-    const seen = new Set();
-    for (const name of names) {
-        if (typeof name !== 'string' || name.length === 0) {
-            throw new Error(`video.studio(): ${label} names must be non-empty strings.`);
-        }
-        if (seen.has(name)) {
-            throw new Error(`video.studio(): duplicate ${label} name "${name}".`);
-        }
-        seen.add(name);
-    }
-}
-function assertDisjointFromSeeded(label, studioNames, seededNames) {
-    const seeded = new Set(seededNames);
-    const overlap = studioNames.filter((name) => seeded.has(name));
-    if (overlap.length === 0)
-        return;
-    throw new Error(`video.studio(): ${label} name(s) ${overlap.join(', ')} are both seeded in localize() and declared as Studio-managed. A name must be one or the other.`);
-}
-/**
- * Validates a studio declaration against the seeded localize names: each name
- * list is unique and non-empty, and Studio-managed narration/text names are
- * disjoint from the names seeded in `localize()`. Pure; throws on violation.
- */
-export function validateStudioDeclaration(declaration, seededNarrationNames, seededTextNames) {
-    if (declaration === null)
-        return;
-    assertUniqueStudioNames('narration', declaration.narration ?? []);
-    assertUniqueStudioNames('text', declaration.text ?? []);
-    assertUniqueStudioNames('overlays', declaration.overlays ?? []);
-    assertUniqueStudioNames('audio', declaration.audio ?? []);
-    assertDisjointFromSeeded('narration', declaration.narration ?? [], seededNarrationNames);
-    assertDisjointFromSeeded('text', declaration.text ?? [], seededTextNames);
-}
 //# sourceMappingURL=studio.js.map

package/dist/src/studio.js.map

@@ -1 +1 @@
-{"version":3,"file":"studio.js","sourceRoot":"","sources":["../../src/studio.ts"],"names":[],"mappings":"AA2DA,oFAAoF;AACpF,MAAM,UAAU,iBAAiB,CAC/B,WAA0C;IAE1C,OAAO;QACL,aAAa,EAAE,WAAW,EAAE,aAAa,KAAK,IAAI;QAClD,aAAa,EAAE,WAAW,EAAE,aAAa,KAAK,IAAI;KACnD,CAAA;AACH,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAa,EACb,KAAwB;IAExB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,mBAAmB,KAAK,mCAAmC,CAC5D,CAAA;QACH,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,UAAU,IAAI,IAAI,CAAC,CAAA;QACvE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAChB,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAAa,EACb,WAA8B,EAC9B,WAA8B;IAE9B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAA;IACnC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAChC,MAAM,IAAI,KAAK,CACb,mBAAmB,KAAK,YAAY,OAAO,CAAC,IAAI,CAC9C,IAAI,CACL,iGAAiG,CACnG,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,WAAqC,EACrC,oBAAuC,EACvC,eAAkC;IAElC,IAAI,WAAW,KAAK,IAAI;QAAE,OAAM;IAEhC,uBAAuB,CAAC,WAAW,EAAE,WAAW,CAAC,SAAS,IAAI,EAAE,CAAC,CAAA;IACjE,uBAAuB,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;IACvD,uBAAuB,CAAC,UAAU,EAAE,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;IAC/D,uBAAuB,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IAEzD,wBAAwB,CACtB,WAAW,EACX,WAAW,CAAC,SAAS,IAAI,EAAE,EAC3B,oBAAoB,CACrB,CAAA;IACD,wBAAwB,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,IAAI,EAAE,EAAE,eAAe,CAAC,CAAA;AAC3E,CAAC"}
+{"version":3,"file":"studio.js","sourceRoot":"","sources":["../../src/studio.ts"],"names":[],"mappings":"AAeA,wDAAwD;AACxD,MAAM,CAAC,MAAM,MAAM,GAAkB,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;AA2ClE,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAsC,CAAC,MAAM,CAAC,KAAK,IAAI,CACzD,CAAA;AACH,CAAC;AAyBD,MAAM,UAAU,MAAM,CACpB,GAAiD;IAEjD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAA;IAClE,OAAO;QACL,CAAC,MAAM,CAAC,EAAE,IAAI;QACd,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QACvB,IAAI,EAAE,GAA4B;KACnC,CAAA;AACH,CAAC"}

package/dist/src/timelineOffset.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Parsing for the string position arguments accepted by the narration and
+ * overlay controllers, e.g. `narration.intro('0:02')` or `overlays.tip('56%')`.
+ *
+ * A controller called with a NUMBER keeps its existing meaning (a relative
+ * duration in milliseconds). A controller called with a STRING means an absolute
+ * position in the final video: "this cue/overlay window should reach this point."
+ * Only strings flow through this module; numbers never do.
+ *
+ * Absolute positions are resolved against the finished render, so a percentage
+ * cannot be turned into milliseconds here (the total length is not known until
+ * render time). The parser therefore returns a discriminated union: concrete
+ * `'<n>s'`/timecode forms resolve to milliseconds, while `'<n>%'` surfaces a
+ * fraction the renderer multiplies by the final total.
+ */
+/**
+ * A position within the final video. Strings only (numbers are the existing
+ * duration path on each controller). Accepts:
+ *  - `'<n>s'`        seconds, e.g. `'2s'` or `'5.51s'`
+ *  - `'m:ss(.f)'`    timecode minutes:seconds, e.g. `'0:05.51'` (= 5.51s)
+ *  - `'h:mm:ss(.f)'` timecode hours:minutes:seconds, e.g. `'1:02:03.5'`
+ *  - `'<n>%'`        percentage of the total video, e.g. `'56.1%'`
+ *
+ * The template-literal members give editor hints for the common forms; the
+ * trailing `string` keeps timecodes (which the type system cannot express)
+ * assignable. Validation happens at runtime in {@link parseTimelineOffset}.
+ */
+export type TimelineOffset = `${number}s` | `${number}%` | string;
+/** Result of parsing a {@link TimelineOffset} string. */
+export type ParsedTimelineOffset = 
+/** From `'<n>s'` or a timecode: a concrete absolute position in milliseconds. */
+{
+    kind: 'absolute';
+    ms: number;
+}
+/** From `'<n>%'`: a fraction (0.561 for `'56.1%'`), resolved against the total at render. */
+ | {
+    kind: 'percent';
+    fraction: number;
+};
+/**
+ * Parses a string position into a {@link ParsedTimelineOffset}. Throws on any
+ * unrecognized or malformed input. Pure: no I/O, no globals.
+ */
+export declare function parseTimelineOffset(value: string): ParsedTimelineOffset;
+//# sourceMappingURL=timelineOffset.d.ts.map

package/dist/src/timelineOffset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timelineOffset.d.ts","sourceRoot":"","sources":["../../src/timelineOffset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,GAAG,MAAM,CAAA;AAEjE,yDAAyD;AACzD,MAAM,MAAM,oBAAoB;AAC9B,iFAAiF;AAC/E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAClC,6FAA6F;GAC3F;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAmBzC;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAqCvE"}

package/dist/src/timelineOffset.js

@@ -0,0 +1,66 @@
+/**
+ * Parsing for the string position arguments accepted by the narration and
+ * overlay controllers, e.g. `narration.intro('0:02')` or `overlays.tip('56%')`.
+ *
+ * A controller called with a NUMBER keeps its existing meaning (a relative
+ * duration in milliseconds). A controller called with a STRING means an absolute
+ * position in the final video: "this cue/overlay window should reach this point."
+ * Only strings flow through this module; numbers never do.
+ *
+ * Absolute positions are resolved against the finished render, so a percentage
+ * cannot be turned into milliseconds here (the total length is not known until
+ * render time). The parser therefore returns a discriminated union: concrete
+ * `'<n>s'`/timecode forms resolve to milliseconds, while `'<n>%'` surfaces a
+ * fraction the renderer multiplies by the final total.
+ */
+const SECONDS_RE = /^(\d+(?:\.\d+)?)s$/;
+const PERCENT_RE = /^(\d+(?:\.\d+)?)%$/;
+const TIMECODE_MIN_RE = /^(\d+):(\d{2}(?:\.\d+)?)$/;
+const TIMECODE_HOUR_RE = /^(\d+):(\d{2}):(\d{2}(?:\.\d+)?)$/;
+function invalidTimecode(value) {
+    throw new Error(`invalid timecode '${value}'; expected m:ss(.f) or h:mm:ss(.f) with mm/ss < 60`);
+}
+function invalidPosition(value) {
+    throw new Error(`invalid position '${value}'; expected '<n>s', a timecode 'm:ss(.f)'/'h:mm:ss(.f)', or '<n>%'`);
+}
+/**
+ * Parses a string position into a {@link ParsedTimelineOffset}. Throws on any
+ * unrecognized or malformed input. Pure: no I/O, no globals.
+ */
+export function parseTimelineOffset(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        invalidPosition(value);
+    const percent = PERCENT_RE.exec(trimmed);
+    if (percent !== null) {
+        return { kind: 'percent', fraction: Number(percent[1]) / 100 };
+    }
+    const seconds = SECONDS_RE.exec(trimmed);
+    if (seconds !== null) {
+        return { kind: 'absolute', ms: Number(seconds[1]) * 1000 };
+    }
+    const hour = TIMECODE_HOUR_RE.exec(trimmed);
+    if (hour !== null) {
+        const hours = Number(hour[1]);
+        const minutes = Number(hour[2]);
+        const secs = Number(hour[3]);
+        if (minutes >= 60 || secs >= 60)
+            invalidTimecode(value);
+        return { kind: 'absolute', ms: (hours * 3600 + minutes * 60 + secs) * 1000 };
+    }
+    const min = TIMECODE_MIN_RE.exec(trimmed);
+    if (min !== null) {
+        const minutes = Number(min[1]);
+        const secs = Number(min[2]);
+        if (secs >= 60)
+            invalidTimecode(value);
+        return { kind: 'absolute', ms: (minutes * 60 + secs) * 1000 };
+    }
+    // A bare `h:mm:ss`-shaped string that failed the strict patterns above (for
+    // example two-digit seconds were not supplied) is reported as a timecode error
+    // so the message points at the right fix.
+    if (/^\d+:\d/.test(trimmed))
+        invalidTimecode(value);
+    invalidPosition(value);
+}
+//# sourceMappingURL=timelineOffset.js.map

package/dist/src/timelineOffset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timelineOffset.js","sourceRoot":"","sources":["../../src/timelineOffset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAuBH,MAAM,UAAU,GAAG,oBAAoB,CAAA;AACvC,MAAM,UAAU,GAAG,oBAAoB,CAAA;AACvC,MAAM,eAAe,GAAG,2BAA2B,CAAA;AACnD,MAAM,gBAAgB,GAAG,mCAAmC,CAAA;AAE5D,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,qDAAqD,CAChF,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,oEAAoE,CAC/F,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,eAAe,CAAC,KAAK,CAAC,CAAA;IAEhD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACxC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAA;IAChE,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACxC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;IAC5D,CAAC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5B,IAAI,OAAO,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE;YAAE,eAAe,CAAC,KAAK,CAAC,CAAA;QACvD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,GAAG,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAA;IAC9E,CAAC;IAED,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3B,IAAI,IAAI,IAAI,EAAE;YAAE,eAAe,CAAC,KAAK,CAAC,CAAA;QACtC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAA;IAC/D,CAAC;IAED,4EAA4E;IAC5E,+EAA+E;IAC/E,0CAA0C;IAC1C,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,eAAe,CAAC,KAAK,CAAC,CAAA;IAEnD,eAAe,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC"}

package/dist/src/titleValidation.d.ts

@@ -1,3 +1,41 @@
+/**
+ * A render dependency declared via `selected(name)`: the `from` render embeds the
+ * `to` render's output as an overlay. Used for best-effort registration-time
+ * warnings; the authoritative existence/one-level/medium checks run on the
+ * backend at upload (it sees every file and language).
+ */
+export type DependencyReference = {
+    /** Name of the dependent video/screenshot (the one declaring `selected`). */
+    from: string;
+    /** Name referenced via `selected(name)` (the embedded target). */
+    to: string;
+};
+/**
+ * Videos and screenshots share a single name namespace within a run (both are
+ * rows in the same table, addressed by `selected(name)`). Titles must therefore
+ * be unique across BOTH mediums, not just within one. {@link findDuplicateTitles}
+ * already enforces this because every video and screenshot title is collected
+ * into the same list before checking, so a name reused across mediums surfaces as
+ * a duplicate.
+ */
 export declare function findDuplicateTitles(titles: readonly string[]): string[];
 export declare function formatDuplicateTitlesMessage(duplicates: readonly string[]): string;
+/**
+ * Returns the dependency references that point at themselves (`from === to`). A
+ * render cannot embed its own output, so these are always a mistake.
+ */
+export declare function findSelfReferences(references: readonly DependencyReference[]): DependencyReference[];
+/**
+ * Returns the dependency references whose target (`to`) is not among the
+ * `knownTitles` discovered in the run. This is a best-effort warning: a target
+ * may legitimately live in another file not part of this discovery, so the
+ * authoritative existence check runs on the backend at upload.
+ */
+export declare function findMissingReferences(references: readonly DependencyReference[], knownTitles: readonly string[]): DependencyReference[];
+/**
+ * Formats best-effort registration-time warnings for self-references and
+ * obviously missing dependency targets. Returns an empty string when there is
+ * nothing to warn about, so callers can skip emitting anything.
+ */
+export declare function formatDependencyWarnings(selfReferences: readonly DependencyReference[], missingReferences: readonly DependencyReference[]): string;
 //# sourceMappingURL=titleValidation.d.ts.map

package/dist/src/titleValidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"titleValidation.d.ts","sourceRoot":"","sources":["../../src/titleValidation.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAUvE;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,CAUR"}
+{"version":3,"file":"titleValidation.d.ts","sourceRoot":"","sources":["../../src/titleValidation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAUvE;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,CAUR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,SAAS,mBAAmB,EAAE,GACzC,mBAAmB,EAAE,CAEvB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,mBAAmB,EAAE,EAC1C,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,mBAAmB,EAAE,CAGvB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,SAAS,mBAAmB,EAAE,EAC9C,iBAAiB,EAAE,SAAS,mBAAmB,EAAE,GAChD,MAAM,CAcR"}

package/dist/src/titleValidation.js

@@ -1,3 +1,11 @@
+/**
+ * Videos and screenshots share a single name namespace within a run (both are
+ * rows in the same table, addressed by `selected(name)`). Titles must therefore
+ * be unique across BOTH mediums, not just within one. {@link findDuplicateTitles}
+ * already enforces this because every video and screenshot title is collected
+ * into the same list before checking, so a name reused across mediums surfaces as
+ * a duplicate.
+ */
 export function findDuplicateTitles(titles) {
     const counts = new Map();
     for (const title of titles) {
@@ -16,4 +24,38 @@ export function formatDuplicateTitlesMessage(duplicates) {
     }
     return lines.join('\n');
 }
+/**
+ * Returns the dependency references that point at themselves (`from === to`). A
+ * render cannot embed its own output, so these are always a mistake.
+ */
+export function findSelfReferences(references) {
+    return references.filter((ref) => ref.from === ref.to);
+}
+/**
+ * Returns the dependency references whose target (`to`) is not among the
+ * `knownTitles` discovered in the run. This is a best-effort warning: a target
+ * may legitimately live in another file not part of this discovery, so the
+ * authoritative existence check runs on the backend at upload.
+ */
+export function findMissingReferences(references, knownTitles) {
+    const known = new Set(knownTitles);
+    return references.filter((ref) => !known.has(ref.to));
+}
+/**
+ * Formats best-effort registration-time warnings for self-references and
+ * obviously missing dependency targets. Returns an empty string when there is
+ * nothing to warn about, so callers can skip emitting anything.
+ */
+export function formatDependencyWarnings(selfReferences, missingReferences) {
+    const lines = [];
+    for (const ref of selfReferences) {
+        lines.push(`  - "${ref.from}" uses selected("${ref.to}"), which references itself. A render cannot embed its own output.`);
+    }
+    for (const ref of missingReferences) {
+        lines.push(`  - "${ref.from}" uses selected("${ref.to}"), but no video or screenshot named "${ref.to}" was found in this run.`);
+    }
+    if (lines.length === 0)
+        return '';
+    return ['Dependency warnings:', ...lines].join('\n');
+}
 //# sourceMappingURL=titleValidation.js.map

package/dist/src/titleValidation.js.map

@@ -1 +1 @@
-{"version":3,"file":"titleValidation.js","sourceRoot":"","sources":["../../src/titleValidation.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,MAAyB;IAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IAExC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,UAA6B;IAE7B,MAAM,KAAK,GAAG;QACZ,gEAAgE;KACjE,CAAA;IAED,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAA;IAC9B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}
+{"version":3,"file":"titleValidation.js","sourceRoot":"","sources":["../../src/titleValidation.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAyB;IAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IAExC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,UAA6B;IAE7B,MAAM,KAAK,GAAG;QACZ,gEAAgE;KACjE,CAAA;IAED,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAA;IAC9B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAA0C;IAE1C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC,CAAA;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAA0C,EAC1C,WAA8B;IAE9B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAA;IAClC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,cAA8C,EAC9C,iBAAiD;IAEjD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CACR,QAAQ,GAAG,CAAC,IAAI,oBAAoB,GAAG,CAAC,EAAE,oEAAoE,CAC/G,CAAA;IACH,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CACR,QAAQ,GAAG,CAAC,IAAI,oBAAoB,GAAG,CAAC,EAAE,yCAAyC,GAAG,CAAC,EAAE,0BAA0B,CACpH,CAAA;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACjC,OAAO,CAAC,sBAAsB,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACtD,CAAC"}