@sogni-ai/sogni-intelligence-client 2.1.0

package/dist-esm/contracts/videoComposition.js.map

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

package/dist-esm/index.js

@@ -0,0 +1,10 @@
+export { SogniClientWrapper } from './client/SogniClientWrapper.js';
+export { ClientEvent } from './types/index.js';
+export { SogniError, SogniConnectionError, SogniAuthenticationError, SogniProjectError, SogniTimeoutError, SogniBalanceError, SogniValidationError, SogniConfigurationError, SogniModelNotFoundError, SogniNetworkError, } from './utils/errors.js';
+export { generateAppId, validateClientConfig, validateProjectConfig, isImageProjectConfig, isVideoProjectConfig, isAudioProjectConfig, isWanVideoModel, isLtxVideoModel, isSeedanceVideoModel, isCookieAuth, sleep, retry, formatBytes, formatDuration, getMaxContextImages, supportsContextImages, } from './utils/helpers.js';
+export { ChatStream, CreativeWorkflowsApi, SogniClient, SogniTools, isSogniToolCall, parseCreativeWorkflowSseChunk, parseToolCallArguments, } from '@sogni-ai/sogni-client';
+export { extractDynamicPromptBranches, isolateDynamicPromptSlot, buildDynamicPromptSlotPrompts, validateSceneDynamicPromptBatch, validateSingleDynamicPromptBranch, promptHasStoryboardBatchLanguage, promptHasLinkedVariantBatchLanguage, isStoryboardKeyframeBatchPrompt, } from './tools/shared/dynamicPromptBranches.js';
+export { textExplicitlyRequestsMultipleImageOutputs } from './tools/shared/multiImageIntent.js';
+export { maybeAlignNumberOfVariationsToDynamicBranchCount } from './tools/shared/numberOfVariationsAlignment.js';
+export { SogniClientWrapper as default } from './client/SogniClientWrapper.js';
+//# sourceMappingURL=index.js.map

package/dist-esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAyFpE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,KAAK,EACL,KAAK,EACL,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,eAAe,EACf,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAGL,4BAA4B,EAC5B,wBAAwB,EACxB,6BAA6B,EAC7B,+BAA+B,EAC/B,iCAAiC,EACjC,gCAAgC,EAChC,mCAAmC,EACnC,+BAA+B,GAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,0CAA0C,EAAE,MAAM,oCAAoC,CAAC;AAChG,OAAO,EAAE,gDAAgD,EAAE,MAAM,+CAA+C,CAAC;AAGjH,OAAO,EAAE,kBAAkB,IAAI,OAAO,EAAE,MAAM,gCAAgC,CAAC"}

package/dist-esm/media/aspectRatio.js

