@memberjunction/video-studio-render-worker 0.0.1-seed.1 → 6.2.0-edge.7

package/dist/checks/dom-rules.js

@@ -0,0 +1,205 @@
+import { ExtractNumericLiteralTokens, } from '@memberjunction/video-studio-core';
+import { IsAllowedNumericLiteral } from './static-checks.js';
+/** Check issue code emitted when a rendered text box extends outside the format's safe area. */
+export const MJ_SAFE_AREA_CODE = 'MJ_SAFE_AREA';
+/** Check issue code emitted when rendered text has `FontSizePx` below the minimum threshold. */
+export const MJ_MIN_TEXT_SIZE_CODE = 'MJ_MIN_TEXT_SIZE';
+/** Check issue code emitted when rendered text outside `data-mj-bound` contains an unapproved numeric literal. */
+export const MJ_UNBOUND_LITERAL_RENDERED_CODE = 'MJ_UNBOUND_LITERAL_RENDERED';
+/** Check issue code emitted when a `data-mj-bound="<key>"` attribute is empty or not in `BoundDataLiterals`. */
+export const MJ_BOUND_KEY_UNKNOWN_CODE = 'MJ_BOUND_KEY_UNKNOWN';
+/** Check issue code emitted at a settle timestamp when a `data-mj-bound="<key>"` element renders a numeric token not in `BoundDataLiterals[key]`. */
+export const MJ_BOUND_VALUE_MISMATCH_CODE = 'MJ_BOUND_VALUE_MISMATCH';
+/** Check issue code emitted when a required provenance / as-of card substring is missing on the final frame. */
+export const MJ_ASOF_CARD_MISSING_CODE = 'MJ_ASOF_CARD_MISSING';
+/** Check issue code emitted when rendered text uses a font family that is not bundled. */
+export const MJ_UNBUNDLED_FONT_CODE = 'MJ_UNBUNDLED_FONT';
+/**
+ * Tunable safe-area inset fractions per `VideoFormat` (VS-RND-5 Decision 3).
+ *
+ * - `16:9` and `1:1`: `0.05` on every side.
+ * - `9:16`: top `0.10`, bottom `0.20`, left `0.06`, right `0.12`.
+ */
+export const SAFE_AREA_INSETS = Object.freeze({
+    '16:9': Object.freeze({ Top: 0.05, Bottom: 0.05, Left: 0.05, Right: 0.05 }),
+    '1:1': Object.freeze({ Top: 0.05, Bottom: 0.05, Left: 0.05, Right: 0.05 }),
+    '9:16': Object.freeze({ Top: 0.1, Bottom: 0.2, Left: 0.06, Right: 0.12 }),
+});
+/**
+ * Tunable minimum text size as a fraction of the frame's short edge (VS-RND-5 Decision 3).
+ * At `1920x1080` or `1080x1920` (short edge `1080`), `0.025 * 1080 = 27px`.
+ */
+export const MIN_TEXT_SIZE_SHORT_EDGE_RATIO = 0.025;
+const FLOAT_EPSILON = 1e-6;
+const TIMESTAMP_MATCH_TOLERANCE = 1e-3;
+/**
+ * Evaluates pure DOM rules (`MJ_SAFE_AREA`, `MJ_MIN_TEXT_SIZE`, `MJ_UNBOUND_LITERAL_RENDERED`,
+ * `MJ_BOUND_KEY_UNKNOWN`, `MJ_BOUND_VALUE_MISMATCH`, `MJ_ASOF_CARD_MISSING`, `MJ_UNBUNDLED_FONT`)
+ * over a flat or per-timestamp list of `MeasuredText` items.
+ */
+export function EvaluateDomRules(measurements, options) {
+    const issues = [];
+    const insets = SAFE_AREA_INSETS[options.Format] ?? SAFE_AREA_INSETS['16:9'];
+    const minLeft = options.Width * insets.Left;
+    const maxRight = options.Width * (1 - insets.Right);
+    const minTop = options.Height * insets.Top;
+    const maxBottom = options.Height * (1 - insets.Bottom);
+    const shortEdge = Math.min(options.Width, options.Height);
+    const minFontSizePx = shortEdge * MIN_TEXT_SIZE_SHORT_EDGE_RATIO;
+    const allowedSet = new Set((options.AllowedDataLiterals ?? []).map((item) => item.trim()).filter((item) => item.length > 0));
+    const boundAllowedByKey = buildBoundAllowedMap(options.BoundDataLiterals);
+    const settleTimestamps = options.SettleTimestampsSeconds ?? [];
+    for (const item of measurements) {
+        checkSafeArea(item, minLeft, minTop, maxRight, maxBottom, options.Format, issues);
+        checkMinTextSize(item, minFontSizePx, issues);
+        checkRenderedLiterals(item, allowedSet, boundAllowedByKey, settleTimestamps, issues);
+        checkBundledFont(item, issues);
+    }
+    checkRequiredFinalFrameText(measurements, options.RequiredFinalFrameText, options.FinalFrameTimestampSeconds, issues);
+    return issues;
+}
+function buildBoundAllowedMap(boundDataLiterals) {
+    if (!boundDataLiterals) {
+        return undefined;
+    }
+    const map = new Map();
+    for (const [key, values] of Object.entries(boundDataLiterals)) {
+        const set = new Set((Array.isArray(values) ? values : [])
+            .map((v) => String(v).trim())
+            .filter((v) => v.length > 0));
+        map.set(key, set);
+    }
+    return map;
+}
+function isAtSettleTimestamp(timestampSeconds, settleTimestamps) {
+    for (const settleTs of settleTimestamps) {
+        if (Math.abs(timestampSeconds - settleTs) <= TIMESTAMP_MATCH_TOLERANCE) {
+            return true;
+        }
+    }
+    return false;
+}
+function checkSafeArea(item, minLeft, minTop, maxRight, maxBottom, format, issues) {
+    const right = item.Left + item.Width;
+    const bottom = item.Top + item.Height;
+    const outsideLeft = item.Left < minLeft - FLOAT_EPSILON;
+    const outsideTop = item.Top < minTop - FLOAT_EPSILON;
+    const outsideRight = right > maxRight + FLOAT_EPSILON;
+    const outsideBottom = bottom > maxBottom + FLOAT_EPSILON;
+    if (outsideLeft || outsideTop || outsideRight || outsideBottom) {
+        issues.push({
+            Code: MJ_SAFE_AREA_CODE,
+            Category: 'SafeArea',
+            Severity: 'Error',
+            Message: `Text element "${item.Selector}" box (${Math.round(item.Left)}, ${Math.round(item.Top)}, ` +
+                `${Math.round(item.Width)}x${Math.round(item.Height)}) extends outside the ${format} safe area ` +
+                `[${Math.round(minLeft)}..${Math.round(maxRight)}, ${Math.round(minTop)}..${Math.round(maxBottom)}].`,
+            Selector: item.Selector,
+            TimestampSeconds: item.TimestampSeconds,
+        });
+    }
+}
+function checkMinTextSize(item, minFontSizePx, issues) {
+    if (item.FontSizePx < minFontSizePx - FLOAT_EPSILON) {
+        issues.push({
+            Code: MJ_MIN_TEXT_SIZE_CODE,
+            Category: 'MinTextSize',
+            Severity: 'Error',
+            Message: `Text element "${item.Selector}" has font-size ${Number(item.FontSizePx.toFixed(2))}px, ` +
+                `below the minimum ${Number(minFontSizePx.toFixed(2))}px.`,
+            Selector: item.Selector,
+            TimestampSeconds: item.TimestampSeconds,
+        });
+    }
+}
+function checkRenderedLiterals(item, allowedSet, boundAllowedByKey, settleTimestamps, issues) {
+    if (item.IsBound) {
+        const boundKey = (item.BoundKey ?? '').trim();
+        const allowedForKey = boundKey.length > 0 ? boundAllowedByKey?.get(boundKey) : undefined;
+        if (boundKey.length === 0 || !allowedForKey) {
+            issues.push({
+                Code: MJ_BOUND_KEY_UNKNOWN_CODE,
+                Category: 'DataLiteral',
+                Severity: 'Error',
+                Message: boundKey.length === 0
+                    ? `Bound text element "${item.Selector}" has an empty data-mj-bound key.`
+                    : `Bound text element "${item.Selector}" references unknown data-mj-bound key "${boundKey}".`,
+                Selector: item.Selector,
+                TimestampSeconds: item.TimestampSeconds,
+            });
+            return;
+        }
+        if (!isAtSettleTimestamp(item.TimestampSeconds, settleTimestamps)) {
+            return;
+        }
+        const tokens = ExtractNumericLiteralTokens(item.Text);
+        for (const token of tokens) {
+            if (!IsAllowedNumericLiteral(token, allowedForKey)) {
+                issues.push({
+                    Code: MJ_BOUND_VALUE_MISMATCH_CODE,
+                    Category: 'DataLiteral',
+                    Severity: 'Error',
+                    Message: `Bound rendered numeric literal "${token}" in "${item.Selector}" ` +
+                        `[data-mj-bound="${boundKey}"] is not in BoundDataLiterals["${boundKey}"].`,
+                    Selector: item.Selector,
+                    TimestampSeconds: item.TimestampSeconds,
+                });
+            }
+        }
+        return;
+    }
+    const tokens = ExtractNumericLiteralTokens(item.Text);
+    for (const token of tokens) {
+        if (!IsAllowedNumericLiteral(token, allowedSet)) {
+            issues.push({
+                Code: MJ_UNBOUND_LITERAL_RENDERED_CODE,
+                Category: 'DataLiteral',
+                Severity: 'Error',
+                Message: `Unbound rendered numeric literal "${token}" in "${item.Selector}" is not in AllowedDataLiterals.`,
+                Selector: item.Selector,
+                TimestampSeconds: item.TimestampSeconds,
+            });
+        }
+    }
+}
+function checkRequiredFinalFrameText(measurements, requiredTexts, explicitFinalFrameTs, issues) {
+    if (!requiredTexts || requiredTexts.length === 0) {
+        return;
+    }
+    const normalizedRequired = requiredTexts
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    if (normalizedRequired.length === 0) {
+        return;
+    }
+    const finalTs = explicitFinalFrameTs ??
+        (measurements.length > 0
+            ? Math.max(...measurements.map((m) => m.TimestampSeconds))
+            : 0);
+    const finalFrameMeasurements = measurements.filter((m) => Math.abs(m.TimestampSeconds - finalTs) <= TIMESTAMP_MATCH_TOLERANCE);
+    for (const required of normalizedRequired) {
+        const present = finalFrameMeasurements.some((m) => m.Text.includes(required));
+        if (!present) {
+            issues.push({
+                Code: MJ_ASOF_CARD_MISSING_CODE,
+                Category: 'Provenance',
+                Severity: 'Error',
+                Message: `Required final-frame provenance text "${required}" was not found in any visible text element at t=${Number(finalTs.toFixed(3))}s.`,
+                TimestampSeconds: finalTs,
+            });
+        }
+    }
+}
+function checkBundledFont(item, issues) {
+    if (!item.FontIsBundled) {
+        issues.push({
+            Code: MJ_UNBUNDLED_FONT_CODE,
+            Category: 'Lint',
+            Severity: 'Error',
+            Message: `Text element "${item.Selector}" uses unbundled font family "${item.FontFamily}".`,
+            Selector: item.Selector,
+            TimestampSeconds: item.TimestampSeconds,
+        });
+    }
+}
+//# sourceMappingURL=dom-rules.js.map

