soseki 0.0.5 → 0.0.7

package/dist/src/core/_unreachable.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 網羅性チェックにおいて、プログラムの制御フローが理論上決して到達しないはずの場所に達したことを示すための関数です。
+ */
+declare function unreachable(): never;
+/**
+ * 網羅性チェックにおいて、プログラムの制御フローが理論上決して到達しないはずの場所に達したことを示すための関数です。
+ *
+ * * `switch` 文の `default` 句などでこの関数に値を渡すことにより、すべての列挙型やユニオン型のケースが処理し尽くされているかを静的に検証します。
+ *
+ * 漏れがある場合、TypeScript は引数が `never` 型に適合しないというコンパイルエラーを報告します。
+ *
+ * @param value すべての分岐が処理された結果として、理論上 `never` 型になっているべき変数です。
+ */
+declare function unreachable(value: never): never;
+export default unreachable;
+//# sourceMappingURL=_unreachable.d.ts.map

package/dist/src/core/_unreachable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_unreachable.d.ts","sourceRoot":"","sources":["../../../src/core/_unreachable.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,iBAAS,WAAW,IAAI,KAAK,CAAC;AAE9B;;;;;;;;GAQG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC;AAQ1C,eAAe,WAAW,CAAC"}

package/dist/src/core/_unreachable.js

@@ -0,0 +1,8 @@
+import { tryCaptureStackTrace } from "try-capture-stack-trace";
+import { UnreachableError } from "./errors.js";
+function unreachable(...actual) {
+    const error = new UnreachableError({ actual });
+    tryCaptureStackTrace(error, unreachable);
+    throw error;
+}
+export default unreachable;

package/dist/src/core/_valibot.d.ts

@@ -0,0 +1,25 @@
+import { type InferOutput, safeParse } from "valibot";
+/***************************************************************************************************
+ *
+ * 再エクスポート
+ *
+ **************************************************************************************************/
+export { url, pipe, uuid, brand, number, string, minValue, nullable, safeInteger } from "valibot";
+export type { InferInput, InferOutput } from "valibot";
+export { object, transform } from "@tai-kun/valibot-extra-lab";
+/***************************************************************************************************
+ *
+ * expect
+ *
+ **************************************************************************************************/
+type BaseSchema = typeof safeParse extends (schema: infer TSchema, ...args: any) => any ? TSchema : never;
+/**
+ * 指定されたスキーマに基づいて入力値の構造を検証し、成功した場合は型安全に解析済みの値を出力します。
+ *
+ * @template TSchema 評価に使用する `valibot` 形式のスキーマ定義型です。
+ * @param schema 入力値を検証するためのスキーマ定義オブジェクトです。
+ * @param input 整合性を検証する対象となる未知のデータです。
+ * @returns スキマの定義に完全に合致し、型付けが完了した解析済みの出力データを返します。
+ */
+export declare function expect<const TSchema extends BaseSchema>(schema: TSchema, input: unknown): InferOutput<TSchema>;
+//# sourceMappingURL=_valibot.d.ts.map

package/dist/src/core/_valibot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_valibot.d.ts","sourceRoot":"","sources":["../../../src/core/_valibot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAItD;;;;oGAIoG;AAEpG,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClG,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;;oGAIoG;AAEpG,KAAK,UAAU,GAAG,OAAO,SAAS,SAAS,CAAC,MAAM,EAAE,MAAM,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,GACnF,OAAO,GACP,KAAK,CAAC;AAEV;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,OAAO,SAAS,UAAU,EACrD,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,OAAO,GACb,WAAW,CAAC,OAAO,CAAC,CAYtB"}

package/dist/src/core/_valibot.js

@@ -0,0 +1,30 @@
+import { tryCaptureStackTrace } from "try-capture-stack-trace";
+import { safeParse } from "valibot";
+import { UnexpectedValidationError } from "./errors.js";
+/***************************************************************************************************
+ *
+ * 再エクスポート
+ *
+ **************************************************************************************************/
+export { url, pipe, uuid, brand, number, string, minValue, nullable, safeInteger } from "valibot";
+export { object, transform } from "@tai-kun/valibot-extra-lab";
+/**
+ * 指定されたスキーマに基づいて入力値の構造を検証し、成功した場合は型安全に解析済みの値を出力します。
+ *
+ * @template TSchema 評価に使用する `valibot` 形式のスキーマ定義型です。
+ * @param schema 入力値を検証するためのスキーマ定義オブジェクトです。
+ * @param input 整合性を検証する対象となる未知のデータです。
+ * @returns スキマの定義に完全に合致し、型付けが完了した解析済みの出力データを返します。
+ */
+export function expect(schema, input) {
+    const result = safeParse(schema, input);
+    if (result.success) {
+        return result.output;
+    }
+    const error = new UnexpectedValidationError({
+        value: input,
+        issues: result.issues,
+    });
+    tryCaptureStackTrace(error, expect);
+    throw error;
+}

