@coxwave/tap-kit-types 2.0.0 → 2.0.2

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 import * as CSS from 'csstype';
-import * as v from 'valibot';
 import { ReactNode, CSSProperties } from 'react';
 
 /**
@@ -188,14 +187,15 @@ interface ContainerModeChangeAckMessage {
  *
  * Sent when:
  * - User toggles layout via LayoutToggleButton (iframe → parent → iframe)
- * - Viewport resize forces floating mode (parent only)
  * - Parent calls Container.setLayoutState programmatically
  *
- * @see ContainerLayoutState in @coxwave/tap-kit-types
+ * Note: "floating-forced" is internal state, not exposed to iframe
  */
 interface ContainerLayoutStateChangedMessage {
     type: "container:layout:state:changed";
-    layoutState: "floating" | "sidebar" | "floating-forced";
+    layoutState: "floating" | "sidebar";
+    /** Viewport too narrow for sidebar (toggle button should hide) */
+    isNarrowViewport?: boolean;
 }
 /**
  * Viewport Resize Event (parent window → iframe)
@@ -234,400 +234,1963 @@ interface ConfigUpdateMessage {
      * Default: "inline"
      */
     mode?: "inline" | "floating" | "sidebar";
+    /**
+     * Allow user to toggle between floating and sidebar layouts
+     * @default true
+     */
+    allowLayoutToggle?: boolean;
     /**
      * Container configuration (styling for floating/sidebar modes)
      *
      * Structure:
      * - floatingConfig: { position, width, height, borderRadius }
      * - sidebarConfig: { maxWidth, minViewportWidth }
+     */
+    container?: {
+        floatingConfig?: {
+            position?: {
+                top?: string;
+                left?: string;
+                right?: string;
+                bottom?: string;
+            };
+            width?: string;
+            height?: string;
+            borderRadius?: string;
+        };
+        sidebarConfig?: {
+            maxWidth?: string;
+            minViewportWidth?: number;
+        };
+    };
+}
+/**
+ * Google Analytics Event Message (iframe → parent)
+ * Sent from edutap iframe to tap-kit-core for analytics tracking
+ */
+interface GAEventMessage {
+    type: "GA_EVENT";
+    payload: Record<string, unknown>;
+}
+
+/**
+ * Fallback type.
+ */
+type Fallback<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>>> = MaybeReadonly<InferOutput<TSchema>> | ((dataset?: OutputDataset<InferOutput<TSchema>, InferIssue<TSchema>>, config?: Config<InferIssue<TSchema>>) => MaybeReadonly<InferOutput<TSchema>>);
+/**
+ * Schema with fallback type.
+ */
+type SchemaWithFallback<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, TFallback extends Fallback<TSchema>> = TSchema & {
+    /**
+     * The fallback value.
+     */
+    readonly fallback: TFallback;
+};
+
+/**
+ * Fallback async type.
+ */
+type FallbackAsync<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>> = MaybeReadonly<InferOutput<TSchema>> | ((dataset?: OutputDataset<InferOutput<TSchema>, InferIssue<TSchema>>, config?: Config<InferIssue<TSchema>>) => MaybePromise<MaybeReadonly<InferOutput<TSchema>>>);
+/**
+ * Schema with fallback async type.
+ */
+type SchemaWithFallbackAsync<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TFallback extends FallbackAsync<TSchema>> = Omit<TSchema, 'async' | '~standard' | '~run'> & {
+    /**
+     * The fallback value.
+     */
+    readonly fallback: TFallback;
+    /**
+     * Whether it's async.
+     */
+    readonly async: true;
+    /**
+     * The Standard Schema properties.
+     *
+     * @internal
+     */
+    readonly '~standard': StandardProps<InferInput<TSchema>, InferOutput<TSchema>>;
+    /**
+     * Parses unknown input values.
+     *
+     * @param dataset The input dataset.
+     * @param config The configuration.
+     *
+     * @returns The output dataset.
+     *
+     * @internal
+     */
+    readonly '~run': (dataset: UnknownDataset, config: Config<BaseIssue<unknown>>) => Promise<OutputDataset<InferOutput<TSchema>, InferIssue<TSchema>>>;
+};
+
+/**
+ * Schema with pipe type.
+ */
+type SchemaWithPipe<TPipe extends readonly [
+    BaseSchema<unknown, unknown, BaseIssue<unknown>>,
+    ...PipeItem<any, unknown, BaseIssue<unknown>>[]
+]> = Omit<FirstTupleItem<TPipe>, 'pipe' | '~standard' | '~run' | '~types'> & {
+    /**
+     * The pipe items.
+     */
+    readonly pipe: TPipe;
+    /**
+     * The Standard Schema properties.
+     *
+     * @internal
+     */
+    readonly '~standard': StandardProps<InferInput<FirstTupleItem<TPipe>>, InferOutput<LastTupleItem<TPipe>>>;
+    /**
+     * Parses unknown input values.
+     *
+     * @param dataset The input dataset.
+     * @param config The configuration.
+     *
+     * @returns The output dataset.
+     *
+     * @internal
+     */
+    readonly '~run': (dataset: UnknownDataset, config: Config<BaseIssue<unknown>>) => OutputDataset<InferOutput<LastTupleItem<TPipe>>, InferIssue<TPipe[number]>>;
+    /**
+     * The input, output and issue type.
+     *
+     * @internal
+     */
+    readonly '~types'?: {
+        readonly input: InferInput<FirstTupleItem<TPipe>>;
+        readonly output: InferOutput<LastTupleItem<TPipe>>;
+        readonly issue: InferIssue<TPipe[number]>;
+    } | undefined;
+};
+
+/**
+ * Schema with pipe async type.
+ */
+type SchemaWithPipeAsync<TPipe extends readonly [
+    (BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>),
+    ...(PipeItem<any, unknown, BaseIssue<unknown>> | PipeItemAsync<any, unknown, BaseIssue<unknown>>)[]
+]> = Omit<FirstTupleItem<TPipe>, 'async' | 'pipe' | '~standard' | '~run' | '~types'> & {
+    /**
+     * The pipe items.
+     */
+    readonly pipe: TPipe;
+    /**
+     * Whether it's async.
+     */
+    readonly async: true;
+    /**
+     * The Standard Schema properties.
+     *
+     * @internal
+     */
+    readonly '~standard': StandardProps<InferInput<FirstTupleItem<TPipe>>, InferOutput<LastTupleItem<TPipe>>>;
+    /**
+     * Parses unknown input values.
+     *
+     * @param dataset The input dataset.
+     * @param config The configuration.
+     *
+     * @returns The output dataset.
+     *
+     * @internal
+     */
+    readonly '~run': (dataset: UnknownDataset, config: Config<BaseIssue<unknown>>) => Promise<OutputDataset<InferOutput<LastTupleItem<TPipe>>, InferIssue<TPipe[number]>>>;
+    /**
+     * The input, output and issue type.
+     *
+     * @internal
+     */
+    readonly '~types'?: {
+        readonly input: InferInput<FirstTupleItem<TPipe>>;
+        readonly output: InferOutput<LastTupleItem<TPipe>>;
+        readonly issue: InferIssue<TPipe[number]>;
+    } | undefined;
+};
+
+/**
+ * Base metadata interface.
+ */
+interface BaseMetadata<TInput> {
+    /**
+     * The object kind.
+     */
+    readonly kind: 'metadata';
+    /**
+     * The metadata type.
+     */
+    readonly type: string;
+    /**
+     * The metadata reference.
+     */
+    readonly reference: (...args: any[]) => BaseMetadata<any>;
+    /**
+     * The input, output and issue type.
+     *
+     * @internal
+     */
+    readonly '~types'?: {
+        readonly input: TInput;
+        readonly output: TInput;
+        readonly issue: never;
+    } | undefined;
+}
+
+/**
+ * Unknown dataset interface.
+ */
+interface UnknownDataset {
+    /**
+     * Whether is's typed.
+     */
+    typed?: false;
+    /**
+     * The dataset value.
+     */
+    value: unknown;
+    /**
+     * The dataset issues.
+     */
+    issues?: undefined;
+}
+/**
+ * Success dataset interface.
+ */
+interface SuccessDataset<TValue> {
+    /**
+     * Whether is's typed.
+     */
+    typed: true;
+    /**
+     * The dataset value.
+     */
+    value: TValue;
+    /**
+     * The dataset issues.
+     */
+    issues?: undefined;
+}
+/**
+ * Partial dataset interface.
+ */
+interface PartialDataset<TValue, TIssue extends BaseIssue<unknown>> {
+    /**
+     * Whether is's typed.
+     */
+    typed: true;
+    /**
+     * The dataset value.
+     */
+    value: TValue;
+    /**
+     * The dataset issues.
+     */
+    issues: [TIssue, ...TIssue[]];
+}
+/**
+ * Failure dataset interface.
+ */
+interface FailureDataset<TIssue extends BaseIssue<unknown>> {
+    /**
+     * Whether is's typed.
+     */
+    typed: false;
+    /**
+     * The dataset value.
+     */
+    value: unknown;
+    /**
+     * The dataset issues.
+     */
+    issues: [TIssue, ...TIssue[]];
+}
+/**
+ * Output dataset type.
+ */
+type OutputDataset<TValue, TIssue extends BaseIssue<unknown>> = SuccessDataset<TValue> | PartialDataset<TValue, TIssue> | FailureDataset<TIssue>;
+
+/**
+ * The Standard Schema properties interface.
+ */
+interface StandardProps<TInput, TOutput> {
+    /**
+     * The version number of the standard.
+     */
+    readonly version: 1;
+    /**
+     * The vendor name of the schema library.
+     */
+    readonly vendor: 'valibot';
+    /**
+     * Validates unknown input values.
+     */
+    readonly validate: (value: unknown) => StandardResult<TOutput> | Promise<StandardResult<TOutput>>;
+    /**
+     * Inferred types associated with the schema.
+     */
+    readonly types?: StandardTypes<TInput, TOutput> | undefined;
+}
+/**
+ * The result interface of the validate function.
+ */
+type StandardResult<TOutput> = StandardSuccessResult<TOutput> | StandardFailureResult;
+/**
+ * The result interface if validation succeeds.
+ */
+interface StandardSuccessResult<TOutput> {
+    /**
+     * The typed output value.
+     */
+    readonly value: TOutput;
+    /**
+     * The non-existent issues.
+     */
+    readonly issues?: undefined;
+}
+/**
+ * The result interface if validation fails.
+ */
+interface StandardFailureResult {
+    /**
+     * The issues of failed validation.
+     */
+    readonly issues: readonly StandardIssue[];
+}
+/**
+ * The issue interface of the failure output.
+ */
+interface StandardIssue {
+    /**
+     * The error message of the issue.
+     */
+    readonly message: string;
+    /**
+     * The path of the issue, if any.
+     */
+    readonly path?: readonly (PropertyKey | StandardPathItem)[] | undefined;
+}
+/**
+ * The path item interface of the issue.
+ */
+interface StandardPathItem {
+    /**
+     * The key of the path item.
+     */
+    readonly key: PropertyKey;
+}
+/**
+ * The Standard Schema types interface.
+ */
+interface StandardTypes<TInput, TOutput> {
+    /**
+     * The input type of the schema.
+     */
+    readonly input: TInput;
+    /**
+     * The output type of the schema.
+     */
+    readonly output: TOutput;
+}
+
+/**
+ * Base schema interface.
+ */
+interface BaseSchema<TInput, TOutput, TIssue extends BaseIssue<unknown>> {
+    /**
+     * The object kind.
+     */
+    readonly kind: 'schema';
+    /**
+     * The schema type.
+     */
+    readonly type: string;
+    /**
+     * The schema reference.
+     */
+    readonly reference: (...args: any[]) => BaseSchema<unknown, unknown, BaseIssue<unknown>>;
+    /**
+     * The expected property.
+     */
+    readonly expects: string;
+    /**
+     * Whether it's async.
+     */
+    readonly async: false;
+    /**
+     * The Standard Schema properties.
+     *
+     * @internal
+     */
+    readonly '~standard': StandardProps<TInput, TOutput>;
+    /**
+     * Parses unknown input values.
+     *
+     * @param dataset The input dataset.
+     * @param config The configuration.
+     *
+     * @returns The output dataset.
+     *
+     * @internal
+     */
+    readonly '~run': (dataset: UnknownDataset, config: Config<BaseIssue<unknown>>) => OutputDataset<TOutput, TIssue>;
+    /**
+     * The input, output and issue type.
+     *
+     * @internal
+     */
+    readonly '~types'?: {
+        readonly input: TInput;
+        readonly output: TOutput;
+        readonly issue: TIssue;
+    } | undefined;
+}
+/**
+ * Base schema async interface.
+ */
+interface BaseSchemaAsync<TInput, TOutput, TIssue extends BaseIssue<unknown>> extends Omit<BaseSchema<TInput, TOutput, TIssue>, 'reference' | 'async' | '~run'> {
+    /**
+     * The schema reference.
+     */
+    readonly reference: (...args: any[]) => BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>;
+    /**
+     * Whether it's async.
+     */
+    readonly async: true;
+    /**
+     * Parses unknown input values.
+     *
+     * @param dataset The input dataset.
+     * @param config The configuration.
+     *
+     * @returns The output dataset.
+     *
+     * @internal
+     */
+    readonly '~run': (dataset: UnknownDataset, config: Config<BaseIssue<unknown>>) => Promise<OutputDataset<TOutput, TIssue>>;
+}
+/**
+ * Generic schema type.
+ */
+type GenericSchema<TInput = unknown, TOutput = TInput, TIssue extends BaseIssue<unknown> = BaseIssue<unknown>> = BaseSchema<TInput, TOutput, TIssue>;
+
+/**
+ * Base transformation interface.
+ */
+interface BaseTransformation<TInput, TOutput, TIssue extends BaseIssue<unknown>> {
+    /**
+     * The object kind.
+     */
+    readonly kind: 'transformation';
+    /**
+     * The transformation type.
+     */
+    readonly type: string;
+    /**
+     * The transformation reference.
+     */
+    readonly reference: (...args: any[]) => BaseTransformation<any, any, BaseIssue<unknown>>;
+    /**
+     * Whether it's async.
+     */
+    readonly async: false;
+    /**
+     * Transforms known input values.
+     *
+     * @param dataset The input dataset.
+     * @param config The configuration.
+     *
+     * @returns The output dataset.
+     *
+     * @internal
+     */
+    readonly '~run': (dataset: SuccessDataset<TInput>, config: Config<BaseIssue<unknown>>) => OutputDataset<TOutput, BaseIssue<unknown> | TIssue>;
+    /**
+     * The input, output and issue type.
+     *
+     * @internal
+     */
+    readonly '~types'?: {
+        readonly input: TInput;
+        readonly output: TOutput;
+        readonly issue: TIssue;
+    } | undefined;
+}
+/**
+ * Base transformation async interface.
+ */
+interface BaseTransformationAsync<TInput, TOutput, TIssue extends BaseIssue<unknown>> extends Omit<BaseTransformation<TInput, TOutput, TIssue>, 'reference' | 'async' | '~run'> {
+    /**
+     * The transformation reference.
+     */
+    readonly reference: (...args: any[]) => BaseTransformation<any, any, BaseIssue<unknown>> | BaseTransformationAsync<any, any, BaseIssue<unknown>>;
+    /**
+     * Whether it's async.
+     */
+    readonly async: true;
+    /**
+     * Transforms known input values.
+     *
+     * @param dataset The input dataset.
+     * @param config The configuration.
+     *
+     * @returns The output dataset.
      *
-     * Note: containerMode ("auto" | "floating" | "sidebar") controls toggle button behavior
+     * @internal
+     */
+    readonly '~run': (dataset: SuccessDataset<TInput>, config: Config<BaseIssue<unknown>>) => Promise<OutputDataset<TOutput, BaseIssue<unknown> | TIssue>>;
+}
+
+/**
+ * Base validation interface.
+ */
+interface BaseValidation<TInput, TOutput, TIssue extends BaseIssue<unknown>> {
+    /**
+     * The object kind.
+     */
+    readonly kind: 'validation';
+    /**
+     * The validation type.
+     */
+    readonly type: string;
+    /**
+     * The validation reference.
+     */
+    readonly reference: (...args: any[]) => BaseValidation<any, any, BaseIssue<unknown>>;
+    /**
+     * The expected property.
+     */
+    readonly expects: string | null;
+    /**
+     * Whether it's async.
+     */
+    readonly async: false;
+    /**
+     * Validates known input values.
+     *
+     * @param dataset The input dataset.
+     * @param config The configuration.
+     *
+     * @returns The output dataset.
+     *
+     * @internal
+     */
+    readonly '~run': (dataset: OutputDataset<TInput, BaseIssue<unknown>>, config: Config<BaseIssue<unknown>>) => OutputDataset<TOutput, BaseIssue<unknown> | TIssue>;
+    /**
+     * The input, output and issue type.
+     *
+     * @internal
+     */
+    readonly '~types'?: {
+        readonly input: TInput;
+        readonly output: TOutput;
+        readonly issue: TIssue;
+    } | undefined;
+}
+/**
+ * Base validation async interface.
+ */
+interface BaseValidationAsync<TInput, TOutput, TIssue extends BaseIssue<unknown>> extends Omit<BaseValidation<TInput, TOutput, TIssue>, 'reference' | 'async' | '~run'> {
+    /**
+     * The validation reference.
+     */
+    readonly reference: (...args: any[]) => BaseValidation<any, any, BaseIssue<unknown>> | BaseValidationAsync<any, any, BaseIssue<unknown>>;
+    /**
+     * Whether it's async.
+     */
+    readonly async: true;
+    /**
+     * Validates known input values.
+     *
+     * @param dataset The input dataset.
+     * @param config The configuration.
+     *
+     * @returns The output dataset.
+     *
+     * @internal
+     */
+    readonly '~run': (dataset: OutputDataset<TInput, BaseIssue<unknown>>, config: Config<BaseIssue<unknown>>) => Promise<OutputDataset<TOutput, BaseIssue<unknown> | TIssue>>;
+}
+
+/**
+ * Infer input type.
+ */
+type InferInput<TItem extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>> | BaseValidation<any, unknown, BaseIssue<unknown>> | BaseValidationAsync<any, unknown, BaseIssue<unknown>> | BaseTransformation<any, unknown, BaseIssue<unknown>> | BaseTransformationAsync<any, unknown, BaseIssue<unknown>> | BaseMetadata<any>> = NonNullable<TItem['~types']>['input'];
+/**
+ * Infer output type.
+ */
+type InferOutput<TItem extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>> | BaseValidation<any, unknown, BaseIssue<unknown>> | BaseValidationAsync<any, unknown, BaseIssue<unknown>> | BaseTransformation<any, unknown, BaseIssue<unknown>> | BaseTransformationAsync<any, unknown, BaseIssue<unknown>> | BaseMetadata<any>> = NonNullable<TItem['~types']>['output'];
+/**
+ * Infer issue type.
+ */
+type InferIssue<TItem extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>> | BaseValidation<any, unknown, BaseIssue<unknown>> | BaseValidationAsync<any, unknown, BaseIssue<unknown>> | BaseTransformation<any, unknown, BaseIssue<unknown>> | BaseTransformationAsync<any, unknown, BaseIssue<unknown>> | BaseMetadata<any>> = NonNullable<TItem['~types']>['issue'];
+/**
+ * Constructs a type that is maybe readonly.
+ */
+type MaybeReadonly<TValue> = TValue | Readonly<TValue>;
+/**
+ * Constructs a type that is maybe a promise.
+ */
+type MaybePromise<TValue> = TValue | Promise<TValue>;
+/**
+ * Prettifies a type for better readability.
+ *
+ * Hint: This type has no effect and is only used so that TypeScript displays
+ * the final type in the preview instead of the utility types used.
+ */
+type Prettify<TObject> = {
+    [TKey in keyof TObject]: TObject[TKey];
+} & {};
+/**
+ * Marks specific keys as optional.
+ */
+type MarkOptional<TObject, TKeys extends keyof TObject> = {
+    [TKey in keyof TObject]?: unknown;
+} & Omit<TObject, TKeys> & Partial<Pick<TObject, TKeys>>;
+/**
+ * Extracts first tuple item.
+ */
+type FirstTupleItem<TTuple extends readonly [unknown, ...unknown[]]> = TTuple[0];
+/**
+ * Extracts last tuple item.
+ */
+type LastTupleItem<TTuple extends readonly [unknown, ...unknown[]]> = TTuple[TTuple extends readonly [unknown, ...infer TRest] ? TRest['length'] : never];
+
+/**
+ * Error message type.
+ */
+type ErrorMessage<TIssue extends BaseIssue<unknown>> = ((issue: TIssue) => string) | string;
+/**
+ * Default type.
+ */
+type Default<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, TInput extends null | undefined> = MaybeReadonly<InferInput<TWrapped> | TInput> | ((dataset?: UnknownDataset, config?: Config<InferIssue<TWrapped>>) => MaybeReadonly<InferInput<TWrapped> | TInput>) | undefined;
+/**
+ * Default async type.
+ */
+type DefaultAsync<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TInput extends null | undefined> = MaybeReadonly<InferInput<TWrapped> | TInput> | ((dataset?: UnknownDataset, config?: Config<InferIssue<TWrapped>>) => MaybePromise<MaybeReadonly<InferInput<TWrapped> | TInput>>) | undefined;
+/**
+ * Default value type.
+ */
+type DefaultValue<TDefault extends Default<BaseSchema<unknown, unknown, BaseIssue<unknown>>, null | undefined> | DefaultAsync<BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, null | undefined>> = TDefault extends DefaultAsync<infer TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, infer TInput> ? TDefault extends (dataset?: UnknownDataset, config?: Config<InferIssue<TWrapped>>) => MaybePromise<InferInput<TWrapped> | TInput> ? Awaited<ReturnType<TDefault>> : TDefault : never;
+
+/**
+ * Optional entry schema type.
+ */
+type OptionalEntrySchema = ExactOptionalSchema<BaseSchema<unknown, unknown, BaseIssue<unknown>>, unknown> | NullishSchema<BaseSchema<unknown, unknown, BaseIssue<unknown>>, unknown> | OptionalSchema<BaseSchema<unknown, unknown, BaseIssue<unknown>>, unknown>;
+/**
+ * Optional entry schema async type.
+ */
+type OptionalEntrySchemaAsync = ExactOptionalSchemaAsync<BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, unknown> | NullishSchemaAsync<BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, unknown> | OptionalSchemaAsync<BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, unknown>;
+/**
+ * Object entries interface.
+ */
+interface ObjectEntries {
+    [key: string]: BaseSchema<unknown, unknown, BaseIssue<unknown>> | SchemaWithFallback<BaseSchema<unknown, unknown, BaseIssue<unknown>>, unknown> | OptionalEntrySchema;
+}
+/**
+ * Object entries async interface.
+ */
+interface ObjectEntriesAsync {
+    [key: string]: BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>> | SchemaWithFallback<BaseSchema<unknown, unknown, BaseIssue<unknown>>, unknown> | SchemaWithFallbackAsync<BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, unknown> | OptionalEntrySchema | OptionalEntrySchemaAsync;
+}
+/**
+ * Infer entries input type.
+ */
+type InferEntriesInput<TEntries extends ObjectEntries | ObjectEntriesAsync> = {
+    -readonly [TKey in keyof TEntries]: InferInput<TEntries[TKey]>;
+};
+/**
+ * Infer entries output type.
+ */
+type InferEntriesOutput<TEntries extends ObjectEntries | ObjectEntriesAsync> = {
+    -readonly [TKey in keyof TEntries]: InferOutput<TEntries[TKey]>;
+};
+/**
+ * Optional input keys type.
+ */
+type OptionalInputKeys<TEntries extends ObjectEntries | ObjectEntriesAsync> = {
+    [TKey in keyof TEntries]: TEntries[TKey] extends OptionalEntrySchema | OptionalEntrySchemaAsync ? TKey : never;
+}[keyof TEntries];
+/**
+ * Optional output keys type.
+ */
+type OptionalOutputKeys<TEntries extends ObjectEntries | ObjectEntriesAsync> = {
+    [TKey in keyof TEntries]: TEntries[TKey] extends OptionalEntrySchema | OptionalEntrySchemaAsync ? undefined extends TEntries[TKey]['default'] ? TKey : never : never;
+}[keyof TEntries];
+/**
+ * Input with question marks type.
+ */
+type InputWithQuestionMarks<TEntries extends ObjectEntries | ObjectEntriesAsync, TObject extends InferEntriesInput<TEntries>> = MarkOptional<TObject, OptionalInputKeys<TEntries>>;
+/**
+ * Output with question marks type.
+ */
+type OutputWithQuestionMarks<TEntries extends ObjectEntries | ObjectEntriesAsync, TObject extends InferEntriesOutput<TEntries>> = MarkOptional<TObject, OptionalOutputKeys<TEntries>>;
+/**
+ * Readonly output keys type.
+ */
+type ReadonlyOutputKeys<TEntries extends ObjectEntries | ObjectEntriesAsync> = {
+    [TKey in keyof TEntries]: TEntries[TKey] extends SchemaWithPipe<infer TPipe> | SchemaWithPipeAsync<infer TPipe> ? ReadonlyAction<any> extends TPipe[number] ? TKey : never : never;
+}[keyof TEntries];
+/**
+ * Output with readonly type.
+ */
+type OutputWithReadonly<TEntries extends ObjectEntries | ObjectEntriesAsync, TObject extends OutputWithQuestionMarks<TEntries, InferEntriesOutput<TEntries>>> = Readonly<TObject> & Pick<TObject, Exclude<keyof TObject, ReadonlyOutputKeys<TEntries>>>;
+/**
+ * Infer object input type.
+ */
+type InferObjectInput<TEntries extends ObjectEntries | ObjectEntriesAsync> = Prettify<InputWithQuestionMarks<TEntries, InferEntriesInput<TEntries>>>;
+/**
+ * Infer object output type.
+ */
+type InferObjectOutput<TEntries extends ObjectEntries | ObjectEntriesAsync> = Prettify<OutputWithReadonly<TEntries, OutputWithQuestionMarks<TEntries, InferEntriesOutput<TEntries>>>>;
+/**
+ * Infer object issue type.
+ */
+type InferObjectIssue<TEntries extends ObjectEntries | ObjectEntriesAsync> = InferIssue<TEntries[keyof TEntries]>;
+
+/**
+ * Array path item interface.
+ */
+interface ArrayPathItem {
+    /**
+     * The path item type.
+     */
+    readonly type: 'array';
+    /**
+     * The path item origin.
+     */
+    readonly origin: 'value';
+    /**
+     * The path item input.
+     */
+    readonly input: MaybeReadonly<unknown[]>;
+    /**
+     * The path item key.
+     */
+    readonly key: number;
+    /**
+     * The path item value.
+     */
+    readonly value: unknown;
+}
+/**
+ * Map path item interface.
+ */
+interface MapPathItem {
+    /**
+     * The path item type.
+     */
+    readonly type: 'map';
+    /**
+     * The path item origin.
+     */
+    readonly origin: 'key' | 'value';
+    /**
+     * The path item input.
+     */
+    readonly input: Map<unknown, unknown>;
+    /**
+     * The path item key.
+     */
+    readonly key: unknown;
+    /**
+     * The path item value.
+     */
+    readonly value: unknown;
+}
+/**
+ * Object path item interface.
+ */
+interface ObjectPathItem {
+    /**
+     * The path item type.
+     */
+    readonly type: 'object';
+    /**
+     * The path item origin.
+     */
+    readonly origin: 'key' | 'value';
+    /**
+     * The path item input.
+     */
+    readonly input: Record<string, unknown>;
+    /**
+     * The path item key.
+     */
+    readonly key: string;
+    /**
+     * The path item value.
+     */
+    readonly value: unknown;
+}
+/**
+ * Set path item interface.
+ */
+interface SetPathItem {
+    /**
+     * The path item type.
+     */
+    readonly type: 'set';
+    /**
+     * The path item origin.
+     */
+    readonly origin: 'value';
+    /**
+     * The path item input.
+     */
+    readonly input: Set<unknown>;
+    /**
+     * The path item key.
+     */
+    readonly key: null;
+    /**
+     * The path item key.
+     */
+    readonly value: unknown;
+}
+/**
+ * Unknown path item interface.
+ */
+interface UnknownPathItem {
+    /**
+     * The path item type.
+     */
+    readonly type: 'unknown';
+    /**
+     * The path item origin.
+     */
+    readonly origin: 'key' | 'value';
+    /**
+     * The path item input.
+     */
+    readonly input: unknown;
+    /**
+     * The path item key.
+     */
+    readonly key: unknown;
+    /**
+     * The path item value.
+     */
+    readonly value: unknown;
+}
+/**
+ * Issue path item type.
+ */
+type IssuePathItem = ArrayPathItem | MapPathItem | ObjectPathItem | SetPathItem | UnknownPathItem;
+/**
+ * Base issue interface.
+ */
+interface BaseIssue<TInput> extends Config<BaseIssue<TInput>> {
+    /**
+     * The issue kind.
+     */
+    readonly kind: 'schema' | 'validation' | 'transformation';
+    /**
+     * The issue type.
+     */
+    readonly type: string;
+    /**
+     * The raw input data.
+     */
+    readonly input: TInput;
+    /**
+     * The expected property.
+     */
+    readonly expected: string | null;
+    /**
+     * The received property.
+     */
+    readonly received: string;
+    /**
+     * The error message.
+     */
+    readonly message: string;
+    /**
+     * The input requirement.
+     */
+    readonly requirement?: unknown | undefined;
+    /**
+     * The issue path.
+     */
+    readonly path?: [IssuePathItem, ...IssuePathItem[]] | undefined;
+    /**
+     * The sub issues.
+     */
+    readonly issues?: [BaseIssue<TInput>, ...BaseIssue<TInput>[]] | undefined;
+}
+
+/**
+ * Config interface.
+ */
+interface Config<TIssue extends BaseIssue<unknown>> {
+    /**
+     * The selected language.
+     */
+    readonly lang?: string | undefined;
+    /**
+     * The error message.
+     */
+    readonly message?: ErrorMessage<TIssue> | undefined;
+    /**
+     * Whether it should be aborted early.
+     */
+    readonly abortEarly?: boolean | undefined;
+    /**
+     * Whether a pipe should be aborted early.
+     */
+    readonly abortPipeEarly?: boolean | undefined;
+}
+
+/**
+ * Pipe action type.
+ */
+type PipeAction<TInput, TOutput, TIssue extends BaseIssue<unknown>> = BaseValidation<TInput, TOutput, TIssue> | BaseTransformation<TInput, TOutput, TIssue> | BaseMetadata<TInput>;
+/**
+ * Pipe action async type.
+ */
+type PipeActionAsync<TInput, TOutput, TIssue extends BaseIssue<unknown>> = BaseValidationAsync<TInput, TOutput, TIssue> | BaseTransformationAsync<TInput, TOutput, TIssue>;
+/**
+ * Pipe item type.
+ */
+type PipeItem<TInput, TOutput, TIssue extends BaseIssue<unknown>> = BaseSchema<TInput, TOutput, TIssue> | PipeAction<TInput, TOutput, TIssue>;
+/**
+ * Pipe item async type.
+ */
+type PipeItemAsync<TInput, TOutput, TIssue extends BaseIssue<unknown>> = BaseSchemaAsync<TInput, TOutput, TIssue> | PipeActionAsync<TInput, TOutput, TIssue>;
+
+/**
+ * Any schema interface.
+ */
+interface AnySchema extends BaseSchema<any, any, never> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'any';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof any;
+    /**
+     * The expected property.
+     */
+    readonly expects: 'any';
+}
+/**
+ * Creates an any schema.
+ *
+ * Hint: This schema function exists only for completeness and is not
+ * recommended in practice. Instead, `unknown` should be used to accept
+ * unknown data.
+ *
+ * @returns An any schema.
+ */
+declare function any(): AnySchema;
+
+/**
+ * Boolean issue interface.
+ */
+interface BooleanIssue extends BaseIssue<unknown> {
+    /**
+     * The issue kind.
+     */
+    readonly kind: 'schema';
+    /**
+     * The issue type.
+     */
+    readonly type: 'boolean';
+    /**
+     * The expected property.
+     */
+    readonly expected: 'boolean';
+}
+/**
+ * Boolean schema interface.
+ */
+interface BooleanSchema<TMessage extends ErrorMessage<BooleanIssue> | undefined> extends BaseSchema<boolean, boolean, BooleanIssue> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'boolean';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof boolean;
+    /**
+     * The expected property.
+     */
+    readonly expects: 'boolean';
+    /**
+     * The error message.
+     */
+    readonly message: TMessage;
+}
+/**
+ * Creates a boolean schema.
+ *
+ * @returns A boolean schema.
+ */
+declare function boolean(): BooleanSchema<undefined>;
+/**
+ * Creates a boolean schema.
+ *
+ * @param message The error message.
+ *
+ * @returns A boolean schema.
+ */
+declare function boolean<const TMessage extends ErrorMessage<BooleanIssue> | undefined>(message: TMessage): BooleanSchema<TMessage>;
+
+/**
+ * Exact optional schema interface.
+ */
+interface ExactOptionalSchema<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, TDefault extends Default<TWrapped, never>> extends BaseSchema<InferInput<TWrapped>, InferOutput<TWrapped>, InferIssue<TWrapped>> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'exact_optional';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof exactOptional;
+    /**
+     * The expected property.
+     */
+    readonly expects: TWrapped['expects'];
+    /**
+     * The wrapped schema.
+     */
+    readonly wrapped: TWrapped;
+    /**
+     * The default value.
+     */
+    readonly default: TDefault;
+}
+/**
+ * Creates an exact optional schema.
+ *
+ * @param wrapped The wrapped schema.
+ *
+ * @returns An exact optional schema.
+ */
+declare function exactOptional<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>>(wrapped: TWrapped): ExactOptionalSchema<TWrapped, undefined>;
+/**
+ * Creates an exact optional schema.
+ *
+ * @param wrapped The wrapped schema.
+ * @param default_ The default value.
+ *
+ * @returns An exact optional schema.
+ */
+declare function exactOptional<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, const TDefault extends Default<TWrapped, never>>(wrapped: TWrapped, default_: TDefault): ExactOptionalSchema<TWrapped, TDefault>;
+
+/**
+ * Exact optional schema async interface.
+ */
+interface ExactOptionalSchemaAsync<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TDefault extends DefaultAsync<TWrapped, never>> extends BaseSchemaAsync<InferInput<TWrapped>, InferOutput<TWrapped>, InferIssue<TWrapped>> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'exact_optional';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof exactOptional | typeof exactOptionalAsync;
+    /**
+     * The expected property.
+     */
+    readonly expects: TWrapped['expects'];
+    /**
+     * The wrapped schema.
+     */
+    readonly wrapped: TWrapped;
+    /**
+     * The default value.
+     */
+    readonly default: TDefault;
+}
+/**
+ * Creates an exact optional schema.
+ *
+ * @param wrapped The wrapped schema.
+ *
+ * @returns An exact optional schema.
+ */
+declare function exactOptionalAsync<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>>(wrapped: TWrapped): ExactOptionalSchemaAsync<TWrapped, undefined>;
+/**
+ * Creates an exact optional schema.
+ *
+ * @param wrapped The wrapped schema.
+ * @param default_ The default value.
+ *
+ * @returns An exact optional schema.
+ */
+declare function exactOptionalAsync<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, const TDefault extends DefaultAsync<TWrapped, never>>(wrapped: TWrapped, default_: TDefault): ExactOptionalSchemaAsync<TWrapped, TDefault>;
+
+/**
+ * Literal type.
+ */
+type Literal = bigint | boolean | number | string | symbol;
+/**
+ * Literal issue interface.
+ */
+interface LiteralIssue extends BaseIssue<unknown> {
+    /**
+     * The issue kind.
+     */
+    readonly kind: 'schema';
+    /**
+     * The issue type.
+     */
+    readonly type: 'literal';
+    /**
+     * The expected property.
+     */
+    readonly expected: string;
+}
+/**
+ * Literal schema interface.
+ */
+interface LiteralSchema<TLiteral extends Literal, TMessage extends ErrorMessage<LiteralIssue> | undefined> extends BaseSchema<TLiteral, TLiteral, LiteralIssue> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'literal';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof literal;
+    /**
+     * The literal value.
+     */
+    readonly literal: TLiteral;
+    /**
+     * The error message.
+     */
+    readonly message: TMessage;
+}
+/**
+ * Creates a literal schema.
+ *
+ * @param literal_ The literal value.
+ *
+ * @returns A literal schema.
+ */
+declare function literal<const TLiteral extends Literal>(literal_: TLiteral): LiteralSchema<TLiteral, undefined>;
+/**
+ * Creates a literal schema.
+ *
+ * @param literal_ The literal value.
+ * @param message The error message.
+ *
+ * @returns A literal schema.
+ */
+declare function literal<const TLiteral extends Literal, const TMessage extends ErrorMessage<LiteralIssue> | undefined>(literal_: TLiteral, message: TMessage): LiteralSchema<TLiteral, TMessage>;
+
+/**
+ * Union issue interface.
+ */
+interface UnionIssue<TSubIssue extends BaseIssue<unknown>> extends BaseIssue<unknown> {
+    /**
+     * The issue kind.
+     */
+    readonly kind: 'schema';
+    /**
+     * The issue type.
+     */
+    readonly type: 'union';
+    /**
+     * The expected property.
+     */
+    readonly expected: string;
+    /**
+     * The sub issues.
+     */
+    readonly issues?: [TSubIssue, ...TSubIssue[]];
+}
+
+/**
+ * Union options type.
+ */
+type UnionOptions = MaybeReadonly<BaseSchema<unknown, unknown, BaseIssue<unknown>>[]>;
+/**
+ * Union schema interface.
+ */
+interface UnionSchema<TOptions extends UnionOptions, TMessage extends ErrorMessage<UnionIssue<InferIssue<TOptions[number]>>> | undefined> extends BaseSchema<InferInput<TOptions[number]>, InferOutput<TOptions[number]>, UnionIssue<InferIssue<TOptions[number]>> | InferIssue<TOptions[number]>> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'union';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof union;
+    /**
+     * The union options.
+     */
+    readonly options: TOptions;
+    /**
+     * The error message.
+     */
+    readonly message: TMessage;
+}
+/**
+ * Creates an union schema.
+ *
+ * @param options The union options.
+ *
+ * @returns An union schema.
+ */
+declare function union<const TOptions extends UnionOptions>(options: TOptions): UnionSchema<TOptions, undefined>;
+/**
+ * Creates an union schema.
+ *
+ * @param options The union options.
+ * @param message The error message.
+ *
+ * @returns An union schema.
+ */
+declare function union<const TOptions extends UnionOptions, const TMessage extends ErrorMessage<UnionIssue<InferIssue<TOptions[number]>>> | undefined>(options: TOptions, message: TMessage): UnionSchema<TOptions, TMessage>;
+
+/**
+ * Infer nullish output type.
+ */
+type InferNullishOutput<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TDefault extends DefaultAsync<TWrapped, null | undefined>> = undefined extends TDefault ? InferOutput<TWrapped> | null | undefined : InferOutput<TWrapped> | Extract<DefaultValue<TDefault>, null | undefined>;
+
+/**
+ * Nullish schema interface.
+ */
+interface NullishSchema<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, TDefault extends Default<TWrapped, null | undefined>> extends BaseSchema<InferInput<TWrapped> | null | undefined, InferNullishOutput<TWrapped, TDefault>, InferIssue<TWrapped>> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'nullish';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof nullish;
+    /**
+     * The expected property.
+     */
+    readonly expects: `(${TWrapped['expects']} | null | undefined)`;
+    /**
+     * The wrapped schema.
+     */
+    readonly wrapped: TWrapped;
+    /**
+     * The default value.
+     */
+    readonly default: TDefault;
+}
+/**
+ * Creates a nullish schema.
+ *
+ * @param wrapped The wrapped schema.
+ *
+ * @returns A nullish schema.
+ */
+declare function nullish<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>>(wrapped: TWrapped): NullishSchema<TWrapped, undefined>;
+/**
+ * Creates a nullish schema.
+ *
+ * @param wrapped The wrapped schema.
+ * @param default_ The default value.
+ *
+ * @returns A nullish schema.
+ */
+declare function nullish<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, const TDefault extends Default<TWrapped, null | undefined>>(wrapped: TWrapped, default_: TDefault): NullishSchema<TWrapped, TDefault>;
+
+/**
+ * Nullish schema async interface.
+ */
+interface NullishSchemaAsync<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TDefault extends DefaultAsync<TWrapped, null | undefined>> extends BaseSchemaAsync<InferInput<TWrapped> | null | undefined, InferNullishOutput<TWrapped, TDefault>, InferIssue<TWrapped>> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'nullish';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof nullish | typeof nullishAsync;
+    /**
+     * The expected property.
+     */
+    readonly expects: `(${TWrapped['expects']} | null | undefined)`;
+    /**
+     * The wrapped schema.
+     */
+    readonly wrapped: TWrapped;
+    /**
+     * The default value.
+     */
+    readonly default: TDefault;
+}
+/**
+ * Creates a nullish schema.
+ *
+ * @param wrapped The wrapped schema.
+ *
+ * @returns A nullish schema.
+ */
+declare function nullishAsync<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>>(wrapped: TWrapped): NullishSchemaAsync<TWrapped, undefined>;
+/**
+ * Creates a nullish schema.
+ *
+ * @param wrapped The wrapped schema.
+ * @param default_ The default value.
+ *
+ * @returns A nullish schema.
+ */
+declare function nullishAsync<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, const TDefault extends DefaultAsync<TWrapped, null | undefined>>(wrapped: TWrapped, default_: TDefault): NullishSchemaAsync<TWrapped, TDefault>;
+
+/**
+ * Number issue interface.
+ */
+interface NumberIssue extends BaseIssue<unknown> {
+    /**
+     * The issue kind.
+     */
+    readonly kind: 'schema';
+    /**
+     * The issue type.
+     */
+    readonly type: 'number';
+    /**
+     * The expected property.
+     */
+    readonly expected: 'number';
+}
+/**
+ * Number schema interface.
+ */
+interface NumberSchema<TMessage extends ErrorMessage<NumberIssue> | undefined> extends BaseSchema<number, number, NumberIssue> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'number';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof number;
+    /**
+     * The expected property.
+     */
+    readonly expects: 'number';
+    /**
+     * The error message.
+     */
+    readonly message: TMessage;
+}
+/**
+ * Creates a number schema.
+ *
+ * @returns A number schema.
+ */
+declare function number(): NumberSchema<undefined>;
+/**
+ * Creates a number schema.
+ *
+ * @param message The error message.
+ *
+ * @returns A number schema.
+ */
+declare function number<const TMessage extends ErrorMessage<NumberIssue> | undefined>(message: TMessage): NumberSchema<TMessage>;
+
+/**
+ * Object issue interface.
+ */
+interface ObjectIssue extends BaseIssue<unknown> {
+    /**
+     * The issue kind.
+     */
+    readonly kind: 'schema';
+    /**
+     * The issue type.
+     */
+    readonly type: 'object';
+    /**
+     * The expected property.
+     */
+    readonly expected: 'Object' | `"${string}"`;
+}
+
+/**
+ * Object schema interface.
+ */
+interface ObjectSchema<TEntries extends ObjectEntries, TMessage extends ErrorMessage<ObjectIssue> | undefined> extends BaseSchema<InferObjectInput<TEntries>, InferObjectOutput<TEntries>, ObjectIssue | InferObjectIssue<TEntries>> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'object';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof object;
+    /**
+     * The expected property.
+     */
+    readonly expects: 'Object';
+    /**
+     * The entries schema.
+     */
+    readonly entries: TEntries;
+    /**
+     * The error message.
+     */
+    readonly message: TMessage;
+}
+/**
+ * Creates an object schema.
+ *
+ * Hint: This schema removes unknown entries. The output will only include the
+ * entries you specify. To include unknown entries, use `looseObject`. To
+ * return an issue for unknown entries, use `strictObject`. To include and
+ * validate unknown entries, use `objectWithRest`.
+ *
+ * @param entries The entries schema.
+ *
+ * @returns An object schema.
+ */
+declare function object<const TEntries extends ObjectEntries>(entries: TEntries): ObjectSchema<TEntries, undefined>;
+/**
+ * Creates an object schema.
+ *
+ * Hint: This schema removes unknown entries. The output will only include the
+ * entries you specify. To include unknown entries, use `looseObject`. To
+ * return an issue for unknown entries, use `strictObject`. To include and
+ * validate unknown entries, use `objectWithRest`.
+ *
+ * @param entries The entries schema.
+ * @param message The error message.
+ *
+ * @returns An object schema.
+ */
+declare function object<const TEntries extends ObjectEntries, const TMessage extends ErrorMessage<ObjectIssue> | undefined>(entries: TEntries, message: TMessage): ObjectSchema<TEntries, TMessage>;
+
+/**
+ * Infer optional output type.
+ */
+type InferOptionalOutput<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TDefault extends DefaultAsync<TWrapped, undefined>> = undefined extends TDefault ? InferOutput<TWrapped> | undefined : InferOutput<TWrapped> | Extract<DefaultValue<TDefault>, undefined>;
+
+/**
+ * Optional schema interface.
+ */
+interface OptionalSchema<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, TDefault extends Default<TWrapped, undefined>> extends BaseSchema<InferInput<TWrapped> | undefined, InferOptionalOutput<TWrapped, TDefault>, InferIssue<TWrapped>> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'optional';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof optional;
+    /**
+     * The expected property.
+     */
+    readonly expects: `(${TWrapped['expects']} | undefined)`;
+    /**
+     * The wrapped schema.
+     */
+    readonly wrapped: TWrapped;
+    /**
+     * The default value.
+     */
+    readonly default: TDefault;
+}
+/**
+ * Creates an optional schema.
+ *
+ * @param wrapped The wrapped schema.
+ *
+ * @returns An optional schema.
+ */
+declare function optional<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>>(wrapped: TWrapped): OptionalSchema<TWrapped, undefined>;
+/**
+ * Creates an optional schema.
+ *
+ * @param wrapped The wrapped schema.
+ * @param default_ The default value.
+ *
+ * @returns An optional schema.
+ */
+declare function optional<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, const TDefault extends Default<TWrapped, undefined>>(wrapped: TWrapped, default_: TDefault): OptionalSchema<TWrapped, TDefault>;
+
+/**
+ * Optional schema async interface.
+ */
+interface OptionalSchemaAsync<TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TDefault extends DefaultAsync<TWrapped, undefined>> extends BaseSchemaAsync<InferInput<TWrapped> | undefined, InferOptionalOutput<TWrapped, TDefault>, InferIssue<TWrapped>> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'optional';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof optional | typeof optionalAsync;
+    /**
+     * The expected property.
+     */
+    readonly expects: `(${TWrapped['expects']} | undefined)`;
+    /**
+     * The wrapped schema.
+     */
+    readonly wrapped: TWrapped;
+    /**
+     * The default value.
+     */
+    readonly default: TDefault;
+}
+/**
+ * Creates an optional schema.
+ *
+ * @param wrapped The wrapped schema.
+ *
+ * @returns An optional schema.
+ */
+declare function optionalAsync<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>>(wrapped: TWrapped): OptionalSchemaAsync<TWrapped, undefined>;
+/**
+ * Creates an optional schema.
+ *
+ * @param wrapped The wrapped schema.
+ * @param default_ The default value.
+ *
+ * @returns An optional schema.
+ */
+declare function optionalAsync<const TWrapped extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, const TDefault extends DefaultAsync<TWrapped, undefined>>(wrapped: TWrapped, default_: TDefault): OptionalSchemaAsync<TWrapped, TDefault>;
+
+/**
+ * Record issue interface.
+ */
+interface RecordIssue extends BaseIssue<unknown> {
+    /**
+     * The issue kind.
+     */
+    readonly kind: 'schema';
+    /**
+     * The issue type.
+     */
+    readonly type: 'record';
+    /**
+     * The expected property.
+     */
+    readonly expected: 'Object';
+}
+/**
+ * Is literal type.
+ */
+type IsLiteral<TKey extends string | number | symbol> = string extends TKey ? false : number extends TKey ? false : symbol extends TKey ? false : TKey extends Brand<string | number | symbol> ? false : true;
+/**
+ * Optional keys type.
+ */
+type OptionalKeys<TObject extends Record<string | number | symbol, unknown>> = {
+    [TKey in keyof TObject]: IsLiteral<TKey> extends true ? TKey : never;
+}[keyof TObject];
+/**
+ * With question marks type.
+ *
+ * Hint: We mark an entry as optional if we detect that its key is a literal
+ * type. The reason for this is that it is not technically possible to detect
+ * missing literal keys without restricting the key schema to `string`, `enum`
+ * and `picklist`. However, if `enum` and `picklist` are used, it is better to
+ * use `object` with `entriesFromList` because it already covers the needed
+ * functionality. This decision also reduces the bundle size of `record`,
+ * because it only needs to check the entries of the input and not any missing
+ * keys.
+ */
+type WithQuestionMarks<TObject extends Record<string | number | symbol, unknown>> = MarkOptional<TObject, OptionalKeys<TObject>>;
+/**
+ * With readonly type.
+ */
+type WithReadonly<TValue extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TObject extends WithQuestionMarks<Record<string | number | symbol, unknown>>> = TValue extends SchemaWithPipe<infer TPipe> | SchemaWithPipeAsync<infer TPipe> ? ReadonlyAction<any> extends TPipe[number] ? Readonly<TObject> : TObject : TObject;
+/**
+ * Infer record input type.
+ */
+type InferRecordInput<TKey extends BaseSchema<string, string | number | symbol, BaseIssue<unknown>> | BaseSchemaAsync<string, string | number | symbol, BaseIssue<unknown>>, TValue extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>> = Prettify<WithQuestionMarks<Record<InferInput<TKey>, InferInput<TValue>>>>;
+/**
+ * Infer record output type.
+ */
+type InferRecordOutput<TKey extends BaseSchema<string, string | number | symbol, BaseIssue<unknown>> | BaseSchemaAsync<string, string | number | symbol, BaseIssue<unknown>>, TValue extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>> = Prettify<WithReadonly<TValue, WithQuestionMarks<Record<InferOutput<TKey>, InferOutput<TValue>>>>>;
+
+/**
+ * Record schema interface.
+ */
+interface RecordSchema<TKey extends BaseSchema<string, string | number | symbol, BaseIssue<unknown>>, TValue extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, TMessage extends ErrorMessage<RecordIssue> | undefined> extends BaseSchema<InferRecordInput<TKey, TValue>, InferRecordOutput<TKey, TValue>, RecordIssue | InferIssue<TKey> | InferIssue<TValue>> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'record';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof record;
+    /**
+     * The expected property.
+     */
+    readonly expects: 'Object';
+    /**
+     * The record key schema.
+     */
+    readonly key: TKey;
+    /**
+     * The record value schema.
+     */
+    readonly value: TValue;
+    /**
+     * The error message.
      */