package/dist/checks/dom-rules.js.map

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

package/dist/checks/hyperframes-check.d.ts

@@ -0,0 +1,37 @@
+import type { CheckIssue } from '@memberjunction/video-studio-core';
+/** Check issue code emitted when `hyperframes check --json` output cannot be parsed. */
+export declare const MJ_CHECK_CLI_UNREADABLE_CODE = "MJ_CHECK_CLI_UNREADABLE";
+/** Check issue code emitted when the `hyperframes check` CLI subprocess fails or crashes. */
+export declare const MJ_CHECK_CLI_FAILED_CODE = "MJ_CHECK_CLI_FAILED";
+/**
+ * Builds the strict six-key environment passed to the `hyperframes check --json`
+ * subprocess (VS-RND-5 Step 3 / Round 1 Fix 1):
+ * - `PATH`: `sourceEnv.PATH ?? ''`
+ * - `TMPDIR`: `sourceEnv.TMPDIR ?? os.tmpdir()`
+ * - `HOME`: isolated per-job directory so `~/.cache/puppeteer` and `~/.hyperframes/telemetry.json` are not used
+ * - `HYPERFRAMES_NO_TELEMETRY: '1'`
+ * - `DO_NOT_TRACK: '1'`
+ * - `HYPERFRAMES_BROWSER_PATH`: the worker's resolved headless browser binary path
+ */
+export declare function BuildReducedCheckCliEnv(sourceEnv?: NodeJS.ProcessEnv, homeDir?: string, browserPath?: string): NodeJS.ProcessEnv;
+/**
+ * Builds a single `MJ_CHECK_CLI_FAILED` Warning issue when the `hyperframes check` CLI subprocess
+ * crashes, times out, or fails to execute.
+ */
+export declare function BuildCheckCliFailedIssue(reason: string): CheckIssue;
+/**
+ * Builds a single `MJ_CHECK_CLI_UNREADABLE` Warning issue when `hyperframes check --json` stdout
+ * is empty, malformed JSON, or missing expected audit sections.
+ */
+export declare function BuildCheckCliUnreadableIssue(reason: string): CheckIssue;
+/**
+ * Maps `hyperframes check --json` output into `CheckIssue[]` (VS-RND-5 Step 7):
+ * - `layout.findings` → `Layout`
+ * - `contrast.findings` → `Contrast`
+ * - `motion.findings` → `Lint`
+ * - `severity === 'error'` → `'Error'`, anything else → `'Warning'`
+ * - `{"ok":false,"error":"..."}` → one `MJ_CHECK_CLI_FAILED` Warning with that error message
+ * - Unparseable output → one `MJ_CHECK_CLI_UNREADABLE` Warning with the reason.
+ */
+export declare function MapHyperFramesCheckOutput(json: string | unknown): CheckIssue[];
+//# sourceMappingURL=hyperframes-check.d.ts.map