package/dist/src/core/errors.d.ts

@@ -0,0 +1,182 @@
+import { type ErrorMeta, type ErrorOptions, I18nErrorBase, setErrorMessage } from "i18n-error-base";
+import type { BaseIssue } from "valibot";
+/**************************************************************************************************/
+export type { ErrorMeta, ErrorOptions };
+export { setErrorMessage };
+/**************************************************************************************************/
+/**
+ * データ検証の過程で検出された具体的な問題点を表す型定義です。
+ *
+ * 外部のスキーマ検証ライブラリーである `valibot` の `BaseIssue` を基盤としています。
+ */
+export type Issue = BaseIssue<unknown>;
+/**************************************************************************************************/
+/**
+ * soseki ルーティングライブラリーにおける、すべてのカスタムエラーの頂点に位置する基底クラスです。
+ *
+ * @template TMeta エラーの発生コンテキストを保持するために紐付けるメタデータオブジェクトの型定義です。
+ */
+export declare class ErrorBase<TMeta extends ErrorMeta | undefined = undefined> extends I18nErrorBase<TMeta> {
+}
+/**************************************************************************************************/
+/**
+ * プログラムの制御フローにおいて、理論上到達しないはずのコード領域へ侵入した際に付与されるメタデータの型定義です。
+ */
+export type UnreachableErrorMeta = {
+    /**
+     * 網羅性チェックをすり抜けて、実行時に入り込んできた予期せぬ不正な値です。
+     */
+    readonly value?: unknown;
+};
+/**
+ * `UnreachableError` のインスタンスを初期化する際に渡される引数オブジェクトの型定義です。
+ */
+export type UnreachableErrorArgs = ErrorOptions & {
+    /**
+     * 網羅性検証において `never` 型となるべき変数を格納した、要素数 1 のタプルまたは空の配列です。
+     */
+    readonly actual: [never?];
+};
+/**
+ * 網羅性チェックにおいて、プログラムの制御フローが理論上決して到達しないはずの場所に達した場合に投げるエラーです。
+ */
+export declare class UnreachableError extends ErrorBase<UnreachableErrorMeta> {
+    /**
+     * `UnreachableError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param args エラーオプションおよび実行時に混入した実際の値を含む引数オブジェクトです。
+     */
+    constructor(args: UnreachableErrorArgs);
+}
+/**************************************************************************************************/
+/**
+ * データ検証の失敗に関連するエラーを集約するための共通基底クラスです。
+ *
+ * @template TMeta エラーに紐づく、検証結果の問題点などのメタデータ型定義です。
+ */
+export declare class ValidationErrorBase<TMeta extends ErrorMeta | undefined = ErrorMeta | undefined> extends ErrorBase<TMeta> {
+}
+/**************************************************************************************************/
+/**
+ * 予期しないデータ構造や型に遭遇した際に付与される、検証エラー情報のメタデータ型定義です。
+ */
+export type UnexpectedValidationErrorMeta = {
+    /**
+     * スキーマ検証によって不適合と判定された問題点のリストです。最低 1 つ以上の要素を持つことが保証された読み取り専用の配列です。
+     */
+    readonly issues: readonly [Issue, ...Issue[]];
+    /**
+     * 検証の対象となった、予期しない生の入力値です。
+     */
+    readonly value: unknown;
+};
+/**
+ * `UnexpectedValidationError` のインスタンスを初期化する際に渡される引数オブジェクトの型定義です。
+ */
+export type UnexpectedValidationErrorArgs = ErrorOptions & UnexpectedValidationErrorMeta;
+/**
+ * スキーマによるデータ構造の検証において、予期しない形式の値に遭遇した場合に投げるエラーです。
+ */
+export declare class UnexpectedValidationError extends ValidationErrorBase<UnexpectedValidationErrorMeta> {
+    /**
+     * `UnexpectedValidationError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param args エラーオプション、入力値、および検出された不適合箇所の一覧を含む引数オブジェクトです。
+     */
+    constructor(args: UnexpectedValidationErrorArgs);
+}
+/**************************************************************************************************/
+/**
+ * ブラウザー標準の Navigation API が、現在の実行環境でサポートされていない場合に投げるエラーです。
+ */
+export declare class NavigationApiNotSupportedError extends ErrorBase<undefined> {
+    /**
+     * `NavigationApiNotSupportedError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param options エラーの共通オプションです。
+     */
+    constructor(options?: ErrorOptions);
+}
+/**************************************************************************************************/
+/**
+ * データの再読み込み判定において、不正なデータ型が検出された際に付与されるメタデータの型定義です。
+ */
+export type LoaderConditionErrorMeta = {
+    /**
+     * エラーが発生した対象ルートの URL パス文字列です。
+     */
+    readonly url: string;
+    /**
+     * 不正な値を返した対象の `shouldReload` 関数の参照です。
+     */
+    readonly shouldReload: Function;
+    /**
+     * `shouldReload` 関数が実際に返した、期待値とは異なるオブジェクトやプリミティブ値です。
+     */
+    readonly returnValue: unknown;
+};
+/**
+ * `LoaderConditionError` のインスタンスを初期化する際に渡される引数オブジェクトの型定義です。
+ */
+export type LoaderConditionErrorArgs = ErrorOptions & LoaderConditionErrorMeta;
+/**
+ * ユーザーが定義した `shouldReload` 関数が、仕様に準拠した同期的な真偽値ではなく、不正な値を返した場合に投げるエラーです。
+ */
+export declare class LoaderConditionError extends ErrorBase<LoaderConditionErrorMeta> {
+    /**
+     * `LoaderConditionError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param args エラーオプション、対象URL、関数の参照、および実際の戻り値を含む引数オブジェクトです。
+     */
+    constructor(args: LoaderConditionErrorArgs);
+}
+/**************************************************************************************************/
+/**
+ * ルーター全体の共通状態 `RouterContext` が、React のコンポーネントツリー内の上位から供給されていない場合に投げるエラーです。
+ */
+export declare class RouterContextMissingError extends ErrorBase<undefined> {
+    /**
+     * `RouterContextMissingError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param options エラーの共通オプションです。
+     */
+    constructor(options?: ErrorOptions);
+}
+/**************************************************************************************************/
+/**
+ * 個々のルート固有の状態 `RouteContext` が、React のコンポーネントツリー内の上位から供給されていない場合に投げるエラーです。
+ */
+export declare class RouteContextMissingError extends ErrorBase<undefined> {
+    /**
+     * `RouteContextMissingError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param options エラーの共通オプションです。
+     */
+    constructor(options?: ErrorOptions);
+}
+/**************************************************************************************************/
+/**
+ * ローダーデータの紛失を通知する際に付与されるメタデータの型定義です。
+ */
+export type LoaderDataNotFoundErrorMeta = {
+    /**
+     * データの取得を試みた対象のローダー関数の参照です。未定義の場合は `undefined` となることがあります。
+     */
+    readonly loader: Function | undefined;
+};
+/**
+ * `LoaderDataNotFoundError` のインスタンスを初期化する際に渡される引数オブジェクトの型定義です。
+ */
+export type LoaderDataNotFoundErrorArgs = ErrorOptions & LoaderDataNotFoundErrorMeta;
+/**
+ * ルートに紐づくデータ取得用のローダー関数が正常に処理されたはずであるにもかかわらず、該当するキャッシュデータや応答結果が見つからない場合に投げるエラーです。
+ */
+export declare class LoaderDataNotFoundError extends ErrorBase<LoaderDataNotFoundErrorMeta> {
+    /**
+     * `LoaderDataNotFoundError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param args エラーオプションおよび対象ローダー関数の参照を含む引数オブジェクトです。
+     */
+    constructor(args: LoaderDataNotFoundErrorArgs);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"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"}

