soseki 0.0.1 → 0.0.2

package/dist/components/action-id.d.ts

@@ -0,0 +1,19 @@
+import * as React from "react";
+import type { IAction } from "../core/route.types.js";
+/**
+ * ActionId コンポーネントのプロパティーを定義する型です。
+ */
+export type ActionIdProps = {
+    /**
+     * 実行対象となるアクション関数です。
+     */
+    action: IAction;
+};
+/**
+ * アクションに対応する識別子を隠しフィールドとしてレンダリングするコンポーネントです。
+ *
+ * アクション関数をレジストリーに登録し、発行された ID をフォームデータとして送信可能な状態にします。
+ */
+declare const _default: React.NamedExoticComponent<ActionIdProps>;
+export default _default;
+//# sourceMappingURL=action-id.d.ts.map

package/dist/components/action-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-id.d.ts","sourceRoot":"","sources":["../../src/components/action-id.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;;GAIG;;AACH,wBAaE"}

package/dist/components/action-id.jsx

@@ -0,0 +1,14 @@
+import * as React from "react";
+import actionIdRegistry from "../core/_action-id-registry.js";
+import { ACTION_ID_FORM_DATA_NAME } from "../core/constants.js";
+import HiddenInput from "./hidden-input.jsx";
+/**
+ * アクションに対応する識別子を隠しフィールドとしてレンダリングするコンポーネントです。
+ *
+ * アクション関数をレジストリーに登録し、発行された ID をフォームデータとして送信可能な状態にします。
+ */
+export default /*#__PURE__*/ React.memo(function ActionId(props) {
+    const { action } = props;
+    const id = actionIdRegistry.set(action);
+    return (<HiddenInput name={ACTION_ID_FORM_DATA_NAME} value={id}/>);
+}, (a, b) => a.action === b.action);

package/dist/components/browser-router.d.ts

@@ -0,0 +1,17 @@
+import type { RouteDefinition } from "../core/route.types.js";
+/**
+ * BrowserRouter コンポーネントに渡されるプロパティーの型定義です。
+ */
+export type BrowserRouterProps = {
+    /**
+     * アプリケーション全体のルート定義を格納した配列です。
+     */
+    routes: readonly RouteDefinition[];
+};
+/**
+ * ブラウザー標準の Navigation API を使用してルーティングを行うためのコンポーネントです。
+ *
+ * `NavigationApiEngine` のインスタンスをシングルトンとして保持し、ルーターの基盤を提供します。
+ */
+export default function BrowserRouter(props: BrowserRouterProps): React.ReactElement;
+//# sourceMappingURL=browser-router.d.ts.map

package/dist/components/browser-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-router.d.ts","sourceRoot":"","sources":["../../src/components/browser-router.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CACpC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAUnF"}

package/dist/components/browser-router.jsx

@@ -0,0 +1,13 @@
+import useSingleton from "../core/_use-singleton.js";
+import NavigationApiEngine from "../engines/navigation-api-engine.js";
+import Router from "./router.jsx";
+/**
+ * ブラウザー標準の Navigation API を使用してルーティングを行うためのコンポーネントです。
+ *
+ * `NavigationApiEngine` のインスタンスをシングルトンとして保持し、ルーターの基盤を提供します。
+ */
+export default function BrowserRouter(props) {
+    const { routes } = props;
+    const engine = useSingleton(() => new NavigationApiEngine());
+    return (<Router engine={engine} routes={routes}/>);
+}

package/dist/components/hidden-input.d.ts

@@ -0,0 +1,20 @@
+import * as React from "react";
+/**
+ * 隠し入力フィールド（hidden input）のプロパティーを定義する型です。
+ */
+export type HiddenInputProps = {
+    /**
+     * フォーム送信時に使用される要素の名前です。
+     */
+    name: string;
+    /**
+     * フォーム送信時に送信される値です。
+     */
+    value: string;
+};
+/**
+ * フォーム内で非表示の状態を保持するための隠し入力コンポーネントです。
+ */
+declare const _default: React.NamedExoticComponent<HiddenInputProps>;
+export default _default;
+//# sourceMappingURL=hidden-input.d.ts.map

package/dist/components/hidden-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hidden-input.d.ts","sourceRoot":"","sources":["../../src/components/hidden-input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;;AACH,wBAkBE"}