-    container?: {
-        mode?: "auto" | "floating" | "sidebar";
-        floatingConfig?: {
-            position?: {
-                top?: string;
-                left?: string;
-                right?: string;
-                bottom?: string;
-            };
-            width?: string;
-            height?: string;
-            borderRadius?: string;
-        };
-        sidebarConfig?: {
-            maxWidth?: string;
-            minViewportWidth?: number;
-        };
+    readonly message: TMessage;
+}
+/**
+ * Creates a record schema.
+ *
+ * @param key The key schema.
+ * @param value The value schema.
+ *
+ * @returns A record schema.
+ */
+declare function record<const TKey extends BaseSchema<string, string | number | symbol, BaseIssue<unknown>>, const TValue extends BaseSchema<unknown, unknown, BaseIssue<unknown>>>(key: TKey, value: TValue): RecordSchema<TKey, TValue, undefined>;
+/**
+ * Creates a record schema.
+ *
+ * @param key The key schema.
+ * @param value The value schema.
+ * @param message The error message.
+ *
+ * @returns A record schema.
+ */
+declare function record<const TKey extends BaseSchema<string, string | number | symbol, BaseIssue<unknown>>, const TValue extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, const TMessage extends ErrorMessage<RecordIssue> | undefined>(key: TKey, value: TValue, message: TMessage): RecordSchema<TKey, TValue, TMessage>;
+
+/**
+ * String issue interface.
+ */
+interface StringIssue extends BaseIssue<unknown> {
+    /**
+     * The issue kind.
+     */
+    readonly kind: 'schema';
+    /**
+     * The issue type.
+     */
+    readonly type: 'string';
+    /**
+     * The expected property.
+     */
+    readonly expected: 'string';
+}
+/**
+ * String schema interface.
+ */
+interface StringSchema<TMessage extends ErrorMessage<StringIssue> | undefined> extends BaseSchema<string, string, StringIssue> {
+    /**
+     * The schema type.
+     */
+    readonly type: 'string';
+    /**
+     * The schema reference.
+     */
+    readonly reference: typeof string;
+    /**
+     * The expected property.
+     */
+    readonly expects: 'string';
+    /**
+     * The error message.
+     */
+    readonly message: TMessage;
+}
+/**
+ * Creates a string schema.
+ *
+ * @returns A string schema.
+ */
+declare function string(): StringSchema<undefined>;
+/**
+ * Creates a string schema.
+ *
+ * @param message The error message.
+ *
+ * @returns A string schema.
+ */
+declare function string<const TMessage extends ErrorMessage<StringIssue> | undefined>(message: TMessage): StringSchema<TMessage>;
+
+/**
+ * Brand symbol.
+ */
+declare const BrandSymbol: unique symbol;
+/**
+ * Brand name type.
+ */
+type BrandName = string | number | symbol;
+/**
+ * Brand interface.
+ */
+interface Brand<TName extends BrandName> {
+    [BrandSymbol]: {
+        [TValue in TName]: TValue;
     };
 }