@@ -0,0 +1,65 @@
+import { parseAspectRatio } from './imageDimensions.js';
+export const DEFAULT_MAX_MEDIA_ASPECT_RATIO = 4;
+export function validateMediaAspectRatio(width, height, maxAspectRatio = DEFAULT_MAX_MEDIA_ASPECT_RATIO) {
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+        return 'Resolution dimensions must be positive numbers.';
+    }
+    const ratio = Math.max(width, height) / Math.min(width, height);
+    if (ratio > maxAspectRatio) {
+        return `Aspect ratio ${width}:${height} is too extreme; use ${maxAspectRatio}:1 or less.`;
+    }
+    return null;
+}
+export function validateMediaDimensions(width, height, bounds) {
+    if (!Number.isInteger(width) || !Number.isInteger(height)) {
+        return 'Resolution width and height must be whole pixel values.';
+    }
+    const label = bounds.label ? `${bounds.label} ` : '';
+    if (width < bounds.minDimension || height < bounds.minDimension) {
+        return `${label}resolution must be at least ${bounds.minDimension}px on each side.`;
+    }
+    if (width > bounds.maxDimension || height > bounds.maxDimension) {
+        return `${label}resolution must be ${bounds.maxDimension}px or less on each side.`;
+    }
+    const aspectError = validateMediaAspectRatio(width, height, bounds.maxAspectRatio);
+    if (aspectError)
+        return aspectError;
+    const pixels = width * height;
+    if (bounds.minPixels !== undefined && pixels < bounds.minPixels) {
+        return `${label}resolution must contain at least ${bounds.minPixels.toLocaleString()} total pixels.`;
+    }
+    if (bounds.maxPixels !== undefined && pixels > bounds.maxPixels) {
+        return `${label}resolution must contain ${bounds.maxPixels.toLocaleString()} total pixels or fewer.`;
+    }
+    return null;
+}
+export function validateMediaDimensionValue(value, bounds, dimensionName = 'dimension') {
+    if (!Number.isInteger(value)) {
+        return `Resolution ${dimensionName} must be a whole pixel value.`;
+    }
+    const label = bounds.label ? `${bounds.label} ` : '';
+    if (value < bounds.minDimension) {
+        return `${label}resolution ${dimensionName} must be at least ${bounds.minDimension}px.`;
+    }
+    if (value > bounds.maxDimension) {
+        return `${label}resolution ${dimensionName} must be ${bounds.maxDimension}px or less.`;
+    }
+    return null;
+}
+export function validateMediaAspectRatioString(aspectRatio, bounds) {
+    const parsed = parseAspectRatio(aspectRatio);
+    if (!parsed)
+        return null;
+    if (parsed.type === 'exact') {
+        return validateMediaDimensions(parsed.width, parsed.height, bounds);
+    }
+    return validateMediaAspectRatio(parsed.ratioW, parsed.ratioH, bounds.maxAspectRatio);
+}
+export const ASPECT_RATIO_DESCRIPTION = `Do NOT set unless the user explicitly requests an aspect ratio, format, orientation, or exact pixel dimensions. When a reference/source image is used and the user did not ask to change its shape, omit this field so the handler preserves the selected source image's own ratio.
+
+Formats: "16:9", "9:16", "4:5", "1:1", "4:3", "3:2", "21:9", or exact pixels like "1920x1080".
+
+CRITICAL: When the user specifies exact pixel dimensions (e.g., "1280x720", "1080x1920", "1920x1080", "3840x2160") or an orientation-qualified named resolution (e.g., "720p landscape", "720p portrait"), use the exact pixel format, NOT a ratio like "16:9" or "9:16". Exact user-requested dimensions override the selected default media quality, including Pro/HQ defaults. A bare named video resolution like "720p resolution" is only a resolution tier/short-side request; do not turn it into landscape pixels and do not set aspectRatio unless the user also states landscape, portrait, vertical, horizontal, or exact pixels. If requested pixels are in bounds but not on the model's pixel step, still pass the user's exact pixel request; the handler snaps to the nearest supported size internally. Only use ratio format when the user says a generic format name without pixel dimensions.
+
+Mappings (use ONLY when user does NOT specify pixel dimensions): landscape/widescreen/YouTube/cinematic → "16:9". portrait → "9:16". TikTok/Reels/IG Reels → "1080x1920". ultrawide/cinema scope → "21:9". Instagram post → "4:5". square → "1:1". standard/TV → "4:3". 720p landscape → "1280x720". 720p portrait → "720x1280". 1080p landscape → "1920x1080". 1080p portrait/HD portrait → "1080x1920". 4K landscape → "3840x2160". 4K portrait → "2160x3840". Never set for generic requests like "make a video".`;
+//# sourceMappingURL=aspectRatio.js.map

package/dist-esm/media/aspectRatio.js.map

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

package/dist-esm/media/audioReference.js

@@ -0,0 +1,186 @@
+export const 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;
+}
+export function normalizeReferenceAudioMimeType(mimeType) {
+    const trimmed = mimeType?.split(';')[0]?.trim().toLowerCase();
+    return trimmed || 'application/octet-stream';
+}
+export 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;
+}
+export function shouldTrimSeedanceReferenceAudio(input) {
+    const startOffset = finiteNonNegative(input.startOffsetSeconds);
+    if (startOffset > 0)
+        return true;
+    const maxDuration = finitePositive(input.maxDurationSeconds, SEEDANCE_R2V_REFERENCE_AUDIO_MAX_DURATION_SECONDS);
+    const sourceDuration = input.sourceDurationSeconds;
+    if (typeof sourceDuration !== 'number' || !Number.isFinite(sourceDuration)) {
+        return false;
+    }
+    return sourceDuration > maxDuration;
+}
+export 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,
+    };
+}
+export 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, 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-esm/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-esm/media/cameraAngle.js