package/dist/components/hidden-input.jsx

@@ -0,0 +1,8 @@
+import * as React from "react";
+/**
+ * フォーム内で非表示の状態を保持するための隠し入力コンポーネントです。
+ */
+export default /*#__PURE__*/ React.memo(function HiddenInput(props) {
+    const { name, value, } = props;
+    return (<input type="hidden" name={name} style={{ display: "none" }} value={value} hidden/>);
+}, (a, b) => a.name === b.name && a.value === b.value);

package/dist/components/outlet.d.ts

@@ -0,0 +1,8 @@
+import * as React from "react";
+/**
+ * 現在のルート階層における子ルート（アウトレット）を描画するためのコンポーネントです。
+ *
+ * ネストされたルーティングにおいて、親ルートのコンポーネント内で子ルートの挿入位置を指定するために使用します。
+ */
+export default function Outlet(): React.ReactElement | null;
+//# sourceMappingURL=outlet.d.ts.map

package/dist/components/outlet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlet.d.ts","sourceRoot":"","sources":["../../src/components/outlet.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,IAAI,KAAK,CAAC,YAAY,GAAG,IAAI,CAO1D"}

package/dist/components/outlet.jsx

@@ -0,0 +1,15 @@
+import * as React from "react";
+import RouteContext from "../contexts/route-context.js";
+import { RouteContextMissingError } from "../core/errors.js";
+/**
+ * 現在のルート階層における子ルート（アウトレット）を描画するためのコンポーネントです。
+ *
+ * ネストされたルーティングにおいて、親ルートのコンポーネント内で子ルートの挿入位置を指定するために使用します。
+ */
+export default function Outlet() {
+    const routeContext = React.use(RouteContext);
+    if (!routeContext) {
+        throw new RouteContextMissingError();
+    }
+    return routeContext.outlet;
+}

package/dist/components/router.d.ts

@@ -0,0 +1,23 @@
+import * as React from "react";
+import type { RouteDefinition } from "../core/route.types.js";
+import type { IEngine } from "../engines/engine.types.js";
+/**
+ * Router コンポーネントに渡されるプロパティーの型定義です。
+ */
+export type RouterProps = {
+    /**
+     * ルーティングのロジックを制御するエンジンインスタンスです。
+     */
+    engine: IEngine;
+    /**
+     * アプリケーションのルート定義の配列です。
+     */
+    routes: readonly RouteDefinition[];
+};
+/**
+ * ルーティング機能を提供するメインのコンポーネントです。
+ *
+ * エンジンの管理、状態の同期、およびルートのレンダリングを担います。
+ */
+export default function Router(props: RouterProps): React.JSX.Element | null;
+//# sourceMappingURL=router.d.ts.map

package/dist/components/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/components/router.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,OAAO,EAA2B,MAAM,4BAA4B,CAAC;AAmFnF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CACpC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAK,EAAE,WAAW,4BAuHhD"}

package/dist/components/router.jsx

