@kiwa-test/component 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -539,8 +539,8 @@ declare const componentFixtures: Record<string, ComponentRender<Record<string, u
  * any of those runtimes, so the same axis can be replayed against each target.
  */
 type ComponentTarget = 'storybook8' | 'playwright-ct' | 'chromatic';
-type ComponentAxis = 'rsc-harness' | 'streaming-ssr' | 'view-transitions' | 'form-action-advanced';
-type NeutralEventName = 'rsc.render_started' | 'rsc.suspense_boundary' | 'rsc.html_chunk_streamed' | 'rsc.render_completed' | 'ssr.suspense_pending' | 'ssr.error_boundary_captured' | 'ssr.progressive_hydration_started' | 'ssr.selective_hydration_completed' | 'transition.element_started' | 'transition.element_finished' | 'transition.document_started' | 'transition.animation_asserted' | 'form.status_pending' | 'form.optimistic_applied' | 'form.progressive_enhanced' | 'form.action_resolved';
+type ComponentAxis = 'rsc-harness' | 'streaming-ssr' | 'view-transitions' | 'form-action-advanced' | 'react-19-actions' | 'islands-architecture';
+type NeutralEventName = 'rsc.render_started' | 'rsc.suspense_boundary' | 'rsc.html_chunk_streamed' | 'rsc.render_completed' | 'ssr.suspense_pending' | 'ssr.error_boundary_captured' | 'ssr.progressive_hydration_started' | 'ssr.selective_hydration_completed' | 'transition.element_started' | 'transition.element_finished' | 'transition.document_started' | 'transition.animation_asserted' | 'form.status_pending' | 'form.optimistic_applied' | 'form.progressive_enhanced' | 'form.action_resolved' | 'action.state_initialized' | 'action.transition_pending' | 'action.optimistic_committed' | 'action.resolved' | 'islands.registered' | 'islands.hydration_started' | 'islands.interactive_ready' | 'islands.static_boundary_asserted';
 interface AxisStep<TState extends string> {
     neutralEvent: NeutralEventName;
     providerEvent: string;
@@ -645,7 +645,7 @@ declare function startFormActionSession<TForm extends Record<string, unknown>>(i
     initial: TForm;
 }): FormActionSession<TForm>;
 declare function markFormStatusPending<TForm extends Record<string, unknown>>(session: FormActionSession<TForm>, submitter: string): AxisStep<FormActionState>;
