@sogni-ai/sogni-intelligence-client 3.0.0-alpha.0

package/dist/media/audioReference.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEEDANCE_R2V_REFERENCE_AUDIO_MAX_DURATION_SECONDS = void 0;
+exports.normalizeReferenceAudioMimeType = normalizeReferenceAudioMimeType;
+exports.detectReferenceAudioFormat = detectReferenceAudioFormat;
+exports.shouldTrimSeedanceReferenceAudio = shouldTrimSeedanceReferenceAudio;
+exports.prepareReferenceAudioForVideo = prepareReferenceAudioForVideo;
+exports.prepareSeedanceReferenceAudioForVideo = prepareSeedanceReferenceAudioForVideo;
+exports.SEEDANCE_R2V_REFERENCE_AUDIO_MAX_DURATION_SECONDS = 15.2;
+function asciiAt(data, start, length) {
+    if (data.length < start + length)
+        return '';
+    let value = '';
+    for (let index = start; index < start + length; index += 1) {
+        value += String.fromCharCode(data[index]);
+    }
+    return value;
+}
+function normalizeReferenceAudioMimeType(mimeType) {
+    const trimmed = mimeType?.split(';')[0]?.trim().toLowerCase();
+    return trimmed || 'application/octet-stream';
+}
+function detectReferenceAudioFormat(data, mimeType) {
+    const normalizedMimeType = normalizeReferenceAudioMimeType(mimeType);
+    if (normalizedMimeType === 'audio/mpeg' || normalizedMimeType === 'audio/mp3') {
+        return 'mp3';
+    }
+    if (normalizedMimeType === 'audio/mp4'
+        || normalizedMimeType === 'audio/m4a'
+        || normalizedMimeType === 'audio/x-m4a') {
+        return 'm4a';
+    }
+    if (normalizedMimeType === 'audio/wav'
+        || normalizedMimeType === 'audio/x-wav'
+        || normalizedMimeType === 'audio/wave') {
+        return 'wav';
+    }
+    if (normalizedMimeType === 'audio/flac' || normalizedMimeType === 'audio/x-flac') {
+        return 'flac';
+    }
+    if (normalizedMimeType === 'audio/ogg' || normalizedMimeType === 'application/ogg') {
+        return 'ogg';
+    }
+    if (data.length >= 3 && asciiAt(data, 0, 3) === 'ID3')
+        return 'mp3';
+    if (data.length >= 2 && data[0] === 0xff && (data[1] & 0xe0) === 0xe0)
+        return 'mp3';
+    if (data.length >= 12 && asciiAt(data, 4, 4) === 'ftyp')
+        return 'm4a';
+    if (data.length >= 12 && asciiAt(data, 0, 4) === 'RIFF' && asciiAt(data, 8, 4) === 'WAVE') {
+        return 'wav';
+    }
+    if (data.length >= 4 && asciiAt(data, 0, 4) === 'fLaC')
+        return 'flac';
+    if (data.length >= 4 && asciiAt(data, 0, 4) === 'OggS')
+        return 'ogg';
+    return 'unknown';
+}
+function shouldNormalizeReferenceAudioToM4a(sourceFormat, options) {
+    if (sourceFormat === 'mp3')
+        return true;
+    return options.normalizeToM4a === true
+        && sourceFormat !== 'm4a'
+        && sourceFormat !== 'unknown';
+}
+function shouldNormalizeReferenceAudioToMp3(sourceFormat, options) {
+    return options.normalizeToMp3 === true
+        && sourceFormat !== 'mp3'
+        && sourceFormat !== 'unknown';
+}
+function finiteNonNegative(value, fallback = 0) {
+    const parsed = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(parsed) ? Math.max(0, parsed) : fallback;
+}
+function finitePositive(value, fallback) {
+    const parsed = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function shouldTrimSeedanceReferenceAudio(input) {
+    const startOffset = finiteNonNegative(input.startOffsetSeconds);
+    if (startOffset > 0)
+        return true;
+    const maxDuration = finitePositive(input.maxDurationSeconds, exports.SEEDANCE_R2V_REFERENCE_AUDIO_MAX_DURATION_SECONDS);
+    const sourceDuration = input.sourceDurationSeconds;
+    if (typeof sourceDuration !== 'number' || !Number.isFinite(sourceDuration)) {
+        return false;
+    }
+    return sourceDuration > maxDuration;
+}
+async function prepareReferenceAudioForVideo(data, mimeType, filename = 'reference-audio', options = {}) {
+    const inputMimeType = normalizeReferenceAudioMimeType(mimeType);
+    const sourceFormat = detectReferenceAudioFormat(data, inputMimeType);
+    if (shouldNormalizeReferenceAudioToMp3(sourceFormat, options)) {
+        const transcode = options.transcodeToMp3;
+        if (!transcode) {
+            throw new Error('Reference audio must be normalized to MP3 through a host adapter before video generation.');
+        }
+        const result = await transcode({
+            data,
+            filename,
+            inputMimeType,
+            sourceFormat,
+        });
+        if (!(result.data instanceof Uint8Array) || result.data.length === 0) {
+            throw new Error('Reference audio MP3 transcode did not return media bytes.');
+        }
+        return {
+            data: result.data,
+            mimeType: normalizeReferenceAudioMimeType(result.mimeType || 'audio/mpeg'),
+            sourceFormat,
+            transcoded: true,
+            trimmed: false,
+        };
+    }
+    if (!shouldNormalizeReferenceAudioToM4a(sourceFormat, options)) {
+        return {
+            data,
+            mimeType: inputMimeType,
+            sourceFormat,
+            transcoded: false,
+            trimmed: false,
+        };
+    }
+    const transcode = options.transcodeToM4a ?? options.transcodeMp3;
+    if (!transcode) {
+        throw new Error('Reference audio must be normalized through a host adapter before video generation.');
+    }
+    const result = await transcode({
+        data,
+        filename,
+        inputMimeType,
+        sourceFormat,
+    });
+    if (!(result.data instanceof Uint8Array) || result.data.length === 0) {
+        throw new Error('MP3 reference audio transcode did not return media bytes.');
+    }
+    return {
+        data: result.data,
+        mimeType: normalizeReferenceAudioMimeType(result.mimeType || 'audio/mp4'),
+        sourceFormat,
+        transcoded: true,
+        trimmed: false,
+    };
+}
+async function prepareSeedanceReferenceAudioForVideo(data, mimeType, filename = 'reference-audio', options = {}) {
+    const inputMimeType = normalizeReferenceAudioMimeType(mimeType);
+    const sourceFormat = detectReferenceAudioFormat(data, inputMimeType);
+    const sourceDuration = typeof options.sourceDurationSeconds === 'number'
+        && Number.isFinite(options.sourceDurationSeconds)
+        ? Math.max(0, options.sourceDurationSeconds)
+        : undefined;
+    const requestedDuration = finitePositive(options.maxDurationSeconds, exports.SEEDANCE_R2V_REFERENCE_AUDIO_MAX_DURATION_SECONDS);
+    const startOffset = finiteNonNegative(options.startOffsetSeconds);
+    if (shouldTrimSeedanceReferenceAudio({
+        sourceDurationSeconds: sourceDuration,
+        maxDurationSeconds: requestedDuration,
+        startOffsetSeconds: startOffset,
+    })) {
+        if (!options.trimAudio) {
+            throw new Error('Seedance reference audio must be trimmed through a host adapter before video generation.');
+        }
+        const result = await options.trimAudio({
+            data,
+            filename,
+            inputMimeType,
+            sourceFormat,
+            duration: requestedDuration,
+            start: startOffset,
+        });
+        if (!(result.data instanceof Uint8Array) || result.data.length === 0) {
+            throw new Error('Seedance reference audio trim did not return media bytes.');
+        }
+        return {
+            data: result.data,
+            mimeType: normalizeReferenceAudioMimeType(result.mimeType || 'audio/mp4'),
+            sourceFormat,
+            transcoded: options.normalizeToMp3 === true
+                ? sourceFormat !== 'mp3'
+                : sourceFormat === 'mp3',
+            trimmed: true,
+            requestedDuration,
+            startOffset,
+            ...(sourceDuration !== undefined ? { sourceDuration } : {}),
+        };
+    }
+    const prepared = await prepareReferenceAudioForVideo(data, inputMimeType, filename, options);
+    return {
+        ...prepared,
+        requestedDuration,
+        startOffset,
+        ...(sourceDuration !== undefined ? { sourceDuration } : {}),
+    };
+}
+//# sourceMappingURL=audioReference.js.map

package/dist/media/audioReference.js.map

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

package/dist/media/cameraAngle.d.ts

@@ -0,0 +1,170 @@
+export declare const CAMERA_ANGLE_LORA: {
+    readonly id: "multiple_angles";
+    readonly defaultStrength: 0.9;
+};
+export declare const AZIMUTHS: readonly [{
+    readonly key: "front";
+    readonly label: "Front";
+    readonly prompt: "front view";
+    readonly angle: 0;
+}, {
+    readonly key: "front-right";
+    readonly label: "Front Right";
+    readonly prompt: "front-right quarter view";
+    readonly angle: 45;
+}, {
+    readonly key: "right";
+    readonly label: "Right";
+    readonly prompt: "right side view";
+    readonly angle: 90;
+}, {
+    readonly key: "back-right";
+    readonly label: "Back Right";
+    readonly prompt: "back-right quarter view";
+    readonly angle: 135;
+}, {
+    readonly key: "back";
+    readonly label: "Back";
+    readonly prompt: "back view";
+    readonly angle: 180;
+}, {
+    readonly key: "back-left";
+    readonly label: "Back Left";
+    readonly prompt: "back-left quarter view";
+    readonly angle: 225;
+}, {
+    readonly key: "left";
+    readonly label: "Left";
+    readonly prompt: "left side view";
+    readonly angle: 270;
+}, {
+    readonly key: "front-left";
+    readonly label: "Front Left";
+    readonly prompt: "front-left quarter view";
+    readonly angle: 315;
+}];
+export declare const ELEVATIONS: readonly [{
+    readonly key: "low-angle";
+    readonly label: "Low Angle";
+    readonly prompt: "low-angle shot";
+    readonly angle: -30;
+}, {
+    readonly key: "eye-level";
+    readonly label: "Eye Level";
+    readonly prompt: "eye-level shot";
+    readonly angle: 0;
+}, {
+    readonly key: "elevated";
+    readonly label: "Elevated";
+    readonly prompt: "elevated shot";
+    readonly angle: 30;
+}, {
+    readonly key: "high-angle";
+    readonly label: "High Angle";
+    readonly prompt: "high-angle shot";
+    readonly angle: 60;
+}];
+export declare const DISTANCES: readonly [{
+    readonly key: "close-up";
+    readonly label: "Close-up";
+    readonly prompt: "close-up";
+    readonly scale: 0.6;
+}, {
+    readonly key: "medium";
+    readonly label: "Medium";
+    readonly prompt: "medium shot";
+    readonly scale: 1;
+}, {
+    readonly key: "wide";
+    readonly label: "Wide";
+    readonly prompt: "wide shot";
+    readonly scale: 1.8;
+}];
+export type AzimuthKey = (typeof AZIMUTHS)[number]['key'];
+export type ElevationKey = (typeof ELEVATIONS)[number]['key'];
+export type DistanceKey = (typeof DISTANCES)[number]['key'];
+export interface CameraAngleData {
+    azimuth: AzimuthKey;
+    elevation: ElevationKey;
+    distance: DistanceKey;
+}
+export declare function getAzimuthConfig(key: AzimuthKey): {
+    readonly key: "front";
+    readonly label: "Front";
+    readonly prompt: "front view";
+    readonly angle: 0;
+} | {
+    readonly key: "front-right";
+    readonly label: "Front Right";
+    readonly prompt: "front-right quarter view";
+    readonly angle: 45;
+} | {
+    readonly key: "right";
+    readonly label: "Right";
+    readonly prompt: "right side view";
+    readonly angle: 90;
+} | {
+    readonly key: "back-right";
+    readonly label: "Back Right";
+    readonly prompt: "back-right quarter view";
+    readonly angle: 135;
+} | {
+    readonly key: "back";
+    readonly label: "Back";
+    readonly prompt: "back view";
+    readonly angle: 180;
+} | {
+    readonly key: "back-left";
+    readonly label: "Back Left";
+    readonly prompt: "back-left quarter view";
+    readonly angle: 225;
+} | {
+    readonly key: "left";
+    readonly label: "Left";
+    readonly prompt: "left side view";
+    readonly angle: 270;
+} | {
+    readonly key: "front-left";
+    readonly label: "Front Left";
+    readonly prompt: "front-left quarter view";
+    readonly angle: 315;
+};
+export declare function getElevationConfig(key: ElevationKey): {
+    readonly key: "low-angle";
+    readonly label: "Low Angle";
+    readonly prompt: "low-angle shot";
+    readonly angle: -30;
+} | {
+    readonly key: "eye-level";
+    readonly label: "Eye Level";
+    readonly prompt: "eye-level shot";
+    readonly angle: 0;
+} | {
+    readonly key: "elevated";
+    readonly label: "Elevated";
+    readonly prompt: "elevated shot";
+    readonly angle: 30;
+} | {
+    readonly key: "high-angle";
+    readonly label: "High Angle";
+    readonly prompt: "high-angle shot";
+    readonly angle: 60;
+};
+export declare function getDistanceConfig(key: DistanceKey): {
+    readonly key: "close-up";
+    readonly label: "Close-up";
+    readonly prompt: "close-up";
+    readonly scale: 0.6;
+} | {
+    readonly key: "medium";
+    readonly label: "Medium";
+    readonly prompt: "medium shot";
+    readonly scale: 1;
+} | {
+    readonly key: "wide";
+    readonly label: "Wide";
+    readonly prompt: "wide shot";
+    readonly scale: 1.8;
+};
+export declare function buildCameraAnglePrompt(azimuth: AzimuthKey, elevation: ElevationKey, distance: DistanceKey): string;
+//# sourceMappingURL=cameraAngle.d.ts.map

package/dist/media/cameraAngle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraAngle.d.ts","sourceRoot":"","sources":["../../src/media/cameraAngle.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASX,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;EAKb,CAAC;AAEX,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;EAIZ,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE/C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;EAEnD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW;;;;;;;;;;;;;;;EAEjD;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,WAAW,GACpB,MAAM,CAMR"}

package/dist/media/cameraAngle.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DISTANCES = exports.ELEVATIONS = exports.AZIMUTHS = exports.CAMERA_ANGLE_LORA = void 0;
+exports.getAzimuthConfig = getAzimuthConfig;
+exports.getElevationConfig = getElevationConfig;
+exports.getDistanceConfig = getDistanceConfig;
+exports.buildCameraAnglePrompt = buildCameraAnglePrompt;
+exports.CAMERA_ANGLE_LORA = {
+    id: 'multiple_angles',
+    defaultStrength: 0.9,
+};
+exports.AZIMUTHS = [
+    { key: 'front', label: 'Front', prompt: 'front view', angle: 0 },
+    { key: 'front-right', label: 'Front Right', prompt: 'front-right quarter view', angle: 45 },
+    { key: 'right', label: 'Right', prompt: 'right side view', angle: 90 },
+    { key: 'back-right', label: 'Back Right', prompt: 'back-right quarter view', angle: 135 },
+    { key: 'back', label: 'Back', prompt: 'back view', angle: 180 },
+    { key: 'back-left', label: 'Back Left', prompt: 'back-left quarter view', angle: 225 },
+    { key: 'left', label: 'Left', prompt: 'left side view', angle: 270 },
+    { key: 'front-left', label: 'Front Left', prompt: 'front-left quarter view', angle: 315 },
+];
+exports.ELEVATIONS = [
+    { key: 'low-angle', label: 'Low Angle', prompt: 'low-angle shot', angle: -30 },
+    { key: 'eye-level', label: 'Eye Level', prompt: 'eye-level shot', angle: 0 },
+    { key: 'elevated', label: 'Elevated', prompt: 'elevated shot', angle: 30 },
+    { key: 'high-angle', label: 'High Angle', prompt: 'high-angle shot', angle: 60 },
+];
+exports.DISTANCES = [
+    { key: 'close-up', label: 'Close-up', prompt: 'close-up', scale: 0.6 },
+    { key: 'medium', label: 'Medium', prompt: 'medium shot', scale: 1.0 },
+    { key: 'wide', label: 'Wide', prompt: 'wide shot', scale: 1.8 },
+];
+function getAzimuthConfig(key) {
+    return exports.AZIMUTHS.find((a) => a.key === key) || exports.AZIMUTHS[0];
+}
+function getElevationConfig(key) {
+    return exports.ELEVATIONS.find((e) => e.key === key) || exports.ELEVATIONS[1];
+}
+function getDistanceConfig(key) {
+    return exports.DISTANCES.find((d) => d.key === key) || exports.DISTANCES[1];
+}
+function buildCameraAnglePrompt(azimuth, elevation, distance) {
+    const azimuthConfig = getAzimuthConfig(azimuth);
+    const elevationConfig = getElevationConfig(elevation);
+    const distanceConfig = getDistanceConfig(distance);
+    return `<sks> ${azimuthConfig.prompt} ${elevationConfig.prompt} ${distanceConfig.prompt}`;
+}
+//# sourceMappingURL=cameraAngle.js.map

package/dist/media/cameraAngle.js.map

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

package/dist/media/characterSheet.d.ts

@@ -0,0 +1,9 @@
+export declare const CHARACTER_SHEET_DEFAULT_CANVAS: {
+    readonly width: 1536;
+    readonly height: 1024;
+    readonly aspectRatio: "1536x1024";
+};
+export declare function textRequestsProfessionalCharacterSheetImage(text: string): boolean;
+export declare function promptContainsProfessionalCharacterSheetInstruction(text: string): boolean;
+export declare function prependProfessionalCharacterSheetInstruction(prompt: string, userIntentText?: string): string;
+//# sourceMappingURL=characterSheet.d.ts.map

package/dist/media/characterSheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterSheet.d.ts","sourceRoot":"","sources":["../../src/media/characterSheet.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B;;;;CAIjC,CAAC;AAQX,wBAAgB,2CAA2C,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAoBjF;AAED,wBAAgB,mDAAmD,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzF;AAED,wBAAgB,4CAA4C,CAC1D,MAAM,EAAE,MAAM,EACd,cAAc,SAAK,GAClB,MAAM,CAkBR"}

package/dist/media/characterSheet.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHARACTER_SHEET_DEFAULT_CANVAS = void 0;
+exports.textRequestsProfessionalCharacterSheetImage = textRequestsProfessionalCharacterSheetImage;
+exports.promptContainsProfessionalCharacterSheetInstruction = promptContainsProfessionalCharacterSheetInstruction;
+exports.prependProfessionalCharacterSheetInstruction = prependProfessionalCharacterSheetInstruction;
+exports.CHARACTER_SHEET_DEFAULT_CANVAS = {
+    width: 1536,
+    height: 1024,
+    aspectRatio: '1536x1024',
+};
+const CHARACTER_SHEET_MARKER = 'PROFESSIONAL CHARACTER SHEET CONTRACT';
+function normalizeText(text) {
+    return text.replace(/[“”]/g, '"').replace(/[’]/g, "'").replace(/\s+/g, ' ').trim();
+}
+function textRequestsProfessionalCharacterSheetImage(text) {
+    const normalized = normalizeText(text);
+    if (!normalized)
+        return false;
+    const generationVerb = String.raw `(?:generate|create|make|render|produce|design|build|develop|draw)`;
+    const characterSubject = String.raw `(?:character|mascot|brand\s+mascot|creature|avatar|persona|toon|cartoon\s+character)`;
+    const sheetArtifact = String.raw `(?:character\s+sheet|mascot\s+sheet|model\s+sheet|reference\s+(?:sheet|board)|design\s+sheet|turnaround(?:\s+(?:sheet|views?|board))?|expression\s+(?:sheet|row|board)|pose\s+(?:sheet|board))`;
+    const directCharacterSheet = new RegExp(String.raw `\b${characterSubject}\b[\s\S]{0,80}\b(?:sheet|reference\s+(?:sheet|board)|model\s+sheet|turnaround(?:\s+(?:sheet|views?|board))?|expression\s+(?:sheet|row|board)|pose\s+(?:sheet|board))\b`, 'i').test(normalized)
+        || new RegExp(String.raw `\b${sheetArtifact}\b[\s\S]{0,80}\b${characterSubject}\b`, 'i').test(normalized)
+        || /\breusable\s+character\s+sheet\b/i.test(normalized);
+    if (!directCharacterSheet)
+        return false;
+    return new RegExp(String.raw `\b${generationVerb}\b[\s\S]{0,180}\b${sheetArtifact}\b`, 'i').test(normalized)
+        || new RegExp(String.raw `\b${sheetArtifact}\b[\s\S]{0,120}\b(?:image|illustration|artwork|render|board|layout)\b`, 'i').test(normalized)
+        || new RegExp(String.raw `\b(?:need|want|would\s+like|looking\s+for|please|can\s+you|could\s+you)\b[\s\S]{0,120}\b${sheetArtifact}\b`, 'i').test(normalized);
+}
+function promptContainsProfessionalCharacterSheetInstruction(text) {
+    return normalizeText(text).includes(CHARACTER_SHEET_MARKER);
+}
+function prependProfessionalCharacterSheetInstruction(prompt, userIntentText = '') {
+    const trimmedPrompt = prompt.trim();
+    if (!trimmedPrompt)
+        return trimmedPrompt;
+    if (trimmedPrompt.includes(CHARACTER_SHEET_MARKER))
+        return trimmedPrompt;
+    const textCopyInstruction = /\b(?:slogan|tagline|logo|brand|copy|text|caption|label|headline|title|wording|reads?|says?)\b/i.test(userIntentText)
+        ? 'Preserve exact user-provided brand names, slogans, taglines, logo text, labels, and requested copy verbatim; incidental tiny notes such as personality or fun-fact blurbs may be generated by the image model when the user did not provide exact wording.'
+        : 'Use clean, readable typography for labels and notes; any incidental personality, fun-fact, or usage notes may be generated by the image model unless the user supplied exact copy.';
+    return [
+        `${CHARACTER_SHEET_MARKER}: Create one polished, reusable animation/brand mascot character design sheet, not a sparse six-panel grid and not separate image variations.`,
+        'Keep the character identity consistent across every view and pose. Use uploaded reference images as assigned by the request; preserve logos and brand assets where used.',
+        'Layout should feel like a professional character reference board on a soft neutral studio background with clean typography and an organized product-brand design aesthetic.',
+        'Include, when visually feasible in the single sheet: a large hero pose; turnaround views labeled front, 3/4 front, side, back, and 3/4 back; an expression row; action/personality poses; accessory or prop callouts; color palette swatches; compact personality notes; fun facts or brand usage notes.',
+        textCopyInstruction,
+        'Prioritize high-quality 3D rendered or polished illustration detail, soft studio lighting, consistent proportions, expressive personality, and sharp presentation.',
+        trimmedPrompt,
+    ].join(' ');
+}
+//# sourceMappingURL=characterSheet.js.map

package/dist/media/characterSheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterSheet.js","sourceRoot":"","sources":["../../src/media/characterSheet.ts"],"names":[],"mappings":";;;AAYA,kGAoBC;AAED,kHAEC;AAED,oGAqBC;AA3DY,QAAA,8BAA8B,GAAG;IAC5C,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,WAAW;CAChB,CAAC;AAEX,MAAM,sBAAsB,GAAG,uCAAuC,CAAC;AAEvE,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACrF,CAAC;AAED,SAAgB,2CAA2C,CAAC,IAAY;IACtE,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAE9B,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAA,mEAAmE,CAAC;IACrG,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAA,sFAAsF,CAAC;IAC1H,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAA,gMAAgM,CAAC;IAEjO,MAAM,oBAAoB,GAAG,IAAI,MAAM,CACrC,MAAM,CAAC,GAAG,CAAA,KAAK,gBAAgB,wKAAwK,EACvM,GAAG,CACJ,CAAC,IAAI,CAAC,UAAU,CAAC;WACb,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,KAAK,aAAa,mBAAmB,gBAAgB,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;WACrG,mCAAmC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE1D,IAAI,CAAC,oBAAoB;QAAE,OAAO,KAAK,CAAC;IAExC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,KAAK,cAAc,oBAAoB,aAAa,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;WACtG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,KAAK,aAAa,uEAAuE,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;WACrI,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,2FAA2F,aAAa,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAChK,CAAC;AAED,SAAgB,mDAAmD,CAAC,IAAY;IAC9E,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;AAC9D,CAAC;AAED,SAAgB,4CAA4C,CAC1D,MAAc,EACd,cAAc,GAAG,EAAE;IAEnB,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,aAAa;QAAE,OAAO,aAAa,CAAC;IACzC,IAAI,aAAa,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAAE,OAAO,aAAa,CAAC;IAEzE,MAAM,mBAAmB,GAAG,gGAAgG,CAAC,IAAI,CAAC,cAAc,CAAC;QAC/I,CAAC,CAAC,4PAA4P;QAC9P,CAAC,CAAC,oLAAoL,CAAC;IAEzL,OAAO;QACL,GAAG,sBAAsB,+IAA+I;QACxK,0KAA0K;QAC1K,6KAA6K;QAC7K,0SAA0S;QAC1S,mBAAmB;QACnB,oKAAoK;QACpK,aAAa;KACd,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC"}

package/dist/media/danceMontage.d.ts

@@ -0,0 +1,18 @@
+export declare const DANCE_MONTAGE_MAX_CLIP_DURATION_SECONDS = 20;
+export declare const DANCE_MONTAGE_MAX_DURATION_SECONDS = 30;
+export declare const DANCE_MONTAGE_PREFERRED_SEGMENT_DURATION_SECONDS = 10;
+export declare const DANCE_MONTAGE_MIN_SEGMENT_DURATION_SECONDS = 5;
+export interface DanceSegmentPlanInput {
+    requestedDuration: number;
+    imageCount: number;
+    presetMaxDuration: number;
+    singleClip?: boolean;
+}
+export interface DanceSegmentPlan {
+    duration: number;
+    segmentCount: number;
+    segmentDuration: number;
+}
+export declare function normalizeDanceMontageDurationArg(requestedDuration: number | null): number | undefined;
+export declare function planDanceMontageSegments(input: DanceSegmentPlanInput): DanceSegmentPlan;
+//# sourceMappingURL=danceMontage.d.ts.map

package/dist/media/danceMontage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"danceMontage.d.ts","sourceRoot":"","sources":["../../src/media/danceMontage.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uCAAuC,KAAK,CAAC;AAG1D,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAGrD,eAAO,MAAM,gDAAgD,KAAK,CAAC;AAGnE,eAAO,MAAM,0CAA0C,IAAI,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IAEpC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,UAAU,EAAE,MAAM,CAAC;IAEnB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAE/B,QAAQ,EAAE,MAAM,CAAC;IAEjB,YAAY,EAAE,MAAM,CAAC;IAErB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,gCAAgC,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAGrG;AAQD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB,CA8BvF"}

package/dist/media/danceMontage.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DANCE_MONTAGE_MIN_SEGMENT_DURATION_SECONDS = exports.DANCE_MONTAGE_PREFERRED_SEGMENT_DURATION_SECONDS = exports.DANCE_MONTAGE_MAX_DURATION_SECONDS = exports.DANCE_MONTAGE_MAX_CLIP_DURATION_SECONDS = void 0;
+exports.normalizeDanceMontageDurationArg = normalizeDanceMontageDurationArg;
+exports.planDanceMontageSegments = planDanceMontageSegments;
+exports.DANCE_MONTAGE_MAX_CLIP_DURATION_SECONDS = 20;
+exports.DANCE_MONTAGE_MAX_DURATION_SECONDS = 30;
+exports.DANCE_MONTAGE_PREFERRED_SEGMENT_DURATION_SECONDS = 10;
+exports.DANCE_MONTAGE_MIN_SEGMENT_DURATION_SECONDS = 5;
+function normalizeDanceMontageDurationArg(requestedDuration) {
+    if (typeof requestedDuration !== 'number' || !Number.isFinite(requestedDuration))
+        return undefined;
+    return Math.min(exports.DANCE_MONTAGE_MAX_DURATION_SECONDS, Math.max(8, requestedDuration));
+}
+function planDanceMontageSegments(input) {
+    const { imageCount, singleClip = false } = input;
+    let duration = Math.min(input.requestedDuration, input.presetMaxDuration, exports.DANCE_MONTAGE_MAX_DURATION_SECONDS);
+    let segmentCount;
+    if (singleClip && duration <= exports.DANCE_MONTAGE_MAX_CLIP_DURATION_SECONDS) {
+        segmentCount = 1;
+    }
+    else {
+        const minRequired = Math.max(imageCount, Math.ceil(duration / exports.DANCE_MONTAGE_MAX_CLIP_DURATION_SECONDS));
+        const maxForMinDuration = Math.floor(duration / exports.DANCE_MONTAGE_MIN_SEGMENT_DURATION_SECONDS);
+        const preferredCount = Math.ceil(duration / exports.DANCE_MONTAGE_PREFERRED_SEGMENT_DURATION_SECONDS);
+        segmentCount = Math.min(maxForMinDuration, Math.max(minRequired, preferredCount));
+        segmentCount = Math.max(segmentCount, minRequired);
+    }
+    let segmentDuration = Math.round((duration / segmentCount) * 4) / 4;
+    segmentDuration = Math.max(exports.DANCE_MONTAGE_MIN_SEGMENT_DURATION_SECONDS, Math.min(exports.DANCE_MONTAGE_MAX_CLIP_DURATION_SECONDS, segmentDuration));
+    duration = segmentDuration * segmentCount;
+    return { duration, segmentCount, segmentDuration };
+}
+//# sourceMappingURL=danceMontage.js.map

package/dist/media/danceMontage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"danceMontage.js","sourceRoot":"","sources":["../../src/media/danceMontage.ts"],"names":[],"mappings":";;;AAkCA,4EAGC;AAQD,4DA8BC;AAxEY,QAAA,uCAAuC,GAAG,EAAE,CAAC;AAG7C,QAAA,kCAAkC,GAAG,EAAE,CAAC;AAGxC,QAAA,gDAAgD,GAAG,EAAE,CAAC;AAGtD,QAAA,0CAA0C,GAAG,CAAC,CAAC;AAsB5D,SAAgB,gCAAgC,CAAC,iBAAgC;IAC/E,IAAI,OAAO,iBAAiB,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,SAAS,CAAC;IACnG,OAAO,IAAI,CAAC,GAAG,CAAC,0CAAkC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC;AACtF,CAAC;AAQD,SAAgB,wBAAwB,CAAC,KAA4B;IACnE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IACjD,IAAI,QAAQ,GAAG,IAAI,CAAC,GAAG,CACrB,KAAK,CAAC,iBAAiB,EACvB,KAAK,CAAC,iBAAiB,EACvB,0CAAkC,CACnC,CAAC;IAEF,IAAI,YAAoB,CAAC;IACzB,IAAI,UAAU,IAAI,QAAQ,IAAI,+CAAuC,EAAE,CAAC;QACtE,YAAY,GAAG,CAAC,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAC1B,UAAU,EACV,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,+CAAuC,CAAC,CAC9D,CAAC;QACF,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,kDAA0C,CAAC,CAAC;QAC5F,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,wDAAgD,CAAC,CAAC;QAC9F,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;QAClF,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACpE,eAAe,GAAG,IAAI,CAAC,GAAG,CACxB,kDAA0C,EAC1C,IAAI,CAAC,GAAG,CAAC,+CAAuC,EAAE,eAAe,CAAC,CACnE,CAAC;IACF,QAAQ,GAAG,eAAe,GAAG,YAAY,CAAC;IAE1C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;AACrD,CAAC"}