package/dist/src/core/errors.js

@@ -0,0 +1,166 @@
+var _a, _b, _c, _d, _e, _f, _g;
+import { I18nErrorBase, setErrorMessage } from "i18n-error-base";
+import { inspect } from "inspect-lite";
+import { isThenable } from "maypromise";
+import getTypeName from "type-name";
+export { setErrorMessage };
+/**************************************************************************************************/
+/**
+ * soseki ルーティングライブラリーにおける、すべてのカスタムエラーの頂点に位置する基底クラスです。
+ *
+ * @template TMeta エラーの発生コンテキストを保持するために紐付けるメタデータオブジェクトの型定義です。
+ */
+export class ErrorBase extends I18nErrorBase {
+}
+/**
+ * 網羅性チェックにおいて、プログラムの制御フローが理論上決して到達しないはずの場所に達した場合に投げるエラーです。
+ */
+export class UnreachableError extends ErrorBase {
+    /**
+     * `UnreachableError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param args エラーオプションおよび実行時に混入した実際の値を含む引数オブジェクトです。
+     */
+    constructor(args) {
+        const { actual, ...options } = args;
+        super(actual.length > 0 ? { value: actual[0] } : {}, (meta) => "value" in meta
+            ? "Encountered impossible value: " + inspect(meta.value)
+            : "Unreachable code reached", options);
+    }
+}
+_a = UnreachableError;
+(() => {
+    _a.prototype.name = "SosekiUnreachableError";
+})();
+/*#__PURE__*/ setErrorMessage(UnreachableError, (meta) => "value" in meta
+    ? "不可能な値に遭遇しました: " + inspect(meta.value)
+    : "到達できないコードに到達しました", "ja");
+/**************************************************************************************************/
+/**
+ * データ検証の失敗に関連するエラーを集約するための共通基底クラスです。
+ *
+ * @template TMeta エラーに紐づく、検証結果の問題点などのメタデータ型定義です。
+ */
+export class ValidationErrorBase extends ErrorBase {
+}
+/**
+ * スキーマによるデータ構造の検証において、予期しない形式の値に遭遇した場合に投げるエラーです。
+ */
+export class UnexpectedValidationError extends ValidationErrorBase {
+    /**
+     * `UnexpectedValidationError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param args エラーオプション、入力値、および検出された不適合箇所の一覧を含む引数オブジェクトです。
+     */
+    constructor(args) {
+        const { value, issues, ...options } = args;
+        super({ value, issues }, ({ issues }) => issues.map((issue) => issue.message).join(": "), options);
+    }
+}
+_b = UnexpectedValidationError;
+(() => {
+    _b.prototype.name = "SosekiUnexpectedValidationError";
+})();
+/**************************************************************************************************/
+/**
+ * ブラウザー標準の Navigation API が、現在の実行環境でサポートされていない場合に投げるエラーです。
+ */
+export class NavigationApiNotSupportedError extends ErrorBase {
+    /**
+     * `NavigationApiNotSupportedError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param options エラーの共通オプションです。
+     */
+    constructor(options) {
+        super("The Navigation API is not supported in this environment", options);
+    }
+}
+_c = NavigationApiNotSupportedError;
+(() => {
+    _c.prototype.name = "SosekiNavigationApiNotSupportedError";
+})();
+/*#__PURE__*/ setErrorMessage(NavigationApiNotSupportedError, "現在の環境では Navigation API がサポートされていません", "ja");
+/**
+ * ユーザーが定義した `shouldReload` 関数が、仕様に準拠した同期的な真偽値ではなく、不正な値を返した場合に投げるエラーです。
+ */
+export class LoaderConditionError extends ErrorBase {
+    /**
+     * `LoaderConditionError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param args エラーオプション、対象URL、関数の参照、および実際の戻り値を含む引数オブジェクトです。
+     */
+    constructor(args) {
+        const { url, returnValue, shouldReload, ...options } = args;
+        super({ url, returnValue, shouldReload }, ({ returnValue }) => isThenable(returnValue)
+            ? "shouldReload must return a boolean value synchronously"
+            : `Expected boolean, but got ${getTypeName(returnValue) || "unknown"}`, options);
+    }
+}
+_d = LoaderConditionError;
+(() => {
+    _d.prototype.name = "SosekiLoaderConditionError";
+})();
+/*#__PURE__*/ setErrorMessage(LoaderConditionError, ({ returnValue }) => isThenable(returnValue)
+    ? "shouldReload は同期的に真偽値を返す必要があります"
+    : `真偽値を期待しましたが、${getTypeName(returnValue) || "unknown"} を得ました`, "ja");
+/**************************************************************************************************/
+/**
+ * ルーター全体の共通状態 `RouterContext` が、React のコンポーネントツリー内の上位から供給されていない場合に投げるエラーです。
+ */
+export class RouterContextMissingError extends ErrorBase {
+    /**
+     * `RouterContextMissingError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param options エラーの共通オプションです。
+     */
+    constructor(options) {
+        super("RouterContext not found. Did you forget to wrap your app in <Router />?", options);
+    }
+}
+_e = RouterContextMissingError;
+(() => {
+    _e.prototype.name = "SosekiRouterContextMissingError";
+})();
+/*#__PURE__*/ setErrorMessage(RouterContextMissingError, "RouterContext が見つかりません。アプリを <Router /> で囲むのを忘れていませんか？", "ja");
+/**************************************************************************************************/
+/**
+ * 個々のルート固有の状態 `RouteContext` が、React のコンポーネントツリー内の上位から供給されていない場合に投げるエラーです。
+ */
+export class RouteContextMissingError extends ErrorBase {
+    /**
+     * `RouteContextMissingError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param options エラーの共通オプションです。
+     */
+    constructor(options) {
+        super("RouteContext not found. Did you forget to wrap your app in <Router />?", options);
+    }
+}
+_f = RouteContextMissingError;
+(() => {
+    _f.prototype.name = "SosekiRouteContextMissingError";
+})();
+/*#__PURE__*/ setErrorMessage(RouteContextMissingError, "RouteContext が見つかりません。アプリを <Router /> で囲むのを忘れていませんか？", "ja");
+/**
+ * ルートに紐づくデータ取得用のローダー関数が正常に処理されたはずであるにもかかわらず、該当するキャッシュデータや応答結果が見つからない場合に投げるエラーです。
+ */
+export class LoaderDataNotFoundError extends ErrorBase {
+    /**
+     * `LoaderDataNotFoundError` クラスの新しいインスタンスを初期化します。
+     *
+     * @param args エラーオプションおよび対象ローダー関数の参照を含む引数オブジェクトです。
+     */
+    constructor(args) {
+        const { loader, ...options } = args;
+        super({ loader }, ({ loader }) => loader
+            ? `Loader data not found (Function name: ${loader.name || "anonymous"})`
+            : "Loader is undefined", options);
+    }
+}
+_g = LoaderDataNotFoundError;
+(() => {
+    _g.prototype.name = "SosekiLoaderDataNotFoundError";
+})();
+/*#__PURE__*/ setErrorMessage(LoaderDataNotFoundError, ({ loader }) => loader
+    ? `ローダーデータが見つかりません（関数名: ${loader.name || "匿名"}）`
+    : "ローダーが未定義です。", "ja");

