@chuzi/shared 1.3.34 → 1.3.36

package/dist/appearance-DFP3Ymge.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Constellation presentation tokens — consumed by the cosmos realm camera,
+ * star billboards, and ghost title typography. Admins can override via
+ * saved experience / appearance templates.
+ */
+interface ConstellationAppearance {
+    /** Ghost film title spanning the constellation. */
+    titleFontSize: number;
+    titleOpacity: number;
+    titleColor: string;
+    titleLetterSpacing: number;
+    titleYOffset: number;
+    /** Per-star preview card + label. */
+    previewWidth: number;
+    previewHeight: number;
+    previewOffsetY: number;
+    labelFontSize: number;
+    labelLetterSpacing: number;
+    labelGap: number;
+    billboardDistanceFactor: number;
+    /** Camera — floating-in-space slide between stars. */
+    cameraDefaultOffset: [number, number, number];
+    cameraTargetOffset: [number, number, number];
+    /** 0–1 lerp factor per frame while gliding (lower = smoother / pressurized). */
+    cameraSlideLerp: number;
+    cameraArrivalThreshold: number;
+}
+declare const DEFAULT_CONSTELLATION_APPEARANCE: ConstellationAppearance;
+declare function mergeConstellationAppearance(overrides?: Partial<ConstellationAppearance>): ConstellationAppearance;
+
+export { type ConstellationAppearance as C, DEFAULT_CONSTELLATION_APPEARANCE as D, mergeConstellationAppearance as m };

package/dist/index.d.ts