+
 /**
- * Google Analytics Event Message (iframe → parent)
- * Sent from edutap iframe to tap-kit-core for analytics tracking
+ * Readonly output type.
  */
-interface GAEventMessage {
-    type: "GA_EVENT";
-    payload: Record<string, unknown>;
+type ReadonlyOutput<TInput> = TInput extends Map<infer TKey, infer TValue> ? ReadonlyMap<TKey, TValue> : TInput extends Set<infer TValue> ? ReadonlySet<TValue> : Readonly<TInput>;
+/**
+ * Readonly action interface.
+ */
+interface ReadonlyAction<TInput> extends BaseTransformation<TInput, ReadonlyOutput<TInput>, never> {
+    /**
+     * The action type.
+     */
+    readonly type: 'readonly';
+    /**
+     * The action reference.
+     */
+    readonly reference: typeof readonly;
 }
+/**
+ * Creates a readonly transformation action.
+ *
+ * @returns A readonly action.
+ */
+declare function readonly<TInput>(): ReadonlyAction<TInput>;
 
 /**
  * Schema for CSS style properties
  * Allows any CSS property as string or number
  */
-declare const CSSStyleSchema: v.RecordSchema<v.StringSchema<undefined>, v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
+declare const CSSStyleSchema: RecordSchema<StringSchema<undefined>, UnionSchema<[StringSchema<undefined>, NumberSchema<undefined>], undefined>, undefined>;
 /**
  * Schema for AlarmElementProps
  * Supports common HTML attributes
  */
-declare const AlarmElementPropsSchema: v.ObjectSchema<{
-    readonly style: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, undefined>;
-    readonly className: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly src: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly alt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly href: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly target: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly type: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly placeholder: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly value: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly disabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+declare const AlarmElementPropsSchema: ObjectSchema<{
+    readonly style: OptionalSchema<RecordSchema<StringSchema<undefined>, UnionSchema<[StringSchema<undefined>, NumberSchema<undefined>], undefined>, undefined>, undefined>;
+    readonly className: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly id: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly src: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly alt: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly href: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly target: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly type: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly placeholder: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly value: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly disabled: OptionalSchema<BooleanSchema<undefined>, undefined>;
 }, undefined>;
 /**
  * Schema for AlarmElement (recursive)
  * Supports nested structure with children and payload
  */
-declare const AlarmElementSchema: v.GenericSchema<any>;
+declare const AlarmElementSchema: GenericSchema<any>;
 /**
  * Schema for AlarmMessageInstanceType (simplified)
  * Uses JSON Component Descriptor pattern
  * content includes UI + payload (for click handling)
  */
-declare const AlarmMessageInstanceSchema: v.ObjectSchema<{
-    readonly content: v.GenericSchema<any>;
-    readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+declare const AlarmMessageInstanceSchema: ObjectSchema<{
+    readonly content: GenericSchema<any>;
+    readonly duration: OptionalSchema<NumberSchema<undefined>, undefined>;
 }, undefined>;
-declare const TapReadySchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"tap:ready", undefined>;
-    readonly gaId: v.StringSchema<undefined>;
+declare const TapReadySchema: ObjectSchema<{
+    readonly type: LiteralSchema<"tap:ready", undefined>;
+    readonly gaId: StringSchema<undefined>;
 }, undefined>;
-declare const TapCloseSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"tap:close", undefined>;
+declare const TapCloseSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"tap:close", undefined>;
 }, undefined>;
-declare const TimelineSeekSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"timeline:seek", undefined>;
-    readonly clipId: v.StringSchema<undefined>;
-    readonly clipPlayHead: v.NumberSchema<undefined>;
+declare const TimelineSeekSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"timeline:seek", undefined>;
+    readonly clipId: StringSchema<undefined>;
+    readonly clipPlayHead: NumberSchema<undefined>;
 }, undefined>;
-declare const AlarmClickSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"alarm:click", undefined>;
-    readonly messageInfo: v.ObjectSchema<{
-        readonly content: v.GenericSchema<any>;
-        readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+declare const AlarmClickSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"alarm:click", undefined>;
+    readonly messageInfo: ObjectSchema<{
+        readonly content: GenericSchema<any>;
+        readonly duration: OptionalSchema<NumberSchema<undefined>, undefined>;
     }, undefined>;
 }, undefined>;
-declare const AlarmFadeInSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"alarm:fadeIn", undefined>;
-    readonly messageInfo: v.ObjectSchema<{
-        readonly content: v.GenericSchema<any>;
-        readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+declare const AlarmFadeInSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"alarm:fadeIn", undefined>;
+    readonly messageInfo: ObjectSchema<{
+        readonly content: GenericSchema<any>;
+        readonly duration: OptionalSchema<NumberSchema<undefined>, undefined>;
     }, undefined>;
 }, undefined>;
-declare const PopUpOpenSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"popUp:open", undefined>;
-    readonly popUpInfo: v.ObjectSchema<{
-        readonly html: v.StringSchema<undefined>;
-        readonly requestId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+declare const PopUpOpenSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"popUp:open", undefined>;
+    readonly popUpInfo: ObjectSchema<{
+        readonly html: StringSchema<undefined>;
+        readonly requestId: OptionalSchema<StringSchema<undefined>, undefined>;
     }, undefined>;
 }, undefined>;
-declare const PopUpCloseSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"popUp:close", undefined>;
+declare const PopUpCloseSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"popUp:close", undefined>;
 }, undefined>;