@@ -0,0 +1,128 @@
+import * as React from "react";
+import RouteContext from "../contexts/route-context.js";
+import RouterContext from "../contexts/router-context.js";
+import processRoutes from "../core/_process-routes.js";
+/**
+ * 個別のルートコンポーネントをレンダリングし、ルートコンテキストを提供する内部コンポーネントです。
+ */
+function ComponentRenderer(props) {
+    const { route: { path, index, params, urlPath, component: Component, }, outlet, } = props;
+    const context = {
+        path,
+        index,
+        params,
+        outlet,
+        urlPath,
+    };
+    return (<RouteContext value={context}>
+      {Component ? <Component /> : outlet}
+    </RouteContext>);
+}
+/**
+ * マッチしたルートの階層を順番にレンダリングする内部コンポーネントです。
+ */
+function RouteRenderer(props) {
+    const { index = 0, routes, } = props;
+    const route = routes[index];
+    const outlet = index < routes.length - 1
+        ? <RouteRenderer routes={routes} index={index + 1}/>
+        : null;
+    return (<ComponentRenderer route={route} outlet={outlet}/>);
+}
+/**
+ * ルーティング機能を提供するメインのコンポーネントです。
+ *
+ * エンジンの管理、状態の同期、およびルートのレンダリングを担います。
+ */
+export default function Router(props) {
+    const { engine, routes: routesProp, } = props;
+    const routerRef = React.useRef({});
+    const router = React.useMemo(() => {
+        const actionDataStore = new Map();
+        const loaderDataStore = new Map();
+        const subscribers = new Set();
+        const routes = processRoutes(routesProp);
+        let ac = null;
+        function getAbortSignal() {
+            return (ac || (ac = new AbortController())).signal;
+        }
+        const initialState = engine.init({
+            routes,
+            getSignal: getAbortSignal,
+            loaderDataStore,
+        });
+        let currentRoutes = initialState?.routes;
+        function updateRouter(newState) {
+            if (newState !== undefined) {
+                currentRoutes = newState?.routes;
+            }
+            if (newState) {
+                routerRef.current.currentEntry = newState.entry;
+            }
+            // 登録されているすべてのサブスクライバーに通知します。
+            subscribers.forEach(notify => notify());
+        }
+        function startRouterEngine() {
+            const stop = engine.start({
+                routes,
+                update: updateRouter,
+                getSignal: getAbortSignal,
+                actionDataStore,
+                loaderDataStore,
+            });
+            return function stopRouterEngine() {
+                try {
+                    // エンジンの動作を停止します。
+                    stop?.();
+                }
+                finally {
+                    // 進行中のすべての非同期処理を中断します。
+                    try {
+                        ac?.abort();
+                    }
+                    catch {
+                    }
+                    // 中断後は次回の呼び出しに備えてコントローラーを破棄します。
+                    ac = null;
+                }
+            };
+        }
+        Object.assign(routerRef.current, {
+            submit(args) {
+                return engine.submit(args);
+            },
+            navigate(args) {
+                return engine.navigate(args);
+            },
+            currentEntry: initialState?.entry,
+            actionDataStore,
+            loaderDataStore,
+        });
+        return {
+            start: startRouterEngine,
+            context: {
+                routerRef,
+                subscribe(cb) {
+                    subscribers.add(cb);
+                    return () => {
+                        subscribers.delete(cb);
+                    };
+                },
+            },
+            getRoutes() {
+                return currentRoutes;
+            },
+        };
+    }, [
+        engine,
+        routesProp,
+    ]);
+    React.useEffect(router.start, [router]);
+    const routes = React.useSyncExternalStore(router.context.subscribe, router.getRoutes);
+    if (!routes) {
+        return null;
+    }
+    return (<RouterContext value={router.context}>
+      <RouteRenderer routes={routes.toReversed()}/>
+    </RouterContext>);
+}

package/dist/contexts/route-context.d.ts

@@ -0,0 +1,19 @@
+import * as React from "react";
+import type { MatchedRoute } from "../core/match-routes.js";
+/**
+ * 各ルートのコンテキストで共有される値の型定義です。
+ */
+export type RouteContextValue = Pick<MatchedRoute, "path" | "index" | "params" | "urlPath"> & {
+    /**
+     * 子ルートを描画するための React 要素です。
+     *
+     * 子ルートが存在しない場合は `null` となります。
+     */
+    readonly outlet: React.ReactElement | null;
+};
+/**
+ * 個別のルート情報やアウトレット（子ルートの挿入場所）を保持するための React コンテキストです。
+ */
+declare const RouteContext: React.Context<RouteContextValue | null>;
+export default RouteContext;
+//# sourceMappingURL=route-context.d.ts.map

package/dist/contexts/route-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-context.d.ts","sourceRoot":"","sources":["../../src/contexts/route-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC,GAAG;IAC5F;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,YAAY,yCAAoE,CAAC;AAEvF,eAAe,YAAY,CAAC"}

package/dist/contexts/route-context.js

@@ -0,0 +1,6 @@
+import * as React from "react";
+/**
+ * 個別のルート情報やアウトレット（子ルートの挿入場所）を保持するための React コンテキストです。
+ */
+const RouteContext = /*#__PURE__*/ React.createContext(null);
+export default RouteContext;

package/dist/contexts/router-context.d.ts

