/*
 * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
 * This file is licensed to you under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License. You may obtain a copy
 * of the License at https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under
 * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
 * OF ANY KIND, either express or implied. See the License for the specific language
 * governing permissions and limitations under the License.
 */

import { ViewStackEventTypes } from "./events.js";
import { ComponentProps, PropsWithChildren, RefAttributes } from "react";
import { UniqueId } from "@accelint/core";
import { Payload } from "@accelint/bus";
import { Pressable } from "react-aria-components/Pressable";

//#region src/components/view-stack/types.d.ts
/**
 * Props for the ViewStack component.
 */
type ViewStackProps = RefAttributes<HTMLDivElement> & PropsWithChildren<{
  /** Unique identifier for the stack. */
  id: UniqueId;
  /** Default view to display when the stack is initialized. */
  defaultView?: UniqueId;
  /** Callback when the active view changes. */
  onChange?: (view: UniqueId | null) => void;
}>;
/**
 * Props for the ViewStackView component.
 */
type ViewStackViewProps = RefAttributes<HTMLDivElement> & PropsWithChildren<{
  /** Unique identifier for the view. */
  id: UniqueId;
}>;
/** Event payload for navigating back in a ViewStack. */
type ViewStackBackEvent = Payload<typeof ViewStackEventTypes.back, {
  stack: UniqueId;
}>;
/** Event payload for clearing all views in a ViewStack. */
type ViewStackClearEvent = Payload<typeof ViewStackEventTypes.clear, {
  stack: UniqueId;
}>;
/** Event payload for resetting a ViewStack to its default view. */
type ViewStackResetEvent = Payload<typeof ViewStackEventTypes.reset, {
  stack: UniqueId;
}>;
/** Event payload for pushing a view onto a ViewStack. */
type ViewStackPushEvent = Payload<typeof ViewStackEventTypes.push, {
  view: UniqueId;
}>;
/** Union of all ViewStack event types. */
type ViewStackEvent = ViewStackBackEvent | ViewStackClearEvent | ViewStackResetEvent | ViewStackPushEvent;
type SimpleEvents = 'back' | 'clear' | 'reset' | UniqueId;
type TargetedEvents = `back:${UniqueId}` | `clear:${UniqueId}` | `reset:${UniqueId}`;
type ChainedEvents = (SimpleEvents | TargetedEvents)[];
/**
 * Props for the ViewStackTrigger component.
 */
type ViewStackTriggerProps = {
  /** Pressable children content. */
  children: ComponentProps<typeof Pressable>['children'];
  /**
   * __SimpleEvents__ allow the easiest implementation of events, but come with some restrictions:
   * - The literal commands `back | clear | reset` will only work inside of the context of a ViewStack
   * - When passing a view's UniqueId the behavior is always to push that id onto it's parent's stack
   *
   * __TargetedEvents__ allow for external control of a ViewStack, the UniqueId of a Stack is passed to know which stack to affect
   *
   * __ChainedEvents__ allow a list of events from a single control to enable multiple behaviors
   *
   * @example
   * ```ts
   * // Clear a stack and then push a view on:
   * ['clear', myViewId]
   *
   * // Reset multiple stacks:
   * [`reset:${stackOneId}`, `reset:${stackTwoId}`]
   *
   * // Hydrate a stack with multiple views:
   * [viewOneId, viewTwoId, viewThreeId]
   * ```
   */
  for: SimpleEvents | TargetedEvents | ChainedEvents;
};
/**
 * Context value for the ViewStack component.
 */
type ViewStackContextValue = {
  /** Parent stack identifier, or null if at root. */
  parent: UniqueId | null;
  /** Array of view IDs currently in the stack. */
  stack: string[];
  /** Currently active view ID, or null if empty. */
  view: UniqueId | null;
  /** Registers a view with the stack. */
  register: (view: UniqueId) => void;
  /** Unregisters a view from the stack. */
  unregister: (view: UniqueId) => void;
};
//#endregion
export { ViewStackBackEvent, ViewStackClearEvent, ViewStackContextValue, ViewStackEvent, ViewStackProps, ViewStackPushEvent, ViewStackResetEvent, ViewStackTriggerProps, ViewStackViewProps };
//# sourceMappingURL=types.d.ts.map