-declare const MaterialViewOpenSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"material:view:open", undefined>;
-    readonly materialId: v.StringSchema<undefined>;
-    readonly presignedUrl: v.StringSchema<undefined>;
-    readonly pageStart: v.NumberSchema<undefined>;
-    readonly pageEnd: v.NumberSchema<undefined>;
-    readonly nonce: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
+declare const MaterialViewOpenSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"material:view:open", undefined>;
+    readonly materialId: StringSchema<undefined>;
+    readonly presignedUrl: StringSchema<undefined>;
+    readonly pageStart: NumberSchema<undefined>;
+    readonly pageEnd: NumberSchema<undefined>;
+    readonly nonce: OptionalSchema<UnionSchema<[StringSchema<undefined>, NumberSchema<undefined>], undefined>, undefined>;
 }, undefined>;
-declare const MaterialViewCloseSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"material:view:close", undefined>;
+declare const MaterialViewCloseSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"material:view:close", undefined>;
 }, undefined>;
-declare const MaterialViewErrorSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"material:view:error", undefined>;
-    readonly materialId: v.StringSchema<undefined>;
-    readonly error: v.UnionSchema<[v.LiteralSchema<"fetch_failed", undefined>, v.LiteralSchema<"expired_url", undefined>, v.LiteralSchema<"extraction_failed", undefined>, v.LiteralSchema<"unknown", undefined>], undefined>;
-    readonly message: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+declare const MaterialViewErrorSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"material:view:error", undefined>;
+    readonly materialId: StringSchema<undefined>;
+    readonly error: UnionSchema<[LiteralSchema<"fetch_failed", undefined>, LiteralSchema<"expired_url", undefined>, LiteralSchema<"extraction_failed", undefined>, LiteralSchema<"unknown", undefined>], undefined>;
+    readonly message: OptionalSchema<StringSchema<undefined>, undefined>;
 }, undefined>;