package/dist/src/core/expect-history-entry.d.ts

@@ -0,0 +1,59 @@
+import * as v from "./_valibot.js";
+import { type HistoryEntryId } from "./history-entry-id-schema.js";
+import { type HistoryEntryUrl } from "./history-entry-url-schema.js";
+/**
+ * 履歴エントリーオブジェクト全体の構造を検証するためのスキーマを作成する関数です。
+ *
+ * スキーマの構築処理は一度だけ実行され、以降はシングルトンインスタンスとしてキャッシュから再利用されます。
+ */
+declare const HistoryEntrySchema: () => import("@tai-kun/valibot-extra-lab").ObjectSchema<{
+    /**
+     * 履歴エントリーの識別子です。
+     */
+    readonly id: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").UuidAction<string, undefined>, import("valibot").BrandAction<string, "HistoryEntryId">]>;
+    /**
+     * 履歴エントリーの絶対 URL です。
+     */
+    readonly url: import("valibot").NullableSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").UrlAction<string, undefined>, import("@tai-kun/valibot-extra-lab").TransformAction<string, import("./readonly-url.types.js").ReadonlyURL>, import("valibot").BrandAction<import("./readonly-url.types.js").ReadonlyURL, "HistoryEntryUrl">]>, undefined>;
+    /**
+     * 履歴エントリーリスト内の履歴エントリーのインデックスです。
+     */
+    readonly index: import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<undefined>, import("valibot").SafeIntegerAction<number, undefined>, import("valibot").MinValueAction<number, -1, undefined>]>;
+}, undefined>;
+/**
+ * `HistoryEntrySchema` による検証と構造変換を行う前の、生の入力オブジェクトに対応する型定義です。
+ */
+export type HistoryEntryLike = v.InferInput<ReturnType<typeof HistoryEntrySchema>>;
+/**
+ * `expectHistoryEntry` 関数による検証を通過した、ランタイムで確定的に使用可能な履歴エントリーの型定義です。
+ */
+export type HistoryEntry = {
+    /**
+     * 履歴エントリーの識別子です。
+     */
+    readonly id: HistoryEntryId;
+    /**
+     * 履歴エントリーの絶対 URL です。
+     */
+    readonly url: HistoryEntryUrl;
+    /**
+     * 履歴エントリーリスト内の履歴エントリーのインデックスです。
+     */
+    readonly index: number;
+};
+/**
+ * 履歴エントリーオブジェクトを検証し、仕様を満たしている場合に確定的な `HistoryEntry` 型へと変換します。
+ *
+ * @param entry スキーマの基本構造を満たしていると予想される生の入力値です。
+ * @returns すべてのプロパティーが完全に確定した `HistoryEntry` を返します。
+ */
+declare function expectHistoryEntry(entry: HistoryEntryLike): HistoryEntry;
+/**
+ * 履歴エントリーオブジェクトを検証し、仕様を満たしている場合に確定的な `HistoryEntry` 型へと変換します。
+ *
+ * @param entry スキーマの入力形式を満たすオブジェクト、または空値です。
+ * @returns 入力値が空であった場合、あるいは検証の過程で必要なデータが欠落していた場合は `null` を返します。
+ */
+declare function expectHistoryEntry(entry: HistoryEntryLike | null | undefined): HistoryEntry | null;
+export default expectHistoryEntry;
+//# sourceMappingURL=expect-history-entry.d.ts.map