@@ -0,0 +1,46 @@
+import * as React from "react";
+import type { IReadonlyDataStore } from "../core/data-store.types.js";
+import type { HistoryEntry } from "../core/expect-history-entry.js";
+import type { IAction, ILoader } from "../core/route.types.js";
+import type { NavigateArgs, SubmitArgs } from "../engines/engine.types.js";
+export type RouterRef = Readonly<React.RefObject<{
+    /**
+     * フォームデータやクエリー パラメーターを送信します。
+     *
+     * @param args 送信内容と送信先を含む引数です。
+     */
+    readonly submit: (args: SubmitArgs) => void;
+    /**
+     * 指定されたパスへ遷移します。
+     *
+     * @param args 遷移先と遷移オプションを含む引数です。
+     */
+    readonly navigate: (args: NavigateArgs) => void;
+    /**
+     * 現在の履歴エントリー情報（ID、URL、インデックスなど）です。
+     */
+    readonly currentEntry: HistoryEntry;
+    /**
+     * 履歴 ID ごとに管理されているアクションデータのマップです。
+     */
+    readonly actionDataStore: IReadonlyDataStore<IAction>;
+    /**
+     * 履歴 ID ごとに管理されているローダーデータのマップです。
+     */
+    readonly loaderDataStore: IReadonlyDataStore<ILoader>;
+}>>;
+/**
+ * ルーターコンテキストで共有される値の型定義です。
+ */
+export type RouterContextValue = {
+    readonly routerRef: RouterRef;
+    readonly subscribe: (onRouterChange: () => void) => () => void;
+};
+/**
+ * ルーターの状態や操作関数をコンポーネントツリー全体で共有するための React コンテキストです。
+ *
+ * 初期値は `null` であり、通常は Provider を介して値が提供されます。
+ */
+declare const RouterContext: React.Context<RouterContextValue | null>;
+export default RouterContext;
+//# sourceMappingURL=router-context.d.ts.map

package/dist/contexts/router-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-context.d.ts","sourceRoot":"","sources":["../../src/contexts/router-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE3E,MAAM,MAAM,SAAS,GAAG,QAAQ,CAC9B,KAAK,CAAC,SAAS,CAAC;IACd;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAE5C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;CACvD,CAAC,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,CAAC,cAAc,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CAChE,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,aAAa,0CAAqE,CAAC;AAEzF,eAAe,aAAa,CAAC"}

package/dist/contexts/router-context.js

@@ -0,0 +1,8 @@
+import * as React from "react";
+/**
+ * ルーターの状態や操作関数をコンポーネントツリー全体で共有するための React コンテキストです。
+ *
+ * 初期値は `null` であり、通常は Provider を介して値が提供されます。
+ */
+const RouterContext = /*#__PURE__*/ React.createContext(null);
+export default RouterContext;

package/dist/core/_action-id-registry.d.ts

@@ -0,0 +1,10 @@
+import WeakIdRegistry from "./_weak-id-registry.js";
+import type { IAction } from "./route.types.js";
+/**
+ * `IAction` 型のオブジェクトとその識別子を管理するための、弱い参照を用いたレジストリーです。
+ *
+ * ガベージコレクションを妨げずにアクションの識別子を保持するために使用されます。
+ */
+declare const actionIdRegistry: WeakIdRegistry<IAction<string, unknown>>;
+export default actionIdRegistry;
+//# sourceMappingURL=_action-id-registry.d.ts.map

package/dist/core/_action-id-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_action-id-registry.d.ts","sourceRoot":"","sources":["../../src/core/_action-id-registry.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;GAIG;AACH,QAAA,MAAM,gBAAgB,0CAAgC,CAAC;AAEvD,eAAe,gBAAgB,CAAC"}

package/dist/core/_action-id-registry.js

@@ -0,0 +1,8 @@
+import WeakIdRegistry from "./_weak-id-registry.js";
+/**
+ * `IAction` 型のオブジェクトとその識別子を管理するための、弱い参照を用いたレジストリーです。
+ *
+ * ガベージコレクションを妨げずにアクションの識別子を保持するために使用されます。
+ */
+const actionIdRegistry = new WeakIdRegistry();
+export default actionIdRegistry;

package/dist/core/_capture-stack-trace.d.ts