package/dist/checks/hyperframes-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperframes-check.d.ts","sourceRoot":"","sources":["../../src/checks/hyperframes-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,UAAU,EAGb,MAAM,mCAAmC,CAAC;AAE3C,wFAAwF;AACxF,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE,6FAA6F;AAC7F,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AA0B9D;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACnC,SAAS,GAAE,MAAM,CAAC,UAAwB,EAC1C,OAAO,GAAE,MAAoB,EAC7B,WAAW,SAAK,GACjB,MAAM,CAAC,UAAU,CASnB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAQnE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAQvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,EAAE,CAiB9E"}

package/dist/checks/hyperframes-check.js

@@ -0,0 +1,161 @@
+import * as os from 'node:os';
+/** Check issue code emitted when `hyperframes check --json` output cannot be parsed. */
+export const MJ_CHECK_CLI_UNREADABLE_CODE = 'MJ_CHECK_CLI_UNREADABLE';
+/** Check issue code emitted when the `hyperframes check` CLI subprocess fails or crashes. */
+export const MJ_CHECK_CLI_FAILED_CODE = 'MJ_CHECK_CLI_FAILED';
+/**
+ * Builds the strict six-key environment passed to the `hyperframes check --json`
+ * subprocess (VS-RND-5 Step 3 / Round 1 Fix 1):
+ * - `PATH`: `sourceEnv.PATH ?? ''`
+ * - `TMPDIR`: `sourceEnv.TMPDIR ?? os.tmpdir()`
+ * - `HOME`: isolated per-job directory so `~/.cache/puppeteer` and `~/.hyperframes/telemetry.json` are not used
+ * - `HYPERFRAMES_NO_TELEMETRY: '1'`
+ * - `DO_NOT_TRACK: '1'`
+ * - `HYPERFRAMES_BROWSER_PATH`: the worker's resolved headless browser binary path
+ */
+export function BuildReducedCheckCliEnv(sourceEnv = process.env, homeDir = os.tmpdir(), browserPath = '') {
+    return {
+        PATH: sourceEnv.PATH ?? '',
+        TMPDIR: sourceEnv.TMPDIR ?? os.tmpdir(),
+        HOME: homeDir,
+        HYPERFRAMES_NO_TELEMETRY: '1',
+        DO_NOT_TRACK: '1',
+        HYPERFRAMES_BROWSER_PATH: browserPath,
+    };
+}
+/**
+ * Builds a single `MJ_CHECK_CLI_FAILED` Warning issue when the `hyperframes check` CLI subprocess
+ * crashes, times out, or fails to execute.
+ */
+export function BuildCheckCliFailedIssue(reason) {
+    const trimmed = reason.trim() || 'Unknown CLI failure';
+    return {
+        Code: MJ_CHECK_CLI_FAILED_CODE,
+        Category: 'Lint',
+        Severity: 'Warning',
+        Message: `HyperFrames check CLI failed: ${trimmed}`,
+    };
+}
+/**
+ * Builds a single `MJ_CHECK_CLI_UNREADABLE` Warning issue when `hyperframes check --json` stdout
+ * is empty, malformed JSON, or missing expected audit sections.
+ */
+export function BuildCheckCliUnreadableIssue(reason) {
+    const trimmed = reason.trim() || 'Unparseable CLI JSON output';
+    return {
+        Code: MJ_CHECK_CLI_UNREADABLE_CODE,
+        Category: 'Lint',
+        Severity: 'Warning',
+        Message: `HyperFrames check CLI output was unreadable: ${trimmed}`,
+    };
+}
+/**
+ * Maps `hyperframes check --json` output into `CheckIssue[]` (VS-RND-5 Step 7):
+ * - `layout.findings` → `Layout`
+ * - `contrast.findings` → `Contrast`
+ * - `motion.findings` → `Lint`
+ * - `severity === 'error'` → `'Error'`, anything else → `'Warning'`
+ * - `{"ok":false,"error":"..."}` → one `MJ_CHECK_CLI_FAILED` Warning with that error message
+ * - Unparseable output → one `MJ_CHECK_CLI_UNREADABLE` Warning with the reason.
+ */
+export function MapHyperFramesCheckOutput(json) {
+    const parsed = parseCliReport(json);
+    if (parsed.cliError) {
+        return [BuildCheckCliFailedIssue(parsed.cliError)];
+    }
+    if (!parsed.report) {
+        return [BuildCheckCliUnreadableIssue(parsed.reason ?? 'Unparseable CLI JSON output')];
+    }
+    const report = parsed.report;
+    const issues = [];
+    appendSectionFindings(report.layout, 'Layout', issues);
+    appendSectionFindings(report.contrast, 'Contrast', issues);
+    appendSectionFindings(report.motion, 'Lint', issues);
+    return issues;
+}
+function parseCliReport(input) {
+    let value = input;
+    if (typeof input === 'string') {
+        const trimmed = input.trim();
+        if (!trimmed) {
+            return { reason: 'CLI stdout was empty.' };
+        }
+        try {
+            value = JSON.parse(trimmed);
+        }
+        catch (error) {
+            return {
+                reason: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return { reason: 'CLI output root is not a JSON object.' };
+    }
+    const candidate = value;
+    const hasSection = isSectionObject(candidate.layout) ||
+        isSectionObject(candidate.contrast) ||
+        isSectionObject(candidate.motion);
+    if (!hasSection) {
+        if (typeof candidate.error === 'string' && candidate.error.trim().length > 0) {
+            return { cliError: candidate.error.trim() };
+        }
+        return {
+            reason: 'CLI JSON object does not contain layout, contrast, or motion sections.',
+        };
+    }
+    return { report: candidate };
+}
+function isSectionObject(section) {
+    return (Boolean(section) &&
+        typeof section === 'object' &&
+        !Array.isArray(section) &&
+        Array.isArray(section.findings));
+}
+function appendSectionFindings(section, category, out) {
+    if (!isSectionObject(section) || !Array.isArray(section.findings)) {
+        return;
+    }
+    for (const raw of section.findings) {
+        if (!raw || typeof raw !== 'object') {
+            continue;
+        }
+        const finding = raw;
+        const code = typeof finding.code === 'string' && finding.code.trim()
+            ? finding.code.trim()
+            : `hyperframes_${category.toLowerCase()}_finding`;
+        const severity = typeof finding.severity === 'string' && finding.severity.toLowerCase() === 'error'
+            ? 'Error'
+            : 'Warning';
+        const message = typeof finding.message === 'string' && finding.message.trim()
+            ? finding.message.trim()
+            : `HyperFrames ${category.toLowerCase()} check reported ${code}.`;
+        const selector = typeof finding.selector === 'string' && finding.selector.trim()
+            ? finding.selector.trim()
+            : undefined;
+        const file = typeof finding.sourceFile === 'string' && finding.sourceFile.trim()
+            ? finding.sourceFile.trim()
+            : typeof finding.file === 'string' && finding.file.trim()
+                ? finding.file.trim()
+                : undefined;
+        const line = typeof finding.line === 'number' && Number.isFinite(finding.line)
+            ? finding.line
+            : undefined;
+        const time = typeof finding.time === 'number' && Number.isFinite(finding.time)
+            ? finding.time
+            : typeof finding.firstSeen === 'number' && Number.isFinite(finding.firstSeen)
+                ? finding.firstSeen
+                : undefined;
+        out.push({
+            Code: code,
+            Category: category,
+            Severity: severity,
+            Message: message,
+            ...(file !== undefined ? { File: file } : {}),
+            ...(line !== undefined ? { Line: line } : {}),
+            ...(time !== undefined ? { TimestampSeconds: time } : {}),
+            ...(selector !== undefined ? { Selector: selector } : {}),
+        });
+    }
+}
+//# sourceMappingURL=hyperframes-check.js.map

package/dist/checks/hyperframes-check.js.map

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

package/dist/checks/static-checks.d.ts

@@ -0,0 +1,46 @@
+import { type CheckIssue, type RenderProjectBundle } from '@memberjunction/video-studio-core';
+/** Issue code emitted when a relative asset reference is missing from `Bundle.Files` and `Bundle.Assets`. */
+export declare const MJ_MISSING_ASSET_CODE = "MJ_MISSING_ASSET";
+/** Issue code emitted when a composition script calls a non-deterministic time or timer API. */
+export declare const MJ_NONDETERMINISTIC_API_CODE = "MJ_NONDETERMINISTIC_API";
+/** Issue code emitted when authored HTML contains an unbound numeric literal outside `data-mj-bound`. */
+export declare const MJ_UNBOUND_LITERAL_SOURCE_CODE = "MJ_UNBOUND_LITERAL_SOURCE";
+/**
+ * `@hyperframes/lint` rule codes that already flag `Date.now(`, `new Date()`, `performance.now(`,
+ * and `requestAnimationFrame(` inside HTML inline `<script>` blocks (verified in Step 1c).
+ */
+export declare const HYPERFRAMES_LINT_NONDETERMINISTIC_CODES: readonly ["non_deterministic_code", "requestanimationframe_in_composition"];
+/**
+ * Options for `RunStaticChecks`.
+ */
+export interface StaticCheckOptions {
+    /**
+     * Explicit list of allowed numeric literal tokens (e.g. from `CheckRequest.AllowedDataLiterals`).
+     * When omitted or empty, no unbound numeric literals are allowed (Decision 1).
+     */
+    AllowedDataLiterals?: readonly string[];
+    /**
+     * Existing issues returned by `RunLintGate` (`@hyperframes/lint`). Used to skip emitting
+     * duplicate `MJ_NONDETERMINISTIC_API` findings on the same `(File, Line)` when HyperFrames
+     * lint has already reported `non_deterministic_code` or `requestanimationframe_in_composition`.
+     */
+    ExistingLintIssues?: readonly CheckIssue[];
+    /**
+     * When true, skips the 4 non-deterministic APIs (`Date.now(`, `new Date()`, `performance.now(`,
+     * `requestAnimationFrame(`) inside HTML inline `<script>` tags that `@hyperframes/lint` scans,
+     * even if `ExistingLintIssues` is not passed.
+     */
+    SkipHyperFramesHtmlDuplicates?: boolean;
+}
+/**
+ * Runs pure static checks over authored files in `bundle`:
+ * - `MJ_MISSING_ASSET` (`MissingAsset`, Error)
+ * - `MJ_NONDETERMINISTIC_API` (`Lint`, Error)
+ * - `MJ_UNBOUND_LITERAL_SOURCE` (`DataLiteral`, Error)
+ */
+export declare function RunStaticChecks(bundle: RenderProjectBundle, options?: StaticCheckOptions | readonly string[]): CheckIssue[];
+/**
+ * Checks whether an extracted numeric literal token matches `allowedLiterals`.
+ */
+export declare function IsAllowedNumericLiteral(token: string, allowedLiterals: ReadonlySet<string>): boolean;
+//# sourceMappingURL=static-checks.d.ts.map

package/dist/checks/static-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-checks.d.ts","sourceRoot":"","sources":["../../src/checks/static-checks.ts"],"names":[],"mappings":"AACA,OAAO,EAEH,KAAK,UAAU,EAEf,KAAK,mBAAmB,EAC3B,MAAM,mCAAmC,CAAC;AAE3C,6GAA6G;AAC7G,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD,gGAAgG;AAChG,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE,yGAAyG;AACzG,eAAO,MAAM,8BAA8B,8BAA8B,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,uCAAuC,6EAG1C,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC3C;;;;OAIG;IACH,6BAA6B,CAAC,EAAE,OAAO,CAAC;CAC3C;AAkDD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC3B,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,MAAM,EAAE,GACjD,UAAU,EAAE,CAyCd;AAkoBD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAEpG"}