-declare function applyOptimisticUpdate<TForm extends Record<string, unknown>>(session: FormActionSession<TForm>, patch: Partial<TForm>): AxisStep<FormActionState>;
+declare function applyOptimisticUpdate$1<TForm extends Record<string, unknown>>(session: FormActionSession<TForm>, patch: Partial<TForm>): AxisStep<FormActionState>;
 declare function enableProgressiveEnhancement<TForm extends Record<string, unknown>>(session: FormActionSession<TForm>, input: {
     method?: 'post' | 'get';
     actionUrl: string;
@@ -667,6 +667,57 @@ interface FidelityCoverage {
 declare const COMPONENT_AXIS_TO_EVENTS: Record<ComponentAxis, NeutralEventName[]>;
 declare function collectFidelityCoverage(providers?: ComponentTarget[]): FidelityCoverage;
 
+/**
+ * v1.49 react-19-actions axis — useActionState + useOptimistic + useFormStatus
+ * を統合した React 19 Actions API の deterministic state machine。
+ */
+type ReactActionsState = 'idle' | 'transition-pending' | 'optimistic-committed' | 'resolved';
+interface ReactActionsSession {
+    target: ComponentTarget;
+    actionId: string;
+    state: ReactActionsState;
+    pendingCount: number;
+    optimisticValues: string[];
+    resolvedValue: string | null;
+    history: AxisStep<ReactActionsState>[];
+}
+declare function initializeReactActions(input: {
+    target: ComponentTarget;
+    actionId: string;
+}): ReactActionsSession;
+declare function beginActionTransition(session: ReactActionsSession): AxisStep<ReactActionsState>;
+declare function applyOptimisticUpdate(session: ReactActionsSession, optimisticValue: string): AxisStep<ReactActionsState>;
+declare function resolveAction(session: ReactActionsSession, resolvedValue: string): AxisStep<ReactActionsState>;
+
+/**
+ * v1.49 islands-architecture axis — Astro / Deno Fresh / Solid Start の
+ * Islands architecture (partial hydration + selective interactivity) を
+ * target-neutral に扱う state machine。
+ */
+type IslandsState = 'idle' | 'registered' | 'hydrating' | 'interactive' | 'static-verified';
+interface IslandSpec {
+    islandId: string;
+    loadStrategy: 'load' | 'idle' | 'visible' | 'media' | 'only';
+    interactiveBoundary: boolean;
+}
+interface IslandsSession {
+    target: ComponentTarget;
+    routeId: string;
+    islands: IslandSpec[];
+    state: IslandsState;
+    hydratedIslandIds: string[];
+    staticBoundaryIds: string[];
+    history: AxisStep<IslandsState>[];
+}
+declare function bootstrapIslandsRoute(input: {
+    target: ComponentTarget;
+    routeId: string;
+}): IslandsSession;
+declare function registerIsland(session: IslandsSession, island: IslandSpec): AxisStep<IslandsState>;
+declare function beginIslandHydration(session: IslandsSession, islandId: string): AxisStep<IslandsState>;
+declare function markIslandInteractive(session: IslandsSession, islandId: string): AxisStep<IslandsState>;
+declare function assertStaticBoundary(session: IslandsSession, boundaryId: string): AxisStep<IslandsState>;
+
 type KiwaTestMode = 'mock' | 'real';
 interface ResolvedMode {
     mode: KiwaTestMode;
@@ -677,4 +728,4 @@ declare function resolveMode(provider: ComponentTarget, env?: Record<string, str
 declare function resolveAllModes(env?: Record<string, string | undefined>): ResolvedMode[];
 declare function assertMode(provider: ComponentTarget, expected: KiwaTestMode, env?: Record<string, string | undefined>): void;
 
-export { type A11yViolation, type AxisStep, type ButtonArgs, COMPONENT_AXIS_TO_EVENTS, type CanvasElement, type CardArgs, type ChromaticConfig, type ChromaticVisualMock, type ComponentAxis, type ComponentLocator, type ComponentProvider, type ComponentRender, type ComponentTarget, type FidelityCoverage, type FidelityRow, type FormActionSession, type FormActionState, type FormArgs, type FormField, type InputArgs, type KiwaTestMode, type MockEvent, type MockNode, type ModalArgs, type NeutralEventName, type NodeLocator, type NodeOptions, type PlayContext, type PlaywrightCTMock, type ResolvedMode, type RscHarnessSession, type RscHarnessState, type StoryEntry, type StoryMeta, type StoryMountResult, type StoryObj, type StoryParameters, type StoryPlayResult, type StoryRegistry, type StreamingSsrSession, type StreamingSsrState, type ViewTransitionSession, type ViewTransitionState, type VisualBaseline, type VisualDiff, type VisualReviewAction, type VisualReviewEntry, addHandler, appendChild, applyOptimisticUpdate, assertAnimation, assertMode, beginRscRender, buildButton, buildCard, buildForm, buildInput, buildModal, captureErrorBoundary, collectFidelityCoverage, completeRscRender, completeSelectiveHydration, componentFixtures, createCanvas, createChromaticVisualMock, createNode, createPlaywrightCTMock, createStoryRegistry, enableProgressiveEnhancement, enterSuspenseBoundary, failRscRender, findByRole, findByText, finishElementTransition, fireEvent, hashMarkup, markFormStatusPending, markSuspensePending, providerEventName, query, rejectFormAction, renderMarkup, resolveAllModes, resolveFormAction, resolveMode, startDocumentTransition, startElementTransition, startFormActionSession, startProgressiveHydration, startRscHarness, startStreamingSsr, startViewTransitionSession, streamHtmlChunk };
+export { type A11yViolation, type AxisStep, type ButtonArgs, COMPONENT_AXIS_TO_EVENTS, type CanvasElement, type CardArgs, type ChromaticConfig, type ChromaticVisualMock, type ComponentAxis, type ComponentLocator, type ComponentProvider, type ComponentRender, type ComponentTarget, type FidelityCoverage, type FidelityRow, type FormActionSession, type FormActionState, type FormArgs, type FormField, type InputArgs, type IslandSpec, type IslandsSession, type IslandsState, type KiwaTestMode, type MockEvent, type MockNode, type ModalArgs, type NeutralEventName, type NodeLocator, type NodeOptions, type PlayContext, type PlaywrightCTMock, type ReactActionsSession, type ReactActionsState, type ResolvedMode, type RscHarnessSession, type RscHarnessState, type StoryEntry, type StoryMeta, type StoryMountResult, type StoryObj, type StoryParameters, type StoryPlayResult, type StoryRegistry, type StreamingSsrSession, type StreamingSsrState, type ViewTransitionSession, type ViewTransitionState, type VisualBaseline, type VisualDiff, type VisualReviewAction, type VisualReviewEntry, addHandler, appendChild, applyOptimisticUpdate$1 as applyOptimisticUpdate, applyOptimisticUpdate as applyReactActionOptimistic, assertAnimation, assertMode, assertStaticBoundary, beginActionTransition, beginIslandHydration, beginRscRender, bootstrapIslandsRoute, buildButton, buildCard, buildForm, buildInput, buildModal, captureErrorBoundary, collectFidelityCoverage, completeRscRender, completeSelectiveHydration, componentFixtures, createCanvas, createChromaticVisualMock, createNode, createPlaywrightCTMock, createStoryRegistry, enableProgressiveEnhancement, enterSuspenseBoundary, failRscRender, findByRole, findByText, finishElementTransition, fireEvent, hashMarkup, initializeReactActions, markFormStatusPending, markIslandInteractive, markSuspensePending, providerEventName, query, registerIsland, rejectFormAction, renderMarkup, resolveAction, resolveAllModes, resolveFormAction, resolveMode, startDocumentTransition, startElementTransition, startFormActionSession, startProgressiveHydration, startRscHarness, startStreamingSsr, startViewTransitionSession, streamHtmlChunk };

package/dist/index.js

@@ -1118,6 +1118,19 @@ var COMPONENT_AXIS_TO_EVENTS = {
     "form.optimistic_applied",
     "form.progressive_enhanced",
     "form.action_resolved"
+  ],
+  // v1.49 advanced III
+  "react-19-actions": [
+    "action.state_initialized",
+    "action.transition_pending",
+    "action.optimistic_committed",
+    "action.resolved"
+  ],
+  "islands-architecture": [
+    "islands.registered",
+    "islands.hydration_started",
+    "islands.interactive_ready",
+    "islands.static_boundary_asserted"
   ]
 };
 function collectFidelityCoverage(providers = ["storybook8", "playwright-ct", "chromatic"]) {
@@ -1137,6 +1150,147 @@ function collectFidelityCoverage(providers = ["storybook8", "playwright-ct", "ch
   return { providers, axes, rows };
 }
 
+// src/semantics/react-19-actions.ts
+function emit5(session, neutralEvent, metadata) {
+  const step = {
+    neutralEvent,
+    providerEvent: providerEventName(session.target, neutralEvent),
+    state: session.state,
+    amountCents: 0,
+    metadata: { actionId: session.actionId, ...metadata }
+  };
+  session.history.push(step);
+  return step;
+}
+function initializeReactActions(input) {
+  if (input.actionId.length === 0) {
+    throw new Error("initializeReactActions: actionId must not be empty");
+  }
+  const session = {
+    target: input.target,
+    actionId: input.actionId,
+    state: "idle",
+    pendingCount: 0,
+    optimisticValues: [],
+    resolvedValue: null,
+    history: []
+  };
+  emit5(session, "action.state_initialized", { pendingCount: 0 });
+  return session;
+}
+function beginActionTransition(session) {
+  if (session.state !== "idle" && session.state !== "resolved") {
+    throw new Error(`beginActionTransition: session is ${session.state}`);
+  }
+  session.state = "transition-pending";
+  session.pendingCount += 1;
+  return emit5(session, "action.transition_pending", {
+    pendingCount: session.pendingCount
+  });
+}
+function applyOptimisticUpdate2(session, optimisticValue) {
+  if (session.state !== "transition-pending") {
+    throw new Error(`applyOptimisticUpdate: session is ${session.state}`);
+  }
+  session.state = "optimistic-committed";
+  session.optimisticValues.push(optimisticValue);
+  return emit5(session, "action.optimistic_committed", { optimisticValue });
+}
+function resolveAction(session, resolvedValue) {
+  if (session.state !== "transition-pending" && session.state !== "optimistic-committed") {
+    throw new Error(`resolveAction: session is ${session.state}`);
+  }
+  session.state = "resolved";
+  session.resolvedValue = resolvedValue;
+  session.pendingCount = Math.max(0, session.pendingCount - 1);
+  return emit5(session, "action.resolved", {
+    resolvedValue,
+    pendingCount: session.pendingCount,
+    optimisticCount: session.optimisticValues.length
+  });
+}
+
+// src/semantics/islands-architecture.ts
+function emit6(session, neutralEvent, metadata) {
+  const step = {
+    neutralEvent,
+    providerEvent: providerEventName(session.target, neutralEvent),
+    state: session.state,
+    amountCents: 0,
+    metadata: { routeId: session.routeId, ...metadata }
+  };
+  session.history.push(step);
+  return step;
+}
+function bootstrapIslandsRoute(input) {
+  if (input.routeId.length === 0) {
+    throw new Error("bootstrapIslandsRoute: routeId must not be empty");
+  }
+  return {
+    target: input.target,
+    routeId: input.routeId,
+    islands: [],
+    state: "idle",
+    hydratedIslandIds: [],
+    staticBoundaryIds: [],
+    history: []
+  };
+}
+function registerIsland(session, island) {
+  session.islands.push(island);
+  session.state = "registered";
+  return emit6(session, "islands.registered", {
+    islandId: island.islandId,
+    loadStrategy: island.loadStrategy,
+    interactiveBoundary: island.interactiveBoundary
+  });
+}
+function beginIslandHydration(session, islandId) {
+  const island = session.islands.find((i) => i.islandId === islandId);
+  if (!island) {
+    throw new Error(`beginIslandHydration: island ${islandId} not registered`);
+  }
+  if (session.state !== "registered" && session.state !== "hydrating") {
+    throw new Error(`beginIslandHydration: session is ${session.state}`);
+  }
+  session.state = "hydrating";
+  return emit6(session, "islands.hydration_started", {
+    islandId,
+    loadStrategy: island.loadStrategy
+  });
+}
+function markIslandInteractive(session, islandId) {
+  if (session.state !== "hydrating") {
+    throw new Error(`markIslandInteractive: session is ${session.state}`);
+  }
+  if (session.hydratedIslandIds.includes(islandId)) {
+    throw new Error(`markIslandInteractive: island ${islandId} already interactive`);
+  }
+  session.hydratedIslandIds.push(islandId);
+  const allHydrated = session.hydratedIslandIds.length === session.islands.filter((i) => i.interactiveBoundary).length;
+  if (allHydrated) {
+    session.state = "interactive";
+  }
+  return emit6(session, "islands.interactive_ready", {
+    islandId,
+    hydratedCount: session.hydratedIslandIds.length,
+    allInteractiveReady: allHydrated
+  });
+}
+function assertStaticBoundary(session, boundaryId) {
+  if (session.staticBoundaryIds.includes(boundaryId)) {
+    throw new Error(`assertStaticBoundary: boundary ${boundaryId} already asserted`);
+  }
+  session.staticBoundaryIds.push(boundaryId);
+  if (session.state === "interactive") {
+    session.state = "static-verified";
+  }
+  return emit6(session, "islands.static_boundary_asserted", {
+    boundaryId,
+    staticBoundaryCount: session.staticBoundaryIds.length
+  });
+}
+
 // src/real-driver.ts
 var TARGET_KEY_ENV = {
   storybook8: "STORYBOOK_URL",
@@ -1174,9 +1328,14 @@ export {
   addHandler,
   appendChild,
   applyOptimisticUpdate,
+  applyOptimisticUpdate2 as applyReactActionOptimistic,
   assertAnimation,
   assertMode,
+  assertStaticBoundary,
+  beginActionTransition,
+  beginIslandHydration,
   beginRscRender,
+  bootstrapIslandsRoute,
   buildButton,
   buildCard,
   buildForm,
@@ -1200,12 +1359,16 @@ export {
   finishElementTransition,
   fireEvent,
   hashMarkup,
+  initializeReactActions,
   markFormStatusPending,
+  markIslandInteractive,
   markSuspensePending,
   providerEventName,
   query,
+  registerIsland,
   rejectFormAction,
   renderMarkup,
+  resolveAction,
   resolveAllModes,
   resolveFormAction,
   resolveMode,