@rslsp1/fa-app-tools 10.1.3 → 10.3.3

package/dist/szenen.mjs

@@ -1,5 +1,6 @@
 import {
   ALL_PUBLISH_RULES,
+  CAMERA_PREVIEW_ASSET_ROLE,
   CATALOGUE_TYPES,
   CHAIN_EDGES,
   CHAIN_LINK_FIELDS,
@@ -16,17 +17,22 @@ import {
   MANUAL_PROVIDER,
   MANUAL_VISIBILITY_BASIS,
   MAX_PROPOSAL_TITLE_LENGTH,
+  MCP_CLIENT_PROVIDER,
+  NODE_TYPES,
   PAUSE_SEKUNDEN_OPTIONEN,
   PAUSE_SEKUNDEN_VORGABE,
   PROBE_VERSION_ID,
   PROMPT_AUSZUG_ZEICHEN,
   PROMPT_RULE_EFFECT,
   PROMPT_RUN_DETAIL_FIELDS,
+  PROXY_PRIMITIVES,
   REFERENCE_FIELD,
   RULES_WITHOUT_CAPABILITY_EFFECT,
   RULE_SCOPES,
   ResolveTechnicalError,
   SIMULATION_PROVIDER,
+  STAGE_MIGRATION_EVENT,
+  STAGE_MIGRATION_ID,
   SZENEN_ELEMENT_TYPES,
   SZENEN_EVENT_PREFIX,
   SZENEN_EVENT_TYPES,
@@ -37,18 +43,23 @@ import {
   SZENEN_SNAPSHOT_SCHEMA_VERSION,
   SzenenView,
   UNCHECKED_PUBLISH_RULES,
+  UNVERIFIED_MODEL_ID,
   UPLOAD_MAX_BYTES,
   UnsupportedSchemaError,
   acceptProposalTitle,
   annotateElementsFromEvents,
   annotateRunsFromEvents,
+  annotatedElementsPageOver,
+  applyStageOperations,
   areaForFokus,
   areasFor,
   assessDerivationResponse,
   batchesForPromptRun,
   bildPfad,
   bilderDesLaufs,
+  buildCameraPreviewContext,
   buildManualPromptRunRecord,
+  buildPromptRunVariantRecord,
   buildSystemInstruction,
   buildSystemInstruction2,
   buildSzenenSnapshot,
@@ -78,17 +89,21 @@ import {
   checkSetPreferredHeadInput,
   checkSzenenBatchOrigin,
   checkTitle,
+  checkVariantBlock,
+  checkVariantInputAssets,
   checkWriteDraftInput,
   claimWon,
   collectImageBatches,
   collectImageGenerationOrders,
   collectImageJobs,
+  collectPromptOperations,
   collectPromptRunTags,
   collectPromptRuns,
   collectSceneDerivationRecoveries,
   collectSceneDerivations,
   collectVersionRefs,
   compileSchemas,
+  completePromptOperation,
   contextOfRun,
   createClientDerivationPort,
   createClientRunPort,
@@ -118,14 +133,18 @@ import {
   diagnosticOfFinding,
   diagnosticOfSchemaError,
   draftRevisionOf,
+  effectivePromptVocabulary,
+  elementsByActivity,
   executableImageModels,
   findExecutableImageModel,
   findImageBatch,
   findImageGenerationOrder,
   findImageJob,
+  findPromptOperation,
   findPromptRun,
   findSceneDerivation,
   findSceneDerivationRecovery,
+  findStageDraftChain,
   firstError,
   formatSchemaErrors,
   formatSeedListe,
@@ -167,6 +186,7 @@ import {
   mitDefaultVorlage,
   namingElementOf,
   noticeFor,
+  openStageDraftChain,
   ordersForPromptRun,
   ordneSeedsZu,
   pageOf,
@@ -176,30 +196,42 @@ import {
   parseRunResponse,
   parseSeedListe,
   parseSzenenSnapshot,
+  pinPreviewColors,
   preferredHeadRevisionOf,
+  preparePromptDerivation,
+  preparePromptOperation,
+  prepareStageMigration,
+  previewColorNodes,
   promptDiagnosticsOf,
   promptRunPageForTransport,
   promptRunPageFromTransport,
   promptRunTagsOf,
+  promptTagGroup,
   publishedHeadsOf,
   recoveriesForRun,
   recoveryStatusOf,
   reduceElementEvents,
   resolveArea,
   resolveGeneralScenePolicies,
+  resolvePromptConstructionTags,
   resolveScenePayload,
   resolveShot,
   resolveShotPayload,
   resolveTargetModelOver,
   resolverFromQueries,
+  responseContractOf,
   roundOfRun,
   roundsOf,
   rulesWithoutPromptEffect,
+  runOfOperation,
   runPromptDerivation,
   runPublishChecks,
   runSceneDerivation,
+  sameResponseAs,
+  sameVariantRequest,
   sceneOnlyCapabilities,
   scenePolicyFingerprint,
+  sceneVersionElementsOf,
   scopeOfPath,
   seedFehlerText,
   selectImageJobs,
@@ -210,6 +242,7 @@ import {
   simulatedAnswerFor,
   sortScenePolicies,
   sourceOf,
+  supportsCompositionReference,
   szenenSnapshotFilename,
   tagRefsAus,
   typAusBytes,
@@ -219,21 +252,39 @@ import {
   validateDerivationInput,
   validateElementVersion,
   validatePayload,
+  variantOf,
   withReference
-} from "./chunk-5SYVLULG.mjs";
+} from "./chunk-XLNA2BD6.mjs";
 import {
   ContractViolation,
   STYLE_PAYLOAD,
   STYLE_PAYLOAD_V2,
   elementStoreContractChecks,
   runElementStoreContract
-} from "./chunk-C5CGSPP3.mjs";
+} from "./chunk-RFTANBQ5.mjs";
 import {
   VersionDagError,
   buildVersionDag,
   preferredVersionId,
   resolvePreferredHead
 } from "./chunk-FUY2OCVC.mjs";
+import {
+  CAMERA_ASPECT_RATIOS,
+  PREVIEW_COLOR_MIN_DISTANCE,
+  STAGE_CATALOGUE,
+  cameraAspectRatioValue,
+  cameraPerspective,
+  checkCameraAspectRatioChanges,
+  dragPosition,
+  frozenCameraAspectRatio,
+  normalizePreviewColor,
+  previewColorConflicts,
+  previewColorDistance,
+  previewColorLegibility,
+  stageColors,
+  stageFrame,
+  stageNode
+} from "./chunk-GKLCL2VQ.mjs";
 
 // src/lib/szenen/providerCheckStore.ts
 function collectProviderChecks(events) {
@@ -552,7 +603,8 @@ function simulierteRekonstruktion(input, runId) {
 }
 function createMemoryViewPort(options = {}) {
   const ids = options.ids ?? defaultIds;
-  const elements = createHfElementStore({ channel: createInMemoryEventChannel() });
+  const elementChannel = createInMemoryEventChannel();
+  const elements = createHfElementStore({ channel: elementChannel });
   const laeufe = [...options.runs ?? []];
   const laufTags = new Map(
     Object.entries(options.runTags ?? {}).map(
@@ -629,6 +681,7 @@ function createMemoryViewPort(options = {}) {
       );
       const lauf = {
         ...basis,
+        input_payload: { ...basis.input_payload, scene: { ...basis.input_payload.scene, element_id: input.sceneElementId, version_id: "" } },
         shot_version_id: "",
         shot_element_id: "",
         scene_setup_version_id: "",
@@ -664,7 +717,7 @@ function createMemoryViewPort(options = {}) {
           version_id: null
         },
         input: {
-          scene: { nodes: [] }
+          scene: { element_id: input.sceneElementId, version_id: "", nodes: [] }
         },
         promptText: input.promptText,
         note: input.note ?? null,
@@ -707,6 +760,7 @@ function createMemoryViewPort(options = {}) {
       try {
         return ok(pagePromptRuns(laeufe, {
           ...input,
+          sceneVersionElements: sceneVersionElementsOf(reduceElementEvents(await elementChannel.readEvents())),
           tags: input.tags ?? laufTags,
           ...annotationen.size > 0 && !input.annotations ? { annotations: annotationen } : {}
         }));
@@ -773,6 +827,16 @@ function createMemoryViewPort(options = {}) {
       return done({ removed: rest.length !== vorhanden.length });
     }
   };
+  const assetVorschauen = options.assetPreviews;
+  if (assetVorschauen) {
+    mediaPort.loadAssetPreview = async (assetId) => {
+      const quelle = assetVorschauen[assetId];
+      if (quelle === void 0) {
+        return { kind: "error", message: `Medien-Asset ${assetId} ist unbekannt.`, retryable: false };
+      }
+      return ok(quelle);
+    };
+  }
   const rekonstruktionen = [];
   const fassungen = [];
   const uebernommen = /* @__PURE__ */ new Map();
@@ -1120,14 +1184,25 @@ function createMemoryViewPort(options = {}) {
   const elementeMitAnnotationen = options.elementAnnotations ? {
     ...elements,
     async listElementsPage(filter, page) {
-      const seite = await listElementsPageOver((f) => elements.listElements(f), filter, page);
-      if (seite.kind !== "ok") return seite;
+      const vorbelegt = options.elementAnnotations;
+      const alle = await elements.listElements(filter);
+      if (alle.kind !== "ok") return alle;
+      let seite;
+      try {
+        seite = pageOf(
+          elementsByActivity(alle.value, (e) => vorbelegt[e.element_id]?.lastActivityAt ?? null),
+          (e) => e.element_id,
+          page ?? null
+        );
+      } catch (error) {
+        return { kind: "error", message: error.message, retryable: false };
+      }
       const annotations = {};
-      for (const element of seite.value.items) {
-        const annotation = options.elementAnnotations[element.element_id];
+      for (const element of seite.items) {
+        const annotation = vorbelegt[element.element_id];
         if (annotation) annotations[element.element_id] = annotation;
       }
-      return ok({ ...seite.value, annotations });
+      return ok({ ...seite, annotations });
     }
   } : elements;
   const port = {
@@ -1488,10 +1563,23 @@ function checkPromptRunRecord(candidate) {
   }
   const handeingabe = pruefeHandeingabe(record);
   if (!handeingabe.ok) return handeingabe;
+  const variante = checkVariantBlock(record);
+  if (!variante.ok) return variante;
   const eingabe = record.input_payload;
   if (eingabe === null || typeof eingabe !== "object") {
     return { ok: false, message: '"input_payload" fehlt \u2014 ohne sie ist der Lauf nicht pruefbar.' };
   }
+  if (record.camera_preview !== void 0) {
+    const preview = record.camera_preview;
+    const camera = eingabe.camera;
+    if (!preview || preview.mime_type !== "image/png" || !/^[a-f0-9]{64}$/.test(preview.sha256) || !Number.isInteger(preview.width) || !Number.isInteger(preview.height) || preview.width <= 0 || preview.height <= 0 || preview.width > 2048 || preview.height > 2048 || !camera?.aspect_ratio || preview.camera_id !== camera.camera_id) {
+      return { ok: false, message: "Das Kamera-Preview hat keinen g\xFCltigen Bezug zum eingefrorenen Kamerastand." };
+    }
+    const [width, height] = camera.aspect_ratio.split(":").map(Number);
+    if (!Number.isFinite(width / height) || Math.abs(preview.width / preview.height - width / height) > 1e-9) {
+      return { ok: false, message: "Preview-Abmessungen und eingefrorenes Kameraformat widersprechen sich." };
+    }
+  }
   if (record.status === "failed") {
     if (record.output !== null && record.output !== void 0) {
       return {
@@ -1844,123 +1932,10 @@ function checkSceneDerivationRecoveryRecord(candidate) {
   }
   return { ok: true };
 }
-
-// src/lib/szenen/scenePromptOperation.ts
-var MCP_CLIENT_PROVIDER = "mcp_client";
-var UNVERIFIED_MODEL_ID = "mcp-client-unspecified";
-var istText2 = (wert) => typeof wert === "string" && wert.trim().length > 0;
-function collectPromptOperations(events) {
-  const nachId = /* @__PURE__ */ new Map();
-  for (const event of events) {
-    if (event.type !== SZENEN_EVENT_TYPES.promptOperationPrepared) continue;
-    const payload = event.payload;
-    if (!payload || !istText2(payload.operation_id)) continue;
-    if (nachId.has(payload.operation_id)) continue;
-    nachId.set(payload.operation_id, payload);
-  }
-  return [...nachId.values()];
-}
-function findPromptOperation(events, operationId) {
-  return collectPromptOperations(events).find((v) => v.operation_id === operationId) ?? null;
-}
-async function preparePromptOperation(input) {
-  const now = input.now ?? (() => /* @__PURE__ */ new Date());
-  const eingefroren = await freezeSceneWorkingState({
-    sceneElementId: input.sceneElementId,
-    store: input.store,
-    resolver: input.resolver,
-    contextChain: input.contextChain,
-    userInstruction: input.userInstruction ?? null,
-    targetModelElementId: input.targetModelElementId ?? null
-  });
-  if (eingefroren.kind !== "ok") return eingefroren;
-  const rendererInput = eingefroren.input;
-  return {
-    kind: "ok",
-    operation: {
-      operation_id: input.operationId,
-      scene: eingefroren.scene,
-      context_id: input.contextId,
-      user_instruction: input.userInstruction ?? null,
-      renderer_input: rendererInput,
-      renderer_instruction: buildSystemInstruction2(rendererInput),
-      renderer_payload: buildUserPrompt2(rendererInput),
-      response_contract: responseContractOf(rendererInput),
-      prepared_by: input.preparedBy,
-      created_at: now().toISOString()
-    }
-  };
-}
-function responseContractOf(input) {
-  const model = input.target_model ?? {};
-  return {
-    format: "json",
-    required_fields: ["positive", "negative", "feedback", "visibility", "notes"],
-    negative_prompt_allowed: model.supports_negative_prompt === true,
-    node_ids: input.scene.nodes.map((node) => node.node_id),
-    prompt_language: typeof model.prompt_language === "string" ? model.prompt_language : "en"
-  };
-}
-function completePromptOperation(input) {
-  const now = input.now ?? (() => /* @__PURE__ */ new Date());
-  const { operation } = input;
-  const geparst = parseRunResponse(input.response);
-  if (!geparst.ok) {
-    return {
-      kind: "rejected",
-      message: `Die Antwort zu Vorgang ${operation.operation_id} ist nicht verwertbar: ${geparst.message}`
-    };
-  }
-  const geprueft = checkRunResponse(geparst.value, operation.renderer_input);
-  if (!geprueft.ok) {
-    return {
-      kind: "rejected",
-      message: `Die Antwort zu Vorgang ${operation.operation_id} passt nicht zur eingefrorenen Eingabe: ${geprueft.message}`
-    };
-  }
-  const origin = {
-    host: "mcp",
-    ...istText2(input.declaredModelId) ? { declared_model_id: input.declaredModelId } : {},
-    renderer_instruction_was_system_prompt: false
-  };
-  return {
-    kind: "ok",
-    record: {
-      run_id: input.runId,
-      // Keine fingierten Kennungen (D-98/D-75) — genau wie beim
-      // Szene-Direktlauf des bestehenden Pfads.
-      shot_version_id: "",
-      shot_element_id: "",
-      scene_setup_version_id: "",
-      camera_id: "",
-      target_model_version_id: operation.renderer_input.target_model_resolution?.version_id ?? "",
-      provider: MCP_CLIENT_PROVIDER,
-      model_id: UNVERIFIED_MODEL_ID,
-      // Die Renderer-Anweisung, wie sie der Vorgang eingefroren hat — nicht
-      // eine zweite, jetzt neu gebaute Fassung.
-      system_prompt: operation.renderer_instruction,
-      input_payload: operation.renderer_input,
-      status: "succeeded",
-      failure: null,
-      output: geprueft.output,
-      raw_output: input.response,
-      source: { kind: "scene_direct", scene: operation.scene },
-      operation_id: operation.operation_id,
-      execution_origin: origin,
-      created_at: now().toISOString()
-    }
-  };
-}
-function runOfOperation(runs, operationId) {
-  return runs.find(
-    (run) => run.operation_id === operationId
-  ) ?? null;
-}
-function sameResponseAs(run, response) {
-  return (run.raw_output ?? "") === response;
-}
 export {
   ALL_PUBLISH_RULES,
+  CAMERA_ASPECT_RATIOS,
+  CAMERA_PREVIEW_ASSET_ROLE,
   CATALOGUE_TYPES,
   CHAIN_EDGES,
   CHAIN_LINK_FIELDS,
@@ -1978,17 +1953,23 @@ export {
   MANUAL_PROVIDER,
   MANUAL_VISIBILITY_BASIS,
   MCP_CLIENT_PROVIDER,
+  NODE_TYPES,
   PAUSE_SEKUNDEN_OPTIONEN,
   PAUSE_SEKUNDEN_VORGABE,
+  PREVIEW_COLOR_MIN_DISTANCE,
   PROBE_VERSION_ID,
   PROMPT_AUSZUG_ZEICHEN,
   PROMPT_RULE_EFFECT,
   PROMPT_RUN_DETAIL_FIELDS,
+  PROXY_PRIMITIVES,
   REFERENCE_FIELD,
   RULES_WITHOUT_CAPABILITY_EFFECT,
   RULE_SCOPES,
   ResolveTechnicalError,
   SIMULATION_PROVIDER,
+  STAGE_CATALOGUE,
+  STAGE_MIGRATION_EVENT,
+  STAGE_MIGRATION_ID,
   STYLE_PAYLOAD,
   STYLE_PAYLOAD_V2,
   SZENEN_ELEMENT_TYPES,
@@ -2007,24 +1988,31 @@ export {
   VersionDagError,
   annotateElementsFromEvents,
   annotateRunsFromEvents,
+  annotatedElementsPageOver,
+  applyStageOperations,
   areaForFokus,
   areasFor,
   assessDerivationResponse,
   batchesForPromptRun,
   bildPfad,
   bilderDesLaufs,
-  buildSystemInstruction as buildDerivationSystemInstruction,
-  buildUserPrompt as buildDerivationUserPrompt,
+  buildCameraPreviewContext,
+  buildSystemInstruction2 as buildDerivationSystemInstruction,
+  buildUserPrompt2 as buildDerivationUserPrompt,
   buildManualPromptRunRecord,
-  buildSystemInstruction2 as buildSystemInstruction,
+  buildPromptRunVariantRecord,
+  buildSystemInstruction,
   buildSzenenSnapshot,
-  buildUserPrompt2 as buildUserPrompt,
+  buildUserPrompt,
   buildVersionDag,
   callOptional,
+  cameraAspectRatioValue,
+  cameraPerspective,
   capabilitiesOf,
   capabilityGate,
   capabilityReport,
   catalogueFor,
+  checkCameraAspectRatioChanges,
   checkChainTargets,
   checkCreateElementInput,
   checkDerivationResponse,
@@ -2047,6 +2035,8 @@ export {
   checkSetPreferredHeadInput,
   checkSzenenBatchOrigin,
   checkTitle,
+  checkVariantBlock,
+  checkVariantInputAssets,
   checkWriteDraftInput,
   claimWon,
   collectImageBatches,
@@ -2094,7 +2084,10 @@ export {
   diagnosticOfSchemaError,
   differentialSteps,
   draftRevisionOf,
+  dragPosition,
+  effectivePromptVocabulary,
   elementStoreContractChecks,
+  elementsByActivity,
   executableImageModels,
   findExecutableImageModel,
   findImageBatch,
@@ -2105,11 +2098,13 @@ export {
   findProviderCheck,
   findSceneDerivation,
   findSceneDerivationRecovery,
+  findStageDraftChain,
   firstError,
   formatSchemaErrors,
   formatSeedListe,
   freezeDraftChain,
   freezeSceneWorkingState,
+  frozenCameraAspectRatio,
   fuehreQueueAus,
   generationBatchIdOf,
   gesamtHerkunft,
@@ -2145,7 +2140,9 @@ export {
   mimeTypAus,
   mitDefaultVorlage,
   namingElementOf,
+  normalizePreviewColor,
   noticeFor,
+  openStageDraftChain,
   ordersForPromptRun,
   ordneSeedsZu,
   pageOf,
@@ -2155,13 +2152,21 @@ export {
   parseRunResponse,
   parseSeedListe,
   parseSzenenSnapshot,
+  pinPreviewColors,
   preferredHeadRevisionOf,
   preferredVersionId,
+  preparePromptDerivation,
   preparePromptOperation,
+  prepareStageMigration,
+  previewColorConflicts,
+  previewColorDistance,
+  previewColorLegibility,
+  previewColorNodes,
   promptDiagnosticsOf,
   promptRunPageForTransport,
   promptRunPageFromTransport,
   promptRunTagsOf,
+  promptTagGroup,
   publishedHeadsOf,
   recoveriesForRun,
   recoveryStatusOf,
@@ -2169,6 +2174,7 @@ export {
   resolveArea,
   resolveGeneralScenePolicies,
   resolvePreferredHead,
+  resolvePromptConstructionTags,
   resolveScenePayload,
   resolveShot,
   resolveShotPayload,
@@ -2185,8 +2191,10 @@ export {
   runSceneDerivation,
   runStoreDifferential,
   sameResponseAs,
+  sameVariantRequest,
   sceneOnlyCapabilities,
   scenePolicyFingerprint,
+  sceneVersionElementsOf,
   scopeOfPath,
   seedFehlerText,
   selectImageJobs,
@@ -2197,6 +2205,10 @@ export {
   simulatedAnswerFor,
   sortScenePolicies,
   sourceOf,
+  stageColors,
+  stageFrame,
+  stageNode,
+  supportsCompositionReference,
   szenenSnapshotFilename,
   tagRefsAus,
   totalModelCalls,
@@ -2207,5 +2219,6 @@ export {
   validateDerivationInput,
   validateElementVersion,
   validatePayload,
+  variantOf,
   withReference
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rslsp1/fa-app-tools",
-  "version": "10.1.3",
+  "version": "10.3.3",
   "description": "Shared tools and hooks for Fine Art flow apps",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -33,11 +33,12 @@
     "mutation:runintegrity": "stryker run stryker.runintegrity.conf.mjs"
   },
   "peerDependencies": {
-    "react": ">=18"
+    "react": "^18.2.0 || ^19.0.0"
   },
   "dependencies": {
     "@huggingface/hub": "^2.13.0",
     "jszip": "^3.10.1",
+    "three": "^0.186.1",
     "zustand": "^5.0.14"
   },
   "devDependencies": {
@@ -46,6 +47,7 @@
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.0.0",
+    "@types/three": "^0.186.0",
     "@vitest/coverage-v8": "2.1.9",
     "@xyflow/react": "^12.10.2",
     "jsdom": "^29.1.1",