@@ -0,0 +1,41 @@
+export const CAMERA_ANGLE_LORA = {
+    id: 'multiple_angles',
+    defaultStrength: 0.9,
+};
+export const 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 },
+];
+export const 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 },
+];
+export const 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 },
+];
+export function getAzimuthConfig(key) {
+    return AZIMUTHS.find((a) => a.key === key) || AZIMUTHS[0];
+}
+export function getElevationConfig(key) {
+    return ELEVATIONS.find((e) => e.key === key) || ELEVATIONS[1];
+}
+export function getDistanceConfig(key) {
+    return DISTANCES.find((d) => d.key === key) || DISTANCES[1];
+}
+export 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-esm/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-esm/media/characterSheet.js

@@ -0,0 +1,48 @@
+export const 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();
+}
+export 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);
+}
+export function promptContainsProfessionalCharacterSheetInstruction(text) {
+    return normalizeText(text).includes(CHARACTER_SHEET_MARKER);
+}
+export 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-esm/media/characterSheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterSheet.js","sourceRoot":"","sources":["../../src/media/characterSheet.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,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,MAAM,UAAU,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,MAAM,UAAU,mDAAmD,CAAC,IAAY;IAC9E,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,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-esm/media/danceMontage.js

@@ -0,0 +1,29 @@
+export const DANCE_MONTAGE_MAX_CLIP_DURATION_SECONDS = 20;
+export const DANCE_MONTAGE_MAX_DURATION_SECONDS = 30;
+export const DANCE_MONTAGE_PREFERRED_SEGMENT_DURATION_SECONDS = 10;
+export const DANCE_MONTAGE_MIN_SEGMENT_DURATION_SECONDS = 5;
+export function normalizeDanceMontageDurationArg(requestedDuration) {
+    if (typeof requestedDuration !== 'number' || !Number.isFinite(requestedDuration))
+        return undefined;
+    return Math.min(DANCE_MONTAGE_MAX_DURATION_SECONDS, Math.max(8, requestedDuration));
+}
+export function planDanceMontageSegments(input) {
+    const { imageCount, singleClip = false } = input;
+    let duration = Math.min(input.requestedDuration, input.presetMaxDuration, DANCE_MONTAGE_MAX_DURATION_SECONDS);
+    let segmentCount;
+    if (singleClip && duration <= DANCE_MONTAGE_MAX_CLIP_DURATION_SECONDS) {
+        segmentCount = 1;
+    }
+    else {
+        const minRequired = Math.max(imageCount, Math.ceil(duration / DANCE_MONTAGE_MAX_CLIP_DURATION_SECONDS));
+        const maxForMinDuration = Math.floor(duration / DANCE_MONTAGE_MIN_SEGMENT_DURATION_SECONDS);
+        const preferredCount = Math.ceil(duration / 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(DANCE_MONTAGE_MIN_SEGMENT_DURATION_SECONDS, Math.min(DANCE_MONTAGE_MAX_CLIP_DURATION_SECONDS, segmentDuration));
+    duration = segmentDuration * segmentCount;
+    return { duration, segmentCount, segmentDuration };
+}
+//# sourceMappingURL=danceMontage.js.map

package/dist-esm/media/danceMontage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"danceMontage.js","sourceRoot":"","sources":["../../src/media/danceMontage.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,uCAAuC,GAAG,EAAE,CAAC;AAG1D,MAAM,CAAC,MAAM,kCAAkC,GAAG,EAAE,CAAC;AAGrD,MAAM,CAAC,MAAM,gDAAgD,GAAG,EAAE,CAAC;AAGnE,MAAM,CAAC,MAAM,0CAA0C,GAAG,CAAC,CAAC;AAsB5D,MAAM,UAAU,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,kCAAkC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC;AACtF,CAAC;AAQD,MAAM,UAAU,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,kCAAkC,CACnC,CAAC;IAEF,IAAI,YAAoB,CAAC;IACzB,IAAI,UAAU,IAAI,QAAQ,IAAI,uCAAuC,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,uCAAuC,CAAC,CAC9D,CAAC;QACF,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,0CAA0C,CAAC,CAAC;QAC5F,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,gDAAgD,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,0CAA0C,EAC1C,IAAI,CAAC,GAAG,CAAC,uCAAuC,EAAE,eAAe,CAAC,CACnE,CAAC;IACF,QAAQ,GAAG,eAAe,GAAG,YAAY,CAAC;IAE1C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;AACrD,CAAC"}