@pixel-point/toolcraft 0.0.17 → 0.0.19

package/templates/starter/src/app/acceptance/types.ts

@@ -1,7 +1,7 @@
 import type {
   ToolcraftBuiltInControlType as RuntimeToolcraftBuiltInControlType,
   ToolcraftControlOrderRole,
-  ToolcraftControlSchema,
+  ResolvedToolcraftControlSchema,
   ToolcraftPersistableStateSlice,
 } from "@repo/toolcraft-runtime";
 import { TOOLCRAFT_BUILT_IN_CONTROL_TYPES } from "@repo/toolcraft-runtime";
@@ -12,11 +12,13 @@ import type {
 } from "./canvas-coverage";
 import type { ToolcraftModelImportCoverage } from "./model-import-coverage";
 import type { ToolcraftInteractionOwnershipEntry } from "./interaction-ownership-intent";
+import type { ToolcraftMotionReferenceCoverage } from "./reference-study-types";
 import type {
-  ToolcraftReferenceFeatureInventoryItem,
-  ToolcraftReferenceStudyEvidence,
-  ToolcraftVideoReferenceStudyEvidence,
-} from "./reference-study-types";
+  ToolcraftReferenceCoverage,
+  ToolcraftReferenceTimelineCoverage,
+  ToolcraftTimelineLoopProof,
+  ToolcraftTimelinePlaybackCoverage,
+} from "./transfer-mode-types";
 import type { ToolcraftViewInteractionIntent } from "./view-interaction-intent";
 
 export { TOOLCRAFT_REQUIRED_MODEL_IMPORT_COVERAGE } from "./model-import-coverage";
@@ -38,15 +40,38 @@ export type {
   ToolcraftViewInteractionIntent,
 } from "./view-interaction-intent";
 export type {
+  ToolcraftMotionReferenceBehavior,
+  ToolcraftMotionReferenceCoverage,
+  ToolcraftMotionReferenceEvent,
+  ToolcraftMotionReferenceEvidence,
+  ToolcraftMotionReferenceEvidenceEvent,
+  ToolcraftMotionReferenceInput,
+  ToolcraftMotionReferenceOrdinalFrame,
+  ToolcraftMotionReferencePhase,
+  ToolcraftMotionReferenceSourceKind,
+  ToolcraftMotionReferenceStudy,
+  ToolcraftMotionReferenceTimedFrame,
+  ToolcraftMotionReferenceTimingClaim,
+  ToolcraftMotionReferenceTimingMode,
   ToolcraftReferenceFeatureInventoryItem,
   ToolcraftReferenceFeatureStatus,
+  ToolcraftReferenceInput,
   ToolcraftReferenceStudyEvidence,
   ToolcraftReferenceStudyStatus,
-  ToolcraftVideoReferenceAcceptanceMapping,
-  ToolcraftVideoReferenceStoryboardFrame,
-  ToolcraftVideoReferenceStudyEvidence,
-  ToolcraftVideoReferenceTransition,
 } from "./reference-study-types";
+export type {
+  ToolcraftAnimationIntent,
+  ToolcraftAutonomousAnimationCoverage,
+  ToolcraftReferenceCoverage,
+  ToolcraftReferenceTimelineContract,
+  ToolcraftReferenceTimelineCoverage,
+  ToolcraftReferenceTimelineMode,
+  ToolcraftTimelineLoopDurationIntent,
+  ToolcraftTimelineLoopDurationSource,
+  ToolcraftTimelineLoopProof,
+  ToolcraftTimelinePlaybackCoverage,
+  ToolcraftTransferMode,
+} from "./transfer-mode-types";
 
 export type ToolcraftAcceptanceEvidence =
   | "command-side-effect"
@@ -60,50 +85,13 @@ export type ToolcraftAcceptanceEvidence =
 
 export type ToolcraftExportArtifactCoverage =
   | "all-required-image-export-behavior"
+  | "all-required-svg-export-behavior"
   | "all-required-video-export-behavior";
 