package/dist/src/core/expect-history-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect-history-entry.d.ts","sourceRoot":"","sources":["../../../src/core/expect-history-entry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AACnC,OAA6B,EAAE,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAA8B,EAAE,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAE5F;;;;GAIG;AACH,QAAA,MAAM,kBAAkB;IAGlB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;aAGN,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,iBAAS,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAAC;AAEnE;;;;;GAKG;AACH,iBAAS,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI,CAAC;AAwB7F,eAAe,kBAAkB,CAAC"}

package/dist/src/core/expect-history-entry.js

@@ -0,0 +1,42 @@
+import singleton from "./_singleton.js";
+import * as v from "./_valibot.js";
+import HistoryEntryIdSchema from "./history-entry-id-schema.js";
+import HistoryEntryUrlSchema from "./history-entry-url-schema.js";
+/**
+ * 履歴エントリーオブジェクト全体の構造を検証するためのスキーマを作成する関数です。
+ *
+ * スキーマの構築処理は一度だけ実行され、以降はシングルトンインスタンスとしてキャッシュから再利用されます。
+ */
+const HistoryEntrySchema = () => singleton("HistoryEntrySchema", () => v.object({
+    /**
+     * 履歴エントリーの識別子です。
+     */
+    id: HistoryEntryIdSchema(),
+    /**
+     * 履歴エントリーの絶対 URL です。
+     */
+    url: v.nullable(HistoryEntryUrlSchema()),
+    /**
+     * 履歴エントリーリスト内の履歴エントリーのインデックスです。
+     */
+    index: v.pipe(v.number(), v.safeInteger(), v.minValue(-1)),
+}));
+function expectHistoryEntry(entry) {
+    if (entry == null) {
+        return null;
+    }
+    const { id, url, index } = v.expect(HistoryEntrySchema(), entry);
+    if (
+    // 特定の条件下で null に設定される場合があるので、そのときは null を返します。
+    !url ||
+        // 現在のドキュメントが完全にアクティブでない場合は -1 になってしまうので、そのときは null を返します。
+        index < 0) {
+        return null;
+    }
+    return {
+        id,
+        url,
+        index,
+    };
+}
+export default expectHistoryEntry;