@@ -1,6 +1,29 @@
-export { AcceptGenerationRequest, AcceptGenerationResponse, AiGeneration, AiGenerationShowResponse, AiGenerationStatus, BookmarkListItem, BookmarkListResponse, BookmarkResponse, CatalogResponse, ContentRating, ContentRatingDefinition, CreateSceneActionRequest, CreateSceneRequest, CreateStoryRequest, EngagementResponse, GenerateImageRequest, GenerateImageResponse, HistoryEntry, LineType, LocaleId, MagicLinkRequest, MagicLinkRequestResponse, MagicLinkVerifyRequest, MagicLinkVerifyResponse, MediaItem, MineResponse, OidcExchangeRequest, OidcExchangeResponse, PaginatedLink, PaginatedResponse, PasswordLoginRequest, PasswordLoginResponse, PlayUrlResponse, PopularChoice, PublicDirectorProfile, RealmConfigResponse, RealmDefinition, RealmId, RegisterMediaRequest, RegisterMediaResponse, RejectGenerationRequest, RejectGenerationResponse, SaveBookmarkRequest, SceneActionItem, SceneActionPayload, SceneChoice, SceneListItem, SceneMapEntry, SceneMapResponse, SceneNode, SceneTextContent, SceneVisibility, SourceUrlResponse, StateUpdate, StoryListItem, StoryPreview, StoryProgress, StoryStyleResponse, TagListResponse, TextLine, TrackEngagementRequest, TranscodeRequest, TranscodeResponse, TreeGraph, TreeGraphEdge, TreeGraphNode, UpdateLocaleRequest, UpdateLocaleResponse, UpdateProfileRequest, UpdateProfileResponse, UpdateRealmRequest, UpdateRealmResponse, UpdateSceneActionRequest, UpdateSceneRequest, UpdateStoryRequest, UploadUrlRequest, UploadUrlResponse, UserProfile, UsernameAvailabilityResponse, VisibilityCondition, VisibilityRules, WatchSnapshot, computeSceneVisibility } from './types/index.js';
+import { SceneListItem, SceneChoice, TextLine } from './types/index.js';
+export { AcceptGenerationRequest, AcceptGenerationResponse, AiGeneration, AiGenerationShowResponse, AiGenerationStatus, BookmarkListItem, BookmarkListResponse, BookmarkResponse, CatalogResponse, ContentRating, ContentRatingDefinition, CreateSceneActionRequest, CreateSceneRequest, CreateStoryRequest, EngagementResponse, GenerateImageRequest, GenerateImageResponse, HistoryEntry, LineType, LocaleId, MagicLinkRequest, MagicLinkRequestResponse, MagicLinkVerifyRequest, MagicLinkVerifyResponse, MediaItem, MineResponse, OidcExchangeRequest, OidcExchangeResponse, PaginatedLink, PaginatedResponse, PasswordLoginRequest, PasswordLoginResponse, PlayUrlResponse, PopularChoice, PublicDirectorProfile, RealmConfigResponse, RealmDefinition, RealmId, RegisterMediaRequest, RegisterMediaResponse, RejectGenerationRequest, RejectGenerationResponse, SaveBookmarkRequest, SceneActionItem, SceneActionPayload, SceneMapEntry, SceneMapResponse, SceneNode, SceneTextContent, SceneVisibility, SourceUrlResponse, StateUpdate, StoryListItem, StoryPreview, StoryProgress, StoryStyleResponse, TagListResponse, TrackEngagementRequest, TranscodeRequest, TranscodeResponse, TreeGraph, TreeGraphEdge, TreeGraphNode, UpdateLocaleRequest, UpdateLocaleResponse, UpdateProfileRequest, UpdateProfileResponse, UpdateRealmRequest, UpdateRealmResponse, UpdateSceneActionRequest, UpdateSceneRequest, UpdateStoryRequest, UploadUrlRequest, UploadUrlResponse, UserProfile, UsernameAvailabilityResponse, VisibilityCondition, VisibilityRules, WatchSnapshot, computeSceneVisibility } from './types/index.js';
 export { CONTENT_RATINGS, CONTENT_RATING_IDS, DEFAULT_LOCALE, FALLBACK_LEXICON, FALLBACK_LOCALES, LOCALE_LABELS, REALMS, REALM_IDS, SUPPORTED_LOCALES, getRealmLexiconOverrides, isContentRating, isSupportedLocale, lexiconForRealm, matchAcceptLanguage, normalizeLocale, setRealmLexiconOverrides, t } from './config/index.js';
 export { RealmThemeTokens, SCENE_TREE_THEMES, SceneTreeTheme, THEME_TOKENS, getSceneTreeTheme, getThemeTokens } from './themes/index.js';
 export { ChuziApiError, ChuziClient, ChuziClientConfig, TokenResolver, createChuziClient } from './api/index.js';
 export { Direction, InputMode, Intent, IntentEvent, IntentName, IntentSource, mergeIntentSources } from './input/index.js';
 export { AtomLocation, AtomMapping, AtomState, AtomVisualProps, AudioPalette, FocusSnap, MotionTokens, RealmModule, ZoomLevel, defaultFocusSnap } from './realms/index.js';
+
+/** Playhead position where timed content is fully visible (after fade-in). */
+declare function previewMsWhenVisible(timing: {
+    appear_at_ms: number;
+    fade_in_ms: number;
+}): number;
+interface ChoiceTiming {
+    appear_at_ms: number;
+    fade_in_ms: number;
+    duration_ms: number;
+    fade_out_ms: number;
+}
+declare function resolveChoiceTiming(choice: SceneChoice, fallbackAppearMs: number): ChoiceTiming;
+/**
+ * Pick the playhead instant where the most scene content is on screen —
+ * text lines, choices, and other timed elements at full opacity.
+ */
+declare function computeScenePreviewMs(scene: SceneListItem, choices: SceneChoice[], textLines: TextLine[]): number;
+declare function isLikelyImageUrl(url: string, mediaType?: string | null): boolean;
+declare function isLikelyVideoUrl(url: string, mediaType?: string | null): boolean;
+
+export { type ChoiceTiming, SceneChoice, SceneListItem, TextLine, computeScenePreviewMs, isLikelyImageUrl, isLikelyVideoUrl, previewMsWhenVisible, resolveChoiceTiming };

package/dist/index.js

@@ -1339,6 +1339,58 @@ function defaultFocusSnap(currentId, direction, atoms) {
   return best?.id ?? null;
 }
 