-export type ToolcraftReferenceCoverage =
-  | "canvas-sizing"
-  | "control-mapping"
-  | "export-at-time"
-  | "export-copy"
-  | "media-lifecycle"
-  | "pause-resume"
-  | "renderer-loop"
-  | "renderer-state"
-  | "restart"
-  | "spawn-update-cadence"
-  | "time-progress";
-
-export type ToolcraftReferenceTimelineCoverage =
-  | "all-range"
-  | "duration"
-  | "export-at-time"
-  | "export-range"
-  | "jump-to-trim-start"
-  | "keyframes"
-  | "loop"
-  | "playback"
-  | "range-playback"
-  | "restart"
-  | "scrub"
-  | "state-jump"
-  | "time-progress"
-  | "trim-range";
-
-export type ToolcraftTimelinePlaybackCoverage =
-  | "duration"
-  | "loop"
-  | "pause-resume"
-  | "rendered-frame"
-  | "scrub";
-
 export type ToolcraftPersistenceCoverage = "reload";
 
 export type ToolcraftSettingsTransferCoverage = "opt-out";
 
-export type ToolcraftConditionalVisibilityCoverage = "hidden" | "visible";
-
 export type ToolcraftOrientationGizmoCoverage =
   | "axis-drag"
   | "axis-snap"
@@ -131,62 +119,6 @@ export type ToolcraftMediaLifecycleCoverage =
   | "transform-output"
   | "upload";
 
-export type ToolcraftAutonomousAnimationCoverage =
-  | "no-duration-control"
-  | "no-export-at-time"
-  | "no-loop-control"
-  | "no-play-pause"
-  | "no-scrub"
-  | "no-user-facing-transport";
-
-export type ToolcraftTimelineLoopDurationSource =
-  | "product-derived"
-  | "reference"
-  | "user-request";
-
-export type ToolcraftTimelineLoopDurationIntent = {
-  evidence: string;
-  seconds: number;
-  source: ToolcraftTimelineLoopDurationSource;
-};
-
-export type ToolcraftTimelineLoopProof = {
-  direction: "forward-only";
-  durationChange: "reproved-after-edit";
-  reversePlayback: "forbidden";
-  seam: "first-last-match";
-};
-
-export type ToolcraftAnimationIntent =
-  | {
-      mode: "none";
-    }
-  | {
-      behaviorCoverage: readonly ToolcraftAutonomousAnimationCoverage[];
-      mode: "autonomous";
-      reason: string;
-    }
-  | {
-      loopDuration: ToolcraftTimelineLoopDurationIntent;
-      mode: "timeline-keyframes";
-    }
-  | {
-      loopDuration: ToolcraftTimelineLoopDurationIntent;
-      mode: "timeline-playback";
-    };
-
-export type ToolcraftReferenceTimelineMode =
-  | "custom-reference-timeline"
-  | "none"
-  | "toolcraft-keyframes"
-  | "toolcraft-playback";
-
-export type ToolcraftReferenceTimelineContract = {
-  behaviorCoverage: readonly ToolcraftReferenceTimelineCoverage[];
-  loopDuration?: ToolcraftTimelineLoopDurationIntent;
-  mode: ToolcraftReferenceTimelineMode;
-};
-
 export type ToolcraftLayerCoverage =
   | "grouping"
   | "media-lifecycle"
@@ -195,10 +127,15 @@ export type ToolcraftLayerCoverage =
   | "selection"
   | "visibility";
 
+export type ToolcraftSelectionScopeCoverage = "two-entity-isolation";
+
 export type ToolcraftControlPartCoverage =
   | "anchorGrid.position"
   | "channelMixer.activeChannel"
   | "channelMixer.values"
+  | "collectionActions.add"
+  | "collectionActions.items"
+  | "collectionActions.remove"
   | "curves.activeChannel"
   | "curves.points"
   | "colorOpacity.hex"
@@ -222,6 +159,7 @@ export type ToolcraftControlPartCoverage =
   | "rangeInput.start"
   | "rangeSlider.lower"
   | "rangeSlider.upper"
+  | "sourceCollection.items"
   | "vector.x"
   | "vector.y";
 
@@ -254,23 +192,24 @@ export type ToolcraftCustomControlCapability =
   | "reorder"
   | "selection";
 