package/dist/src/core/form-data-to-html-form-element.d.ts

@@ -0,0 +1,11 @@
+import type { ReadonlyFormData } from "./readonly-form-data.types.js";
+/**
+ * 読み取り専用のフォームデータを基に、プログラムによって仮想的な `HTMLFormElement` を動的に構築する関数です。
+ *
+ * 生成されたフォーム要素は画面上のレイアウトを崩さないよう非表示（`display: none`）に設定され、内包する各データは適切な `<input>` 要素にラップされてフォーム内に追加されます。
+ *
+ * @param formData 変換元となる読み取り専用のフォームデータです。
+ * @returns 子要素としてデータが詰め込まれた、DOM に未配置の非表示 `HTMLFormElement` を返します。
+ */
+export default function formDataToHTMLFormElement(formData: ReadonlyFormData): HTMLFormElement;
+//# sourceMappingURL=form-data-to-html-form-element.d.ts.map

package/dist/src/core/form-data-to-html-form-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-data-to-html-form-element.d.ts","sourceRoot":"","sources":["../../../src/core/form-data-to-html-form-element.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,eAAe,CA0B7F"}

package/dist/src/core/form-data-to-html-form-element.js

@@ -0,0 +1,31 @@
+/**
+ * 読み取り専用のフォームデータを基に、プログラムによって仮想的な `HTMLFormElement` を動的に構築する関数です。
+ *
+ * 生成されたフォーム要素は画面上のレイアウトを崩さないよう非表示（`display: none`）に設定され、内包する各データは適切な `<input>` 要素にラップされてフォーム内に追加されます。
+ *
+ * @param formData 変換元となる読み取り専用のフォームデータです。
+ * @returns 子要素としてデータが詰め込まれた、DOM に未配置の非表示 `HTMLFormElement` を返します。
+ */
+export default function formDataToHTMLFormElement(formData) {
+    const form = document.createElement("form");
+    // 画面のレンダリングや視覚的なレイアウトに影響を及ぼさないよう、非表示スタイルを強制します。
+    form.style.display = "none";
+    formData.forEach((value, name) => {
+        const input = document.createElement("input");
+        if (value instanceof File) {
+            // DataTransfer オブジェクトを仲介役として利用し、FileList を安全に再構成します。
+            const df = new DataTransfer();
+            df.items.add(value);
+            input.type = "file";
+            input.name = name;
+            input.files = df.files;
+        }
+        else {
+            input.type = "hidden";
+            input.name = name;
+            input.value = value;
+        }
+        form.appendChild(input);
+    });
+    return form;
+}