@@ -0,0 +1,8 @@
+/**
+ * オブジェクトにスタックトレースをキャプチャーします。
+ *
+ * @param targetObject スタックトレースのプロパティーを追加する対象のオブジェクトです。
+ * @param constructorOpt スタックトレースの開始地点としてマークする関数です。
+ */
+export default function captureStackTrace(targetObject: object, constructorOpt: Function): void;
+//# sourceMappingURL=_capture-stack-trace.d.ts.map

package/dist/core/_capture-stack-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_capture-stack-trace.d.ts","sourceRoot":"","sources":["../../src/core/_capture-stack-trace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,GAAG,IAAI,CAK9F"}

package/dist/core/_capture-stack-trace.js

@@ -0,0 +1,12 @@
+/**
+ * オブジェクトにスタックトレースをキャプチャーします。
+ *
+ * @param targetObject スタックトレースのプロパティーを追加する対象のオブジェクトです。
+ * @param constructorOpt スタックトレースの開始地点としてマークする関数です。
+ */
+export default function captureStackTrace(targetObject, constructorOpt) {
+    // 実行環境（V8 エンジンなど）が Error.captureStackTrace をサポートしているか確認します。
+    if ("captureStackTrace" in Error && typeof Error.captureStackTrace === "function") {
+        Error.captureStackTrace(targetObject, constructorOpt);
+    }
+}

package/dist/core/_compare-route-paths.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 2 つのパスを比較し、ルーティングの優先順位に基づいたソート順を決定します。
+ *
+ * より具体的で深いパスが前方に配置されるように比較を行います。
+ *
+ * @param pathA 比較対象のパス A です。
+ * @param pathB 比較対象のパス B です。
+ * @returns 比較結果を示す数値です（負数は pathA が優先、正数は pathB が優先）。
+ */
+export default function compareRoutePaths(pathA: string, pathB: string): number;
+//# sourceMappingURL=_compare-route-paths.d.ts.map

package/dist/core/_compare-route-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_compare-route-paths.d.ts","sourceRoot":"","sources":["../../src/core/_compare-route-paths.ts"],"names":[],"mappings":"AAiDA;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA+B9E"}

package/dist/core/_compare-route-paths.js

@@ -0,0 +1,80 @@
+/**
+ * セグメントの種類に応じたスコア定数です。
+ *
+ * 数値が大きいほど優先順位（具体性）が高いです。
+ */
+const SCORE = {
+    /**
+     * 静的なパスセグメントのスコアです。
+     */
+    STATIC: 4,
+    /**
+     * 必須のパラメーターセグメントのスコアです。
+     */
+    PARAMETER: 3,
+    /**
+     * 任意のパラメーターセグメントのスコアです。
+     */
+    OPTIONAL_PARAM: 2,
+    /**
+     * ワイルドカードセグメントのスコアです。
+     */
+    WILDCARD: 1,
+};
+/**
+ * 指定されたパスセグメントの文字列から、その種類に応じたスコアを計算します。
+ *
+ * @param s 解析対象のパスセグメント文字列です。
+ * @returns セグメントの種類に基づいた数値スコアを返します。
+ */
+function getSegmentScore(s) {
+    if (s.includes("*")) {
+        return SCORE.WILDCARD;
+    }
+    if (s.startsWith(":")) {
+        if (s.endsWith("?")) {
+            return SCORE.OPTIONAL_PARAM;
+        }
+        else {
+            return SCORE.PARAMETER;
+        }
+    }
+    return SCORE.STATIC;
+}
+/**
+ * 2 つのパスを比較し、ルーティングの優先順位に基づいたソート順を決定します。
+ *
+ * より具体的で深いパスが前方に配置されるように比較を行います。
+ *
+ * @param pathA 比較対象のパス A です。
+ * @param pathB 比較対象のパス B です。
+ * @returns 比較結果を示す数値です（負数は pathA が優先、正数は pathB が優先）。
+ */
+export default function compareRoutePaths(pathA, pathB) {
+    const partsA = pathA.split("/").filter(Boolean);
+    const partsB = pathB.split("/").filter(Boolean);
+    const length = Math.max(partsA.length, partsB.length);
+    for (let i = 0; i < length; i++) {
+        const a = partsA[i];
+        // パス A のセグメントが先に終了した場合は、パス B を優先します。
+        if (a === undefined) {
+            return 1;
+        }
+        const b = partsB[i];
+        // パス B のセグメントが先に終了した場合は、パス A を優先します。
+        if (b === undefined) {
+            return -1;
+        }
+        const scoreA = getSegmentScore(a);
+        const scoreB = getSegmentScore(b);
+        // スコアが異なる場合は、スコアが高い方を優先します。
+        if (scoreA !== scoreB) {
+            return scoreB - scoreA;
+        }
+        // スコアが同じ場合は、文字列の辞書順で比較します。
+        if (a !== b) {
+            return a.localeCompare(b);
+        }
+    }
+    return 0;
+}

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