-export type ToolcraftTransferMode =
-  | {
-      animationIntent?: ToolcraftAnimationIntent;
-      mode: "new-toolcraft-app";
-      videoReferenceStudy?: ToolcraftVideoReferenceStudyEvidence;
-    }
-  | {
-      animationIntent?: ToolcraftAnimationIntent;
-      behaviorCoverage: readonly ToolcraftReferenceCoverage[];
-      mode: "reference-runtime-clone";
-      referenceFeatureInventory?: readonly ToolcraftReferenceFeatureInventoryItem[];
-      referenceName: string;
-      referenceStudy?: ToolcraftReferenceStudyEvidence;
-      referenceTimeline: ToolcraftReferenceTimelineContract;
-      sourceOfTruth: "reference-runtime";
-      videoReferenceStudy?: ToolcraftVideoReferenceStudyEvidence;
-    };
+export type ToolcraftImageExportIntent =
+  | Readonly<{ mode: "toolcraft-default" }>
+  | Readonly<{ evidence: string; mode: "user-requested" }>
+  | Readonly<{ evidence: string; mode: "user-removed" }>;
+
+export type ToolcraftVideoExportIntent =
+  | Readonly<{ mode: "not-requested" }>
+  | Readonly<{ evidence: string; mode: "user-requested" }>;
+
+export type ToolcraftSvgExportIntent =
+  | Readonly<{ mode: "not-requested" }>
+  | Readonly<{ evidence: string; mode: "user-requested" }>;
+
+export type ToolcraftArtifactExportIntent = Readonly<{
+  image: ToolcraftImageExportIntent;
+  svg: ToolcraftSvgExportIntent;
+  video: ToolcraftVideoExportIntent;
+}>;
 
 export type ToolcraftProductReadiness =
   | {
@@ -278,6 +217,7 @@ export type ToolcraftProductReadiness =
       reason: string;
     }
   | {
+      exportIntent: ToolcraftArtifactExportIntent;
       mode: "product";
       interactionOwnership: readonly ToolcraftInteractionOwnershipEntry[];
       productName: string;
@@ -315,6 +255,7 @@ export type ToolcraftComponentAcceptance = {
   modelImportCoverage?:
     | "all-required-model-import-behavior"
     | readonly ToolcraftModelImportCoverage[];
+  motionReferenceCoverage?: readonly ToolcraftMotionReferenceCoverage[];
   optionCoverage?: "each-visible-item" | readonly string[];
   orientationGizmoCoverage?:
     | "all-required-orientation-gizmo-behavior"
@@ -325,6 +266,7 @@ export type ToolcraftComponentAcceptance = {
   referenceTimelineCoverage?: ToolcraftReferenceTimelineCoverage;
   renderScaleCoverage?: ToolcraftRenderScaleCoverage;
   settingsTransferCoverage?: ToolcraftSettingsTransferCoverage;
+  selectionScopeCoverage?: ToolcraftSelectionScopeCoverage;
   target?: string;
   timelineCoverage?: "keyframes" | "playback";
   timelinePlaybackCoverage?:
@@ -342,13 +284,10 @@ export type ToolcraftComponentAcceptance = {
     | "all-required-background-output"
     | readonly ToolcraftBackgroundOutputCoverage[];
   userAction: string;
-  visibilityCoverage?:
-    | "all-conditional-visibility"
-    | readonly ToolcraftConditionalVisibilityCoverage[];
 };
 
 export type ToolcraftVisibleControl = {
-  control: ToolcraftControlSchema;
+  control: ResolvedToolcraftControlSchema;
   controlId: string;
   sectionTitle?: string;
 };
@@ -363,7 +302,8 @@ export type ToolcraftControlOrderItem = {
 };
 
 export type ToolcraftControlSectionInventoryEntry = {
-  entity?: string;
+  entity: string;
+  entityId: string;
   groupingReason: string;
   id: string;
   splitReason?: string;

package/templates/starter/src/app/acceptance/validate-coverage.ts

@@ -5,11 +5,13 @@ import {
   getToolcraftAnimationModeChoiceErrors,
 } from "./animation-intent";
 import { getToolcraftControlAcceptanceErrors } from "./control-acceptance";
+import { getToolcraftControlApplicabilityErrors } from "./control-applicability";
 import {
   getToolcraftControlSectionHeuristicErrors,
   getToolcraftControlSectionInvariantErrors,
 } from "./control-layout";
 import { getToolcraftControlOrderErrors } from "./control-order";
+import { getToolcraftControlSectionEntityCohesionErrors } from "./control-section-entity-cohesion";
 import { getToolcraftControlSectionInventoryErrors } from "./control-section-inventory";
 import { isToolcraftVisibleAcceptanceControl } from "./controls";
 import { getToolcraftInlineLayoutErrors } from "./inline-layout";
@@ -19,8 +21,10 @@ import {
   schemaHasVideoExportPanelAction,
 } from "./output-export";
 import { getToolcraftOrientationGizmoErrors } from "./orientation-gizmo";
+import { getToolcraftMotionReferenceStudyErrors } from "./motion-reference-study";
 import { getToolcraftReferenceRuntimeCloneErrors } from "./reference-runtime";
 import { getToolcraftRenderScaleCoverageErrors } from "./render-scale";
+import { getToolcraftSelectionScopeErrors } from "./selection-scope";
 import {
   getToolcraftCanvasSizingCoverageErrors,
   getToolcraftLayerCoverageErrors,
@@ -44,7 +48,6 @@ import {
   type ToolcraftAcceptanceValidationContext,
   type ToolcraftAcceptanceValidator,
 } from "./validation-pipeline";
-import { getToolcraftVideoReferenceStudyErrors } from "./video-reference-study";
 import { getToolcraftViewInteractionErrors } from "./view-interaction";
 
 export type ToolcraftAcceptanceValidationInput = {
@@ -110,6 +113,16 @@ const toolcraftAcceptanceValidators: readonly ToolcraftAcceptanceValidator[] = [
         productReadiness,
       }),
   },
+  {
+    path: "starterProductReadiness.interactionOwnership[].selectionScope",
+    ruleId: "interaction-surface-ownership",
+    validate: ({ acceptance, layersEnabled, productReadiness }) =>
+      getToolcraftSelectionScopeErrors({
+        acceptance,
+        layersEnabled,
+        productReadiness,
+      }),
+  },
   {
     path: "starterProductReadiness.viewInteraction",
     ruleId: "renderer-view-interaction",
@@ -146,12 +159,27 @@ const toolcraftAcceptanceValidators: readonly ToolcraftAcceptanceValidator[] = [
     ruleId: "controls-product-coverage",
     validate: ({ schema }) => getToolcraftOrientationGizmoErrors(schema),
   },
+  {
+    path: "schema.panels.controls.sections[].controls[].applicability",
+    ruleId: "controls-product-coverage",
+    validate: ({ controls, productReadiness }) =>
+      getToolcraftControlApplicabilityErrors({
+        controls,
+        productReadiness,
+      }),
+  },
   {
     path: "starterControlSectionInventory",
     ruleId: "controls-section-inventory-required",
     validate: ({ schema, sectionInventory }) =>
       getToolcraftControlSectionInventoryErrors(schema, sectionInventory),
   },
+  {
+    path: "starterControlSectionInventory",
+    ruleId: "controls-section-inventory-required",
+    validate: ({ sectionInventory }) =>
+      getToolcraftControlSectionEntityCohesionErrors(sectionInventory),
+  },
   {
     path: "schema.panels.controls.sections[].layoutGroups",
     ruleId: "controls-component-layout-invariants",
@@ -160,18 +188,18 @@ const toolcraftAcceptanceValidators: readonly ToolcraftAcceptanceValidator[] = [
   {
     path: "schema.export",
     ruleId: "output-export-required",
-    validate: ({ acceptance, controls, hasVideoExportAction, schema }) =>
+    validate: ({ acceptance, controls, productReadiness, schema }) =>
       getToolcraftOutputExportErrors({
         acceptance,
         controls,
-        hasVideoExportAction,
+        productReadiness,
         schema,
       }),
   },
   {
-    path: "starterTransferMode.videoReferenceStudy",
+    path: "starterTransferMode.referenceInputs",
     ruleId: "video-reference-analysis",
-    validate: getToolcraftVideoReferenceStudyErrors,
+    validate: getToolcraftMotionReferenceStudyErrors,
   },
   {
     path: "starterTransferMode.animationIntent",

package/templates/starter/src/app/starter-acceptance-data.ts

@@ -14,6 +14,7 @@ const starterPersistenceSlices =
 export const starterTransferMode: ToolcraftTransferMode = {
   animationIntent: { mode: "none" },
   mode: "new-toolcraft-app",
+  referenceInputs: [],
 };
 
 export const starterProductReadiness: ToolcraftProductReadiness = {

package/templates/starter/src/app/starter-acceptance.animation-intent.test.ts

@@ -253,6 +253,7 @@ describe("starter acceptance animation intent contract", () => {
             reason: "The shimmer is decorative self-running output and does not expose product time transport.",
           },
           mode: "new-toolcraft-app",
+          referenceInputs: [],
         },
       }),
     ).toEqual([]);
@@ -351,6 +352,7 @@ describe("starter acceptance animation intent contract", () => {
             reason: "The shader is decorative self-running output with no transport controls.",
           },
           mode: "new-toolcraft-app",
+          referenceInputs: [],
         },
       }),
     ).toContain(
@@ -377,6 +379,7 @@ describe("starter acceptance animation intent contract", () => {
             mode: "timeline-keyframes",
           },
           mode: "new-toolcraft-app",
+          referenceInputs: [],
         },
       }),
     ).toContain(