-declare const ContainerModeChangeSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"container:mode:change", undefined>;
-    readonly mode: v.UnionSchema<[v.LiteralSchema<"floating", undefined>, v.LiteralSchema<"sidebar", undefined>], undefined>;
-    readonly nonce: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
+declare const ContainerModeChangeSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"container:mode:change", undefined>;
+    readonly mode: UnionSchema<[LiteralSchema<"floating", undefined>, LiteralSchema<"sidebar", undefined>], undefined>;
+    readonly nonce: OptionalSchema<UnionSchema<[StringSchema<undefined>, NumberSchema<undefined>], undefined>, undefined>;
 }, undefined>;
-declare const ContainerModeChangeAckSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"container:mode:change:ack", undefined>;
-    readonly success: v.BooleanSchema<undefined>;
-    readonly currentMode: v.UnionSchema<[v.LiteralSchema<"floating", undefined>, v.LiteralSchema<"sidebar", undefined>, v.LiteralSchema<"floating-forced", undefined>], undefined>;
-    readonly nonce: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
+declare const ContainerModeChangeAckSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"container:mode:change:ack", undefined>;
+    readonly success: BooleanSchema<undefined>;
+    readonly currentMode: UnionSchema<[LiteralSchema<"floating", undefined>, LiteralSchema<"sidebar", undefined>, LiteralSchema<"floating-forced", undefined>], undefined>;
+    readonly nonce: OptionalSchema<UnionSchema<[StringSchema<undefined>, NumberSchema<undefined>], undefined>, undefined>;
 }, undefined>;
-declare const ContainerLayoutStateChangedSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"container:layout:state:changed", undefined>;
-    readonly layoutState: v.UnionSchema<[v.LiteralSchema<"floating", undefined>, v.LiteralSchema<"sidebar", undefined>, v.LiteralSchema<"floating-forced", undefined>], undefined>;
+declare const ContainerLayoutStateChangedSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"container:layout:state:changed", undefined>;
+    readonly layoutState: UnionSchema<[LiteralSchema<"floating", undefined>, LiteralSchema<"sidebar", undefined>], undefined>;
+    readonly isNarrowViewport: OptionalSchema<BooleanSchema<undefined>, undefined>;
 }, undefined>;
-declare const ViewportResizeSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"viewport:resize", undefined>;
-    readonly viewportWidth: v.NumberSchema<undefined>;
+declare const ViewportResizeSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"viewport:resize", undefined>;
+    readonly viewportWidth: NumberSchema<undefined>;
 }, undefined>;
-declare const ConfigUpdateSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"config:update", undefined>;
-    readonly apiKey: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly hostOrigin: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly tapUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly apiUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly environment: v.OptionalSchema<v.UnionSchema<[v.LiteralSchema<"dev", undefined>, v.LiteralSchema<"prod", undefined>, v.LiteralSchema<"demo", undefined>, v.LiteralSchema<"staging", undefined>], undefined>, undefined>;
-    readonly language: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly userId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly courseId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly clipId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly clipPlayHead: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
-    readonly inline: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
-    readonly container: v.OptionalSchema<v.ObjectSchema<{
-        readonly mode: v.OptionalSchema<v.UnionSchema<[v.LiteralSchema<"auto", undefined>, v.LiteralSchema<"floating", undefined>, v.LiteralSchema<"sidebar", undefined>], undefined>, undefined>;
-        readonly floatingConfig: v.OptionalSchema<v.ObjectSchema<{
-            readonly position: v.OptionalSchema<v.ObjectSchema<{
-                readonly top: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-                readonly left: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-                readonly right: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-                readonly bottom: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+declare const ConfigUpdateSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"config:update", undefined>;
+    readonly apiKey: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly hostOrigin: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly tapUrl: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly apiUrl: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly environment: OptionalSchema<UnionSchema<[LiteralSchema<"dev", undefined>, LiteralSchema<"prod", undefined>, LiteralSchema<"demo", undefined>, LiteralSchema<"staging", undefined>], undefined>, undefined>;
+    readonly language: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly userId: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly courseId: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly clipId: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly clipPlayHead: OptionalSchema<NumberSchema<undefined>, undefined>;
+    readonly mode: OptionalSchema<UnionSchema<[LiteralSchema<"inline", undefined>, LiteralSchema<"floating", undefined>, LiteralSchema<"sidebar", undefined>], undefined>, undefined>;
+    readonly allowLayoutToggle: OptionalSchema<BooleanSchema<undefined>, undefined>;
+    readonly container: OptionalSchema<ObjectSchema<{
+        readonly floatingConfig: OptionalSchema<ObjectSchema<{
+            readonly position: OptionalSchema<ObjectSchema<{
+                readonly top: OptionalSchema<StringSchema<undefined>, undefined>;
+                readonly left: OptionalSchema<StringSchema<undefined>, undefined>;
+                readonly right: OptionalSchema<StringSchema<undefined>, undefined>;
+                readonly bottom: OptionalSchema<StringSchema<undefined>, undefined>;
             }, undefined>, undefined>;
-            readonly width: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly height: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly borderRadius: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly width: OptionalSchema<StringSchema<undefined>, undefined>;
+            readonly height: OptionalSchema<StringSchema<undefined>, undefined>;
+            readonly borderRadius: OptionalSchema<StringSchema<undefined>, undefined>;
         }, undefined>, undefined>;
-        readonly sidebarConfig: v.OptionalSchema<v.ObjectSchema<{
-            readonly maxWidth: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly minViewportWidth: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly sidebarConfig: OptionalSchema<ObjectSchema<{
+            readonly maxWidth: OptionalSchema<StringSchema<undefined>, undefined>;
+            readonly minViewportWidth: OptionalSchema<NumberSchema<undefined>, undefined>;
         }, undefined>, undefined>;
     }, undefined>, undefined>;
 }, undefined>;
-declare const GAEventSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"GA_EVENT", undefined>;
-    readonly payload: v.RecordSchema<v.StringSchema<undefined>, v.AnySchema, undefined>;
+declare const GAEventSchema: ObjectSchema<{
+    readonly type: LiteralSchema<"GA_EVENT", undefined>;
+    readonly payload: RecordSchema<StringSchema<undefined>, AnySchema, undefined>;
 }, undefined>;
-declare const TapMessageSchema: v.UnionSchema<[v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"tap:ready", undefined>;
-    readonly gaId: v.StringSchema<undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"tap:close", undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"timeline:seek", undefined>;
-    readonly clipId: v.StringSchema<undefined>;
-    readonly clipPlayHead: v.NumberSchema<undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"alarm:click", undefined>;
-    readonly messageInfo: v.ObjectSchema<{
-        readonly content: v.GenericSchema<any>;
-        readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+declare const TapMessageSchema: UnionSchema<[ObjectSchema<{
+    readonly type: LiteralSchema<"tap:ready", undefined>;
+    readonly gaId: StringSchema<undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"tap:close", undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"timeline:seek", undefined>;
+    readonly clipId: StringSchema<undefined>;
+    readonly clipPlayHead: NumberSchema<undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"alarm:click", undefined>;
+    readonly messageInfo: ObjectSchema<{
+        readonly content: GenericSchema<any>;
+        readonly duration: OptionalSchema<NumberSchema<undefined>, undefined>;
     }, undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"alarm:fadeIn", undefined>;
-    readonly messageInfo: v.ObjectSchema<{
-        readonly content: v.GenericSchema<any>;
-        readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"alarm:fadeIn", undefined>;
+    readonly messageInfo: ObjectSchema<{
+        readonly content: GenericSchema<any>;
+        readonly duration: OptionalSchema<NumberSchema<undefined>, undefined>;
     }, undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"popUp:open", undefined>;
-    readonly popUpInfo: v.ObjectSchema<{
-        readonly html: v.StringSchema<undefined>;
-        readonly requestId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"popUp:open", undefined>;
+    readonly popUpInfo: ObjectSchema<{
+        readonly html: StringSchema<undefined>;
+        readonly requestId: OptionalSchema<StringSchema<undefined>, undefined>;
     }, undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"popUp:close", undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"material:view:open", undefined>;
-    readonly materialId: v.StringSchema<undefined>;
-    readonly presignedUrl: v.StringSchema<undefined>;
-    readonly pageStart: v.NumberSchema<undefined>;
-    readonly pageEnd: v.NumberSchema<undefined>;
-    readonly nonce: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"material:view:close", undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"material:view:error", undefined>;
-    readonly materialId: v.StringSchema<undefined>;
-    readonly error: v.UnionSchema<[v.LiteralSchema<"fetch_failed", undefined>, v.LiteralSchema<"expired_url", undefined>, v.LiteralSchema<"extraction_failed", undefined>, v.LiteralSchema<"unknown", undefined>], undefined>;
-    readonly message: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"container:mode:change", undefined>;
-    readonly mode: v.UnionSchema<[v.LiteralSchema<"floating", undefined>, v.LiteralSchema<"sidebar", undefined>], undefined>;
-    readonly nonce: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"container:mode:change:ack", undefined>;
-    readonly success: v.BooleanSchema<undefined>;
-    readonly currentMode: v.UnionSchema<[v.LiteralSchema<"floating", undefined>, v.LiteralSchema<"sidebar", undefined>, v.LiteralSchema<"floating-forced", undefined>], undefined>;
-    readonly nonce: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"container:layout:state:changed", undefined>;
-    readonly layoutState: v.UnionSchema<[v.LiteralSchema<"floating", undefined>, v.LiteralSchema<"sidebar", undefined>, v.LiteralSchema<"floating-forced", undefined>], undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"viewport:resize", undefined>;
-    readonly viewportWidth: v.NumberSchema<undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"config:update", undefined>;
-    readonly apiKey: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly hostOrigin: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly tapUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly apiUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly environment: v.OptionalSchema<v.UnionSchema<[v.LiteralSchema<"dev", undefined>, v.LiteralSchema<"prod", undefined>, v.LiteralSchema<"demo", undefined>, v.LiteralSchema<"staging", undefined>], undefined>, undefined>;
-    readonly language: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly userId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly courseId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly clipId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly clipPlayHead: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
-    readonly inline: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
-    readonly container: v.OptionalSchema<v.ObjectSchema<{
-        readonly mode: v.OptionalSchema<v.UnionSchema<[v.LiteralSchema<"auto", undefined>, v.LiteralSchema<"floating", undefined>, v.LiteralSchema<"sidebar", undefined>], undefined>, undefined>;
-        readonly floatingConfig: v.OptionalSchema<v.ObjectSchema<{
-            readonly position: v.OptionalSchema<v.ObjectSchema<{
-                readonly top: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-                readonly left: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-                readonly right: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-                readonly bottom: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"popUp:close", undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"material:view:open", undefined>;
+    readonly materialId: StringSchema<undefined>;
+    readonly presignedUrl: StringSchema<undefined>;
+    readonly pageStart: NumberSchema<undefined>;
+    readonly pageEnd: NumberSchema<undefined>;
+    readonly nonce: OptionalSchema<UnionSchema<[StringSchema<undefined>, NumberSchema<undefined>], undefined>, undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"material:view:close", undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"material:view:error", undefined>;
+    readonly materialId: StringSchema<undefined>;
+    readonly error: UnionSchema<[LiteralSchema<"fetch_failed", undefined>, LiteralSchema<"expired_url", undefined>, LiteralSchema<"extraction_failed", undefined>, LiteralSchema<"unknown", undefined>], undefined>;
+    readonly message: OptionalSchema<StringSchema<undefined>, undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"container:mode:change", undefined>;
+    readonly mode: UnionSchema<[LiteralSchema<"floating", undefined>, LiteralSchema<"sidebar", undefined>], undefined>;
+    readonly nonce: OptionalSchema<UnionSchema<[StringSchema<undefined>, NumberSchema<undefined>], undefined>, undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"container:mode:change:ack", undefined>;
+    readonly success: BooleanSchema<undefined>;
+    readonly currentMode: UnionSchema<[LiteralSchema<"floating", undefined>, LiteralSchema<"sidebar", undefined>, LiteralSchema<"floating-forced", undefined>], undefined>;
+    readonly nonce: OptionalSchema<UnionSchema<[StringSchema<undefined>, NumberSchema<undefined>], undefined>, undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"container:layout:state:changed", undefined>;
+    readonly layoutState: UnionSchema<[LiteralSchema<"floating", undefined>, LiteralSchema<"sidebar", undefined>], undefined>;
+    readonly isNarrowViewport: OptionalSchema<BooleanSchema<undefined>, undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"viewport:resize", undefined>;
+    readonly viewportWidth: NumberSchema<undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"config:update", undefined>;
+    readonly apiKey: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly hostOrigin: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly tapUrl: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly apiUrl: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly environment: OptionalSchema<UnionSchema<[LiteralSchema<"dev", undefined>, LiteralSchema<"prod", undefined>, LiteralSchema<"demo", undefined>, LiteralSchema<"staging", undefined>], undefined>, undefined>;
+    readonly language: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly userId: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly courseId: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly clipId: OptionalSchema<StringSchema<undefined>, undefined>;
+    readonly clipPlayHead: OptionalSchema<NumberSchema<undefined>, undefined>;
+    readonly mode: OptionalSchema<UnionSchema<[LiteralSchema<"inline", undefined>, LiteralSchema<"floating", undefined>, LiteralSchema<"sidebar", undefined>], undefined>, undefined>;
+    readonly allowLayoutToggle: OptionalSchema<BooleanSchema<undefined>, undefined>;
+    readonly container: OptionalSchema<ObjectSchema<{
+        readonly floatingConfig: OptionalSchema<ObjectSchema<{
+            readonly position: OptionalSchema<ObjectSchema<{
+                readonly top: OptionalSchema<StringSchema<undefined>, undefined>;
+                readonly left: OptionalSchema<StringSchema<undefined>, undefined>;
+                readonly right: OptionalSchema<StringSchema<undefined>, undefined>;
+                readonly bottom: OptionalSchema<StringSchema<undefined>, undefined>;
             }, undefined>, undefined>;
-            readonly width: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly height: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly borderRadius: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly width: OptionalSchema<StringSchema<undefined>, undefined>;
+            readonly height: OptionalSchema<StringSchema<undefined>, undefined>;
+            readonly borderRadius: OptionalSchema<StringSchema<undefined>, undefined>;
         }, undefined>, undefined>;
-        readonly sidebarConfig: v.OptionalSchema<v.ObjectSchema<{
-            readonly maxWidth: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly minViewportWidth: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly sidebarConfig: OptionalSchema<ObjectSchema<{
+            readonly maxWidth: OptionalSchema<StringSchema<undefined>, undefined>;
+            readonly minViewportWidth: OptionalSchema<NumberSchema<undefined>, undefined>;
         }, undefined>, undefined>;
     }, undefined>, undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"GA_EVENT", undefined>;
-    readonly payload: v.RecordSchema<v.StringSchema<undefined>, v.AnySchema, undefined>;
+}, undefined>, ObjectSchema<{
+    readonly type: LiteralSchema<"GA_EVENT", undefined>;
+    readonly payload: RecordSchema<StringSchema<undefined>, AnySchema, undefined>;
 }, undefined>], undefined>;
 
 type TapMessageRecord = TapMessage;
 
-/**
- * Styling Types
- */
-type PositionType = {
-    top?: string;
-    left?: string;
-    right?: string;
-    bottom?: string;
-};
-/**
- * Container Layout State (SSOT - Visual State)
- *
- * This is the SINGLE SOURCE OF TRUTH for container visual state.
- * Managed by Container class (tap-kit-core), streamed to iframe via messages.
- *
- * - floating: User-chosen floating layout
- * - sidebar: User-chosen sidebar layout
- * - floating-forced: Forced floating due to narrow viewport (sidebar unavailable)
- *
- * Both tap-kit-core (Container) and edutap (UIConfigStore) use this type.
- * iframe receives this as read-only shadow state via container:layout:state:changed message.
- */
-type ContainerLayoutState = "floating" | "sidebar" | "floating-forced";
-/**
- * Container Mode (Behavior Configuration)
- *
- * Controls toggle button visibility and layout persistence:
- * - auto: User can toggle between layouts, remembers preference via localStorage (DEFAULT)
- * - floating: Fixed in floating layout, no toggle button, no persistence
- * - sidebar: Fixed in sidebar layout, no toggle button, no persistence
- */
-type ContainerMode = "auto" | "floating" | "sidebar";
-/**
- * Floating mode configuration
- * Includes position, size, and style settings for floating container
- */
-type FloatingConfig = {
-    /** Position (default: top: "50px", right: "24px") */
-    position?: PositionType;
-    /** Width (default: "340px") */
-    width?: string;
-    /** Height (default: "calc(100% - 116px)") */
-    height?: string;
-    /** Border radius (default: "16px") */
-    borderRadius?: string;
-    /** Expanded width for PDF viewer (default: "min(90vw, 1200px)") */
-    expandedWidth?: string;
-    /** Expanded height for PDF viewer (default: "90vh") */
-    expandedHeight?: string;
-    /** Expanded top position for PDF viewer (default: "5vh") */
-    expandedTop?: string;
-    /** Expanded right position for PDF viewer (default: "5vw") */
-    expandedRight?: string;
-};
-/**
- * Sidebar Configuration
- */
-type SidebarConfig = {
-    /** Maximum width of the sidebar (default: "min(50%, 1000px)") */
-    maxWidth?: string;
-    /** Expanded maximum width for PDF viewer (default: "min(70%, 1400px)") */
-    expandedMaxWidth?: string;
-    /** Minimum viewport width to enable sidebar mode (default: 768) */
-    minViewportWidth?: number;
-};
-/**
- * Container Configuration (SSOT - Type Level)
- *
- * This is the SINGLE SOURCE OF TRUTH for container configuration at the TYPE level.
- * - Public API: TapKitInitParams.container
- * - Internal: Container class configuration
- * - Protocol: ConfigUpdateMessage.container mirrors this structure
- *
- * When modifying this type, also update ConfigUpdateMessage.container in @coxwave/tap-messages
- *
- * @example
- * // Default: Auto mode with floating layout (toggle button visible)
- * const config: ContainerConfig = {}
- *
- * @example
- * // Auto mode with custom styling for both layouts
- * const config: ContainerConfig = {
- *   floatingConfig: { width: "400px", position: { top: "80px" } },
- *   sidebarConfig: { maxWidth: "800px" }
- * }
- *
- * @example
- * // Fixed floating mode (no toggle button)
- * const config: ContainerConfig = {
- *   mode: "floating",
- *   floatingConfig: { position: { top: "80px" }, width: "400px" }
- * }
- *
- * @example
- * // Fixed sidebar mode (no toggle button)
- * const config: ContainerConfig = {
- *   mode: "sidebar",
- *   sidebarConfig: { maxWidth: "500px" }
- * }
- *
- */
-type ContainerConfig = {
-    /**
-     * Container mode controls toggle button visibility and behavior (only for auto-created containers)
-     * - "auto" (default): User can toggle between layouts, starts in floating, remembers preference via localStorage
-     * - "floating": Fixed in floating layout, no toggle button
-     * - "sidebar": Fixed in sidebar layout, no toggle button
-     *
-     * NOTE: When user provides their own <tap-container>, mode is ignored and container is fully user-controlled
-     */
-    mode?: ContainerMode;
-    /** Floating layout configuration (applied when SDK auto-creates container in floating layout) */
-    floatingConfig?: FloatingConfig;
-    /** Sidebar layout configuration (applied when SDK auto-creates container in sidebar layout) */
-    sidebarConfig?: SidebarConfig;
-};
-
 /**
  * Core Configuration Types
  * Based on ConfigUpdateMessage protocol for type consistency (SSOT)
@@ -673,100 +2236,57 @@ type Course = {
     clipPlayHead?: number;
 };
 /**
- * SDK Initialization Parameters
+ * SDK Initialization Parameters (Legacy API)
+ *
+ * **Note:** This is for the legacy `new TapKit()` class API.
+ * For new projects, use `<tap-kit>` Web Component which supports
+ * container customization via attributes and properties.
  *
  * Button Options (choose one):
  * 1. buttonId: Attach to your own button element (provide element ID)
- * 2. <tap-button>: Use the built-in Web Component (omit buttonId)
- *
- * Container Mounting Options (Priority Resolution):
- * 1. containerId: Use existing <tap-container id="..."> element (explicit)
- * 2. container.parent: Mount iframe to custom parent with imperative API
- * 3. Auto-detect: Find existing <tap-container> in DOM
- * 4. Fallback: Auto-create container and mount to document.body (default)
- *
- * Debug Options:
- * - debug: Enable debug logging (overrides environment-based suppression)
+ * 2. Omit buttonId: SDK creates floating widget without button binding
  *
  * @example
  * ```typescript
- * const sdk = new TapSDK({ apiKey: "your-key" });
+ * const sdk = new TapKit({ apiKey: "your-key" });
  *
- * // Option 1: Use your own button element
+ * // With custom button
  * await sdk.init({
  *   buttonId: "my-chat-button",
  *   course: { userId: "user1", courseId: "course1", clipId: "clip1" }
  * });
  *
- * // Option 2: Use <tap-button> Web Component (recommended)
- * // HTML: <tap-button></tap-button>
- * await sdk.init({
- *   course: { userId: "user1", courseId: "course1", clipId: "clip1" }
- * });
- *
- * // Option 3: Explicit container by ID
- * // HTML: <tap-container id="my-chat-container"></tap-container>
+ * // Without button (floating widget)
  * await sdk.init({
- *   containerId: "my-chat-container",
  *   course: { userId: "user1", courseId: "course1", clipId: "clip1" }
  * });
  *
- * // Option 4: Custom parent element (imperative API)
- * await sdk.init({
- *   course: { userId: "user1", courseId: "course1", clipId: "clip1" },
- *   container: {
- *     parent: document.querySelector('#my-container'),
- *     floatingConfig: { width: "100%", height: "100%" }
- *   }
- * });
- *
- * // Custom floating container
- * await sdk.init({
- *   buttonId: "tap-button",
- *   course: { userId: "user1", courseId: "course1", clipId: "clip1" },
- *   container: {
- *     mode: "floating",
- *     floatingConfig: {
- *       position: { top: "80px", right: "32px" },
- *       width: "400px"
- *     }
- *   }
- * });
- *
- * // Sidebar mode with custom width
- * await sdk.init({
- *   buttonId: "tap-button",
- *   course: { userId: "user1", courseId: "course1", clipId: "clip1" },
- *   container: {
- *     mode: "sidebar",
- *     sidebarConfig: { maxWidth: "800px" }
- *   }
- * });
- *
- * // Enable debug logging (useful for production debugging)
+ * // Enable debug logging
  * await sdk.init({
  *   course: { userId: "user1", courseId: "course1", clipId: "clip1" },
  *   debug: true
  * });
  * ```
+ *
+ * @deprecated Use `<tap-kit>` Web Component for container customization:
+ * ```html
+ * <tap-kit
+ *   user-id="user1"
+ *   course-id="course1"
+ *   clip-id="clip1"
+ *   mode="sidebar"
+ * ></tap-kit>
+ * ```
  */
 type TapKitInitParams = {
     /**
      * Element ID of your custom button (optional)
-     * If omitted, SDK will use <tap-button> Web Component
+     * If omitted, SDK creates floating widget without button binding
      * @see https://edutap-ai-docs.vercel.app/docs/sdk/button
      */
     buttonId?: string;
-    /**
-     * Element ID of existing <tap-container> element (optional)
-     * If provided, SDK will use this specific container instead of auto-detection
-     * Useful when you have multiple containers or need explicit control
-     * @see https://edutap-ai-docs.vercel.app/docs/sdk/container
-     */
-    containerId?: string;
+    /** Course information (required) */
     course: Course;
-    /** Container configuration (optional, uses defaults if omitted) */
-    container?: ContainerConfig;
     /**
      * Enable debug logging (optional)
      * When true, forces debug logs to show even in production/demo environments
@@ -948,6 +2468,72 @@ interface TapKitInstance {
 /** TapKit constructor type */
 type TapKitConstructor = new (config: TapKitConfig) => TapKitInstance;
 
+/**
+ * Styling Types
+ */
+type PositionType = {
+    top?: string;
+    left?: string;
+    right?: string;
+    bottom?: string;
+};
+/**
+ * Floating mode configuration
+ * Includes position, size, and style settings for floating container
+ */
+type FloatingConfig = {
+    /** Position (default: top: "50px", right: "24px") */
+    position?: PositionType;
+    /** Width (default: "340px") */
+    width?: string;
+    /** Height (default: "calc(100% - 116px)") */
+    height?: string;
+    /** Border radius (default: "16px") */
+    borderRadius?: string;
+    /** Expanded width for PDF viewer (default: "min(90vw, 1200px)") */
+    expandedWidth?: string;
+    /** Expanded height for PDF viewer (default: "90vh") */
+    expandedHeight?: string;
+    /** Expanded top position for PDF viewer (default: "5vh") */
+    expandedTop?: string;
+    /** Expanded right position for PDF viewer (default: "5vw") */
+    expandedRight?: string;
+};
+/**
+ * Sidebar Configuration
+ */
+type SidebarConfig = {
+    /** Maximum width of the sidebar (default: "min(50%, 1000px)") */
+    maxWidth?: string;
+    /** Expanded maximum width for PDF viewer (default: "min(70%, 1400px)") */
+    expandedMaxWidth?: string;
+    /** Minimum viewport width to enable sidebar mode (default: 768) */
+    minViewportWidth?: number;
+};
+/**
+ * Container Configuration (SSOT - Type Level)
+ *
+ * This is the SINGLE SOURCE OF TRUTH for container configuration at the TYPE level.
+ * - Public API: TapKitInitParams.container
+ * - Internal: Container class configuration
+ * - Protocol: ConfigUpdateMessage.container mirrors this structure
+ *
+ * When modifying this type, also update ConfigUpdateMessage.container in @coxwave/tap-messages
+ *
+ * @example
+ * // Custom styling for floating/sidebar modes
+ * const config: ContainerConfig = {
+ *   floatingConfig: { width: "400px", position: { top: "80px" } },
+ *   sidebarConfig: { maxWidth: "800px" }
+ * }
+ */
+type ContainerConfig = {
+    /** Floating layout configuration (applied when SDK auto-creates container in floating layout) */
+    floatingConfig?: FloatingConfig;
+    /** Sidebar layout configuration (applied when SDK auto-creates container in sidebar layout) */
+    sidebarConfig?: SidebarConfig;
+};
+
 /**
  * Type declarations for <tap-button> Web Component
  *
@@ -1333,9 +2919,6 @@ interface TapKitElement extends HTMLElement {
   /** Custom button element ID (optional) */
   buttonId?: string;
 
-  /** Custom container element ID (optional) */
-  containerId?: string;
-
   /** Enable debug mode (optional, default: false) */
   debug: boolean;
 
@@ -1467,6 +3050,9 @@ interface TapKitAttributes {
   /** React key for list rendering */
   key?: string | number;
 
+  /** React ref for element access */
+  ref?: React.Ref<TapKitElement>;
+
   /** Element ID attribute */
   id?: string;
 
@@ -1795,4 +3381,4 @@ declare global {
   function cancelIdleCallback(handle: number): void;
 }
 
-export { ALARM_DURATION, type AlarmClickMessage, AlarmClickSchema, type AlarmElement, type AlarmElementProps, AlarmElementPropsSchema, AlarmElementSchema, type AlarmFadeInMessage, AlarmFadeInSchema, AlarmMessageInstanceSchema, type AlarmMessageInstanceType, type AlarmPayload, type AlarmType, type CSSStyle, CSSStyleSchema, type ConfigUpdateMessage, ConfigUpdateSchema, type ContainerConfig, type ContainerLayoutState, type ContainerLayoutStateChangedMessage, ContainerLayoutStateChangedSchema, type ContainerMode, type ContainerModeChangeAckMessage, ContainerModeChangeAckSchema, type ContainerModeChangeMessage, ContainerModeChangeSchema, type ContainerVisibility, type Course, type EventManager, type FloatingConfig, type GAEventMessage, GAEventSchema, type ITapButtonElement, type ITapContainerElement, type ITapKitElement, type ITapMaterialViewerElement, TapKitInitializationError as InitializationError, type MaterialViewCloseMessage, MaterialViewCloseSchema, type MaterialViewConfig, type MaterialViewErrorMessage, MaterialViewErrorSchema, type MaterialViewOpenMessage, MaterialViewOpenSchema, MaterialViewerError, type PopUpCloseMessage, PopUpCloseSchema, type PopUpOpenMessage, PopUpOpenSchema, type PositionType, type SeekTimelineParamsType, type ShortcutKeyPropertiesType, type SidebarConfig, TAP_BUTTON_CLICK_EVENT, TAP_ERROR_MARKER, type TapButtonAttributes, type TapButtonClickEventDetail, type TapCloseMessage, TapCloseSchema, type TapContainerAttributes, type TapErrorOptions, type TapKitConfig, type TapKitConfigOptions, TapKitConfigurationError, type TapKitConstructor, type TapKitElement, type TapKitElementEventMap, TapKitError, TapKitIframeError, type TapKitInitParams, TapKitInitializationError, type TapKitInstance, TapKitLoaderError, TapKitMessageError, type TapKitRuntimeConfig, type TapMaterialViewerAttributes, type TapMessage, type TapMessageRecord, TapMessageSchema, type TapMessageType, type TapReadyMessage, TapReadySchema, type TimelineSeekMessage, TimelineSeekSchema, type VideoController, type VideoPlayerAdapter, type VideoPlayerConfig, type ViewportResizeMessage, ViewportResizeSchema };
+export { ALARM_DURATION, type AlarmClickMessage, AlarmClickSchema, type AlarmElement, type AlarmElementProps, AlarmElementPropsSchema, AlarmElementSchema, type AlarmFadeInMessage, AlarmFadeInSchema, AlarmMessageInstanceSchema, type AlarmMessageInstanceType, type AlarmPayload, type AlarmType, type CSSStyle, CSSStyleSchema, type ConfigUpdateMessage, ConfigUpdateSchema, type ContainerConfig, type ContainerLayoutStateChangedMessage, ContainerLayoutStateChangedSchema, type ContainerModeChangeAckMessage, ContainerModeChangeAckSchema, type ContainerModeChangeMessage, ContainerModeChangeSchema, type ContainerVisibility, type Course, type EventManager, type FloatingConfig, type GAEventMessage, GAEventSchema, type ITapButtonElement, type ITapContainerElement, type ITapKitElement, type ITapMaterialViewerElement, TapKitInitializationError as InitializationError, type MaterialViewCloseMessage, MaterialViewCloseSchema, type MaterialViewConfig, type MaterialViewErrorMessage, MaterialViewErrorSchema, type MaterialViewOpenMessage, MaterialViewOpenSchema, MaterialViewerError, type PopUpCloseMessage, PopUpCloseSchema, type PopUpOpenMessage, PopUpOpenSchema, type PositionType, type SeekTimelineParamsType, type ShortcutKeyPropertiesType, type SidebarConfig, TAP_BUTTON_CLICK_EVENT, TAP_ERROR_MARKER, type TapButtonAttributes, type TapButtonClickEventDetail, type TapCloseMessage, TapCloseSchema, type TapContainerAttributes, type TapErrorOptions, type TapKitConfig, type TapKitConfigOptions, TapKitConfigurationError, type TapKitConstructor, type TapKitElement, type TapKitElementEventMap, TapKitError, TapKitIframeError, type TapKitInitParams, TapKitInitializationError, type TapKitInstance, TapKitLoaderError, TapKitMessageError, type TapKitRuntimeConfig, type TapMaterialViewerAttributes, type TapMessage, type TapMessageRecord, TapMessageSchema, type TapMessageType, type TapReadyMessage, TapReadySchema, type TimelineSeekMessage, TimelineSeekSchema, type VideoController, type VideoPlayerAdapter, type VideoPlayerConfig, type ViewportResizeMessage, ViewportResizeSchema };