@@ -0,0 +1,9 @@
+import type { ReadonlyFormData } from "./readonly-form-data.types.js";
+/**
+ * ReadonlyFormData の内容から、一時的な HTMLFormElement を生成します。
+ *
+ * @param formData フォーム要素に変換する元のフォームデータです。
+ * @returns 生成された HTMLFormElement を返します。
+ */
+export default function createHtmlFormElementFormFormData(formData: ReadonlyFormData): HTMLFormElement;
+//# sourceMappingURL=_create-html-form-element-form-form-data.d.ts.map

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

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

package/dist/core/_create-html-form-element-form-form-data.js

@@ -0,0 +1,27 @@
+/**
+ * ReadonlyFormData の内容から、一時的な HTMLFormElement を生成します。
+ *
+ * @param formData フォーム要素に変換する元のフォームデータです。
+ * @returns 生成された HTMLFormElement を返します。
+ */
+export default function createHtmlFormElementFormFormData(formData) {
+    const form = document.createElement("form");
+    form.style.display = "none";
+    formData.forEach((value, name) => {
+        const input = document.createElement("input");
+        if (value instanceof File) {
+            input.type = "file";
+            input.name = name;
+            const dataTransfer = new DataTransfer();
+            dataTransfer.items.add(value);
+            input.files = dataTransfer.files;
+        }
+        else {
+            input.type = "hidden";
+            input.name = name;
+            input.value = value;
+        }
+        form.appendChild(input);
+    });
+    return form;
+}

package/dist/core/_encode-pathname.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 与えられたパス名を URL エンコードし、正規化された形式で返します。
+ *
+ * エンコードの必要がある部分のみをエンコードします。
+ *
+ * @param pathname エンコード対象となるパス名の文字列です。
+ * @returns 正規化およびエンコードされたパス名の文字列です。
+ */
+export default function encodePathname(pathname: string): string;
+//# sourceMappingURL=_encode-pathname.d.ts.map

package/dist/core/_encode-pathname.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_encode-pathname.d.ts","sourceRoot":"","sources":["../../src/core/_encode-pathname.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/D"}

package/dist/core/_encode-pathname.js

@@ -0,0 +1,16 @@
+/**
+ * 連続するスラッシュ（/）にマッチする正規表現です。
+ */
+const MULTI_SLASH = /\/\/+/gu;
+/**
+ * 与えられたパス名を URL エンコードし、正規化された形式で返します。
+ *
+ * エンコードの必要がある部分のみをエンコードします。
+ *
+ * @param pathname エンコード対象となるパス名の文字列です。
+ * @returns 正規化およびエンコードされたパス名の文字列です。
+ */
+export default function encodePathname(pathname) {
+    const u = new URL("x://y" + ("/" + pathname).replace(MULTI_SLASH, "/"));
+    return u.pathname;
+}

package/dist/core/_is-error.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (error: unknown) => error is Error;
+export default _default;
+//# sourceMappingURL=_is-error.d.ts.map

package/dist/core/_is-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_is-error.d.ts","sourceRoot":"","sources":["../../src/core/_is-error.ts"],"names":[],"mappings":";AAeA,wBAAmD"}

package/dist/core/_is-error.js

@@ -0,0 +1,13 @@
+/**
+ * エラーオブジェクトのようなオブジェクトかどうか判定します。
+ *
+ * @param e 判定する値です。
+ * @returns 判定結果です。
+ */
+function isError(e) {
+    return e instanceof Error || (e !== null
+        && typeof e === "object"
+        && ("name" in e && typeof e.name === "string")
+        && ("message" in e && typeof e.message === "string"));
+}
+export default globalThis.Error.isError || isError;