-export { CONTENT_RATINGS, CONTENT_RATING_IDS, ChuziApiError, DEFAULT_LOCALE, FALLBACK_LEXICON, FALLBACK_LOCALES, Intent, LOCALE_LABELS, REALMS, REALM_IDS, SCENE_TREE_THEMES, SUPPORTED_LOCALES, THEME_TOKENS, computeSceneVisibility, createChuziClient, defaultFocusSnap, getRealmLexiconOverrides, getSceneTreeTheme, getThemeTokens, isContentRating, isSupportedLocale, lexiconForRealm, matchAcceptLanguage, mergeIntentSources, normalizeLocale, setRealmLexiconOverrides, t };
+// src/scene-preview.ts
+function previewMsWhenVisible(timing) {
+  return timing.appear_at_ms + timing.fade_in_ms;
+}
+function resolveChoiceTiming(choice, fallbackAppearMs) {
+  const appearMs = choice.start_time_seconds != null ? Math.round(choice.start_time_seconds * 1e3) : fallbackAppearMs;
+  const fadeIn = choice.fade_in_ms ?? 400;
+  const fadeOut = choice.fade_out_ms ?? 400;
+  const endMs = choice.end_time_seconds != null ? Math.round(choice.end_time_seconds * 1e3) : appearMs + fadeIn + (choice.duration_ms ?? 2e3) + fadeOut;
+  const duration = choice.duration_ms ?? Math.max(500, endMs - appearMs - fadeIn - fadeOut);
+  return {
+    appear_at_ms: appearMs,
+    fade_in_ms: fadeIn,
+    duration_ms: duration,
+    fade_out_ms: fadeOut
+  };
+}
+function lineHasVisiblePayload(line) {
+  if (line.type === "sound" || line.type === "image") {
+    return Boolean(line.media_id);
+  }
+  return line.html.replace(/<[^>]*>/g, "").trim().length > 0;
+}
+function fallbackAppearMsFromLines(lines) {
+  if (lines.length === 0) return 0;
+  const last = lines[lines.length - 1];
+  return previewMsWhenVisible(last) + last.duration_ms;
+}
+function computeScenePreviewMs(scene, choices, textLines) {
+  const fallback = fallbackAppearMsFromLines(textLines);
+  const candidates = [0];
+  for (const line of textLines) {
+    if (lineHasVisiblePayload(line)) {
+      candidates.push(previewMsWhenVisible(line));
+    }
+  }
+  for (const choice of choices) {
+    if (choice.label.trim().length > 0 || choice.target_scene_id) {
+      candidates.push(previewMsWhenVisible(resolveChoiceTiming(choice, fallback)));
+    }
+  }
+  return Math.max(...candidates);
+}
+function isLikelyImageUrl(url, mediaType) {
+  if (mediaType?.startsWith("image/")) return true;
+  return /\.(png|jpe?g|gif|webp|avif)(\?|$)/i.test(url);
+}
+function isLikelyVideoUrl(url, mediaType) {
+  if (mediaType?.startsWith("video/")) return true;
+  return /\.(mp4|webm|mov|m3u8)(\?|$)/i.test(url);
+}
+
+export { CONTENT_RATINGS, CONTENT_RATING_IDS, ChuziApiError, DEFAULT_LOCALE, FALLBACK_LEXICON, FALLBACK_LOCALES, Intent, LOCALE_LABELS, REALMS, REALM_IDS, SCENE_TREE_THEMES, SUPPORTED_LOCALES, THEME_TOKENS, computeScenePreviewMs, computeSceneVisibility, createChuziClient, defaultFocusSnap, getRealmLexiconOverrides, getSceneTreeTheme, getThemeTokens, isContentRating, isLikelyImageUrl, isLikelyVideoUrl, isSupportedLocale, lexiconForRealm, matchAcceptLanguage, mergeIntentSources, normalizeLocale, previewMsWhenVisible, resolveChoiceTiming, setRealmLexiconOverrides, t };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map