package/dist/src/core/history-entry-id-schema.d.ts

@@ -0,0 +1,17 @@
+import * as v from "./_valibot.js";
+/**
+ * 履歴エントリーの識別子を検証およびブランド化するためのスキーマを作成する関数です。
+ *
+ * スキーマの生成処理は一度だけ実行され、以降はシングルトンインスタンスとしてキャッシュから再利用されます。
+ */
+declare const HistoryEntryIdSchema: () => import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").UuidAction<string, undefined>, import("valibot").BrandAction<string, "HistoryEntryId">]>;
+/**
+ * `HistoryEntryIdSchema` による検証を通過する前の、入力値に対応する型定義です。
+ */
+export type HistoryEntryIdLike = v.InferInput<ReturnType<typeof HistoryEntryIdSchema>>;
+/**
+ * `HistoryEntryIdSchema` による検証および解析が正常に完了した、安全な出力値の型定義です。
+ */
+export type HistoryEntryId = v.InferOutput<ReturnType<typeof HistoryEntryIdSchema>>;
+export default HistoryEntryIdSchema;
+//# sourceMappingURL=history-entry-id-schema.d.ts.map

package/dist/src/core/history-entry-id-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-entry-id-schema.d.ts","sourceRoot":"","sources":["../../../src/core/history-entry-id-schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AAEnC;;;;GAIG;AACH,QAAA,MAAM,oBAAoB,wMACwE,CAAC;AAEnG;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AAEpF,eAAe,oBAAoB,CAAC"}

package/dist/src/core/history-entry-id-schema.js

@@ -0,0 +1,9 @@
+import singleton from "./_singleton.js";
+import * as v from "./_valibot.js";
+/**
+ * 履歴エントリーの識別子を検証およびブランド化するためのスキーマを作成する関数です。
+ *
+ * スキーマの生成処理は一度だけ実行され、以降はシングルトンインスタンスとしてキャッシュから再利用されます。
+ */
+const HistoryEntryIdSchema = () => singleton("HistoryEntryIdSchema", () => v.pipe(v.string(), v.uuid(), v.brand("HistoryEntryId")));
+export default HistoryEntryIdSchema;