@gostack-framework/react 0.0.0-stage → 0.1.0

package/dist/line-flow/taxi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taxi.js","sourceRoot":"","sources":["../../src/line-flow/taxi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,OAAO,QAAQ;IACV,EAAE,CAAS;IACH,SAAS,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC9D,WAAW,GAAG,KAAK,CAAC;IACX,UAAU,CAA4B;IAEvD,YAAY,OAAqB,EAAE,SAAsB;QACvD,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC1G,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,QAAQ,CACN,IAAO,EACP,OAAqE;QAErE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,qBAAqB,CAAC,6CAA6C,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzB,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,uBAAuB,CAAC,0BAA0B,IAAI,uBAAuB,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,6BAA6B,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAElC,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,OAAO,GAAG,EAAE;YACV,IAAI,YAAY;gBAAE,OAAO;YACzB,YAAY,GAAG,IAAI,CAAC;YACpB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;gBACzC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAO,EACP,GAA2B,EAC3B,OAAkC;QAElC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,qBAAqB,CAAC,2CAA2C,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACnG,CAAC;QACD,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEzB,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC/B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QAED,0BAA0B;QAC1B,OAAO,IAAI,OAAO,CAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9D,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;YACnE,CAAC,CAAC;YAEF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAE1D,OAAO,CAAC,OAAO,EAAE;iBACd,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;iBAChC,IAAI,CACH,CAAC,MAAM,EAAE,EAAE;gBACT,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC7C,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;gBACN,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC7C,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CACF,CAAC;QACN,CAAC,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAoC,IAAO;QACnD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/line-flow/types.d.ts

@@ -0,0 +1,222 @@
+/**
+ * Supported line kinds.
+ */
+export type LineKind = "state" | "event" | "derived";
+/**
+ * Equality comparison function.
+ */
+export type EqualityFn<T> = (prev: T, next: T) => boolean;
+/**
+ * Function invoked to cancel an active subscription or unregister a resource.
+ */
+export type Unsubscribe = () => void;
+/**
+ * Listener function called with state updates or published events.
+ */
+export type Listener<T> = (value: T) => void;
+/**
+ * A resource or function that can be disposed of.
+ */
+export type Disposable = {
+    dispose: () => void;
+} | (() => void);
+/**
+ * Base read-only interface implemented by lines that retain a snapshot (StateLine and DerivedLine).
+ */
+export interface ReadableLine<T> {
+    readonly id: string;
+    readonly kind: "state" | "derived";
+    getSnapshot(): T;
+    subscribe(listener: Listener<T>): Unsubscribe;
+    dispose(): void;
+    readonly isDisposed: boolean;
+}
+/**
+ * A persistent state line.
+ */
+export interface StateLine<T> extends ReadableLine<T> {
+    readonly kind: "state";
+    set(value: T): void;
+    update(updater: (prev: T) => T): void;
+}
+/**
+ * An ephemeral event line.
+ */
+export interface EventLine<T> {
+    readonly id: string;
+    readonly kind: "event";
+    publish(event: T): void;
+    subscribe(listener: Listener<T>): Unsubscribe;
+    dispose(): void;
+    readonly isDisposed: boolean;
+}
+/**
+ * Any line that retains a snapshot and allows reading and subscriptions.
+ */
+export type AnyStateLine = ReadableLine<any>;
+/**
+ * Any line registered in the LineFlow network.
+ */
+export type AnyLine = StateLine<any> | EventLine<any> | DerivedLine<any>;
+/**
+ * Extracts the snapshot value type from a readable line.
+ */
+export type LineSnapshot<TLine> = TLine extends ReadableLine<infer T> ? T : never;
+/**
+ * Extracts a tuple of snapshot value types from a tuple/array of readable lines.
+ */
+export type LinesSnapshots<TLines extends readonly AnyStateLine[]> = {
+    readonly [K in keyof TLines]: LineSnapshot<TLines[K]>;
+};
+/**
+ * A read-only derived line whose snapshot is computed from one or more source lines.
+ */
+export interface DerivedLine<T> extends ReadableLine<T> {
+    readonly kind: "derived";
+    readonly sources: readonly AnyStateLine[];
+}
+/**
+ * Options for creating a StateLine.
+ */
+export interface StateLineOptions<T> {
+    id: string;
+    initialValue: T;
+    equals?: EqualityFn<T> | undefined;
+}
+/**
+ * Options for creating an EventLine.
+ */
+export interface EventLineOptions<T = void> {
+    id: string;
+    _phantom?: ((value: T) => void) | undefined;
+}
+/**
+ * Options for creating a DerivedLine.
+ */
+export interface DeriveLineOptions<T, TDeps extends readonly AnyStateLine[]> {
+    id: string;
+    sources: TDeps;
+    derive: (snapshots: LinesSnapshots<TDeps>) => T;
+    equals?: EqualityFn<T> | undefined;
+}
+/**
+ * Options for creating an Interchange between two state lines.
+ */
+export interface InterchangeOptions<TSource, TTarget> {
+    id?: string | undefined;
+    from: ReadableLine<TSource>;
+    to: StateLine<TTarget>;
+    transform: (sourceSnapshot: TSource) => TTarget;
+    equals?: EqualityFn<TTarget> | undefined;
+}
+/**
+ * Represents an active directional relationship between lines.
+ */
+export interface Interchange {
+    readonly id: string;
+    readonly isDisposed: boolean;
+    dispose(): void;
+}
+/**
+ * Feature-scoped message bus.
+ */
+export interface Bus<TMessageMap extends object = Record<string, unknown>> {
+    readonly id: string;
+    readonly isDisposed: boolean;
+    publish<K extends keyof TMessageMap & string>(channel: K, payload: TMessageMap[K]): void;
+    subscribe<K extends keyof TMessageMap & string>(channel: K, listener: (payload: TMessageMap[K]) => void): Unsubscribe;
+    dispose(): void;
+}
+/**
+ * Options for creating a Bus.
+ */
+export interface BusOptions {
+    id?: string | undefined;
+}
+/**
+ * Handler for a Taxi task.
+ */
+export type TaxiHandler<TReq, TRes> = (req: TReq, signal?: AbortSignal | undefined) => Promise<TRes> | TRes;
+/**
+ * Single task request/response contract.
+ */
+export interface TaskContract<TRequest = any, TResponse = any> {
+    request: TRequest;
+    response: TResponse;
+}
+/**
+ * Taxi task contract map.
+ */
+export type TaxiTaskMap = Record<string, TaskContract>;
+/**
+ * Typed request/response handler service.
+ */
+export interface Taxi<TTaskMap extends {
+    [K in keyof TTaskMap]: TaskContract;
+} = TaxiTaskMap> {
+    readonly id: string;
+    readonly isDisposed: boolean;
+    register<K extends keyof TTaskMap & string>(task: K, handler: TaxiHandler<TTaskMap[K]["request"], TTaskMap[K]["response"]>): Unsubscribe;
+    request<K extends keyof TTaskMap & string>(task: K, req: TTaskMap[K]["request"], options?: {
+        signal?: AbortSignal | undefined;
+    } | undefined): Promise<TTaskMap[K]["response"]>;
+    hasHandler<K extends keyof TTaskMap & string>(task: K): boolean;
+    dispose(): void;
+}
+/**
+ * Options for creating a Taxi.
+ */
+export interface TaxiOptions {
+    id?: string | undefined;
+}
+/**
+ * Scoped lifecycle boundary for managing lines and resources.
+ */
+export interface Scope {
+    readonly id: string;
+    readonly isDisposed: boolean;
+    registerDisposable(disposable: Disposable): Unsubscribe;
+    stateLine<T>(options: StateLineOptions<T>): StateLine<T>;
+    eventLine<T = void>(options: EventLineOptions<T>): EventLine<T>;
+    deriveLine<T, const TDeps extends readonly AnyStateLine[]>(options: DeriveLineOptions<T, TDeps>): DerivedLine<T>;
+    bus<TMessageMap extends object = Record<string, unknown>>(options?: BusOptions): Bus<TMessageMap>;
+    taxi<TTaskMap extends {
+        [K in keyof TTaskMap]: TaskContract;
+    } = TaxiTaskMap>(options?: TaxiOptions): Taxi<TTaskMap>;
+    createChildScope(id: string): Scope;
+    dispose(): void;
+}
+/**
+ * Options for creating a Scope.
+ */
+export interface ScopeOptions {
+    id?: string | undefined;
+}
+/**
+ * Network instance options.
+ */
+export interface LineFlowOptions {
+    name?: string | undefined;
+}
+/**
+ * The runtime LineFlow network owning lines and registries.
+ */
+export interface LineFlowNetwork {
+    readonly name: string;
+    readonly isDisposed: boolean;
+    stateLine<T>(options: StateLineOptions<T>): StateLine<T>;
+    eventLine<T = void>(options: EventLineOptions<T>): EventLine<T>;
+    deriveLine<T, const TDeps extends readonly AnyStateLine[]>(options: DeriveLineOptions<T, TDeps>): DerivedLine<T>;
+    createInterchange<TSource, TTarget>(options: InterchangeOptions<TSource, TTarget>): Interchange;
+    createScope(options?: ScopeOptions): Scope;
+    bus<TMessageMap extends object = Record<string, unknown>>(options?: BusOptions): Bus<TMessageMap>;
+    taxi<TTaskMap extends {
+        [K in keyof TTaskMap]: TaskContract;
+    } = TaxiTaskMap>(options?: TaxiOptions): Taxi<TTaskMap>;
+    getLine(id: string): AnyLine | undefined;
+    hasLine(id: string): boolean;
+    getAllLines(): readonly AnyLine[];
+    dispose(): void;
+}
+export type LineflowOptions = LineFlowOptions;
+export type LineflowNetwork = LineFlowNetwork;

package/dist/line-flow/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/line-flow/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/line-flow/types.ts"],"names":[],"mappings":""}

package/dist/line-flow/utils.d.ts

@@ -0,0 +1,24 @@
+import type { EqualityFn, Listener } from "./types.js";
+/**
+ * Validates that an ID is a non-empty string.
+ */
+export declare function validateId(id: unknown, context?: string): string;
+/**
+ * Validates that a listener is a function.
+ */
+export declare function validateListener(listener: unknown): asserts listener is (arg: any) => void;
+/**
+ * Default equality function using Object.is.
+ */
+export declare const defaultEquals: EqualityFn<any>;
+/**
+ * Safely dispatches a value to a set of listeners.
+ *
+ * Guarantees:
+ * 1. Subscribers receive notifications in order of registration.
+ * 2. Unsubscribing a listener during dispatch takes effect immediately for that tick.
+ * 3. Adding a new listener during dispatch does not invoke it during the current tick.
+ * 4. If any listener throws an error, all other eligible listeners are still executed.
+ * 5. All thrown errors are collected and raised in a single LineFlowSubscriberError.
+ */
+export declare function notifyListeners<T>(listeners: ReadonlySet<Listener<T>>, value: T, contextDescription: string): void;

package/dist/line-flow/utils.js

@@ -0,0 +1,53 @@
+import { LineFlowSubscriberError, LineFlowValidationError } from "./errors.js";
+/**
+ * Validates that an ID is a non-empty string.
+ */
+export function validateId(id, context = "line") {
+    if (typeof id !== "string" || id.trim().length === 0) {
+        throw new LineFlowValidationError(`Invalid ${context} ID: expected a non-empty string, but received ${String(id)}.`);
+    }
+    return id;
+}
+/**
+ * Validates that a listener is a function.
+ */
+export function validateListener(listener) {
+    if (typeof listener !== "function") {
+        throw new LineFlowValidationError(`Invalid listener: expected a function, but received ${typeof listener}.`);
+    }
+}
+/**
+ * Default equality function using Object.is.
+ */
+export const defaultEquals = (a, b) => Object.is(a, b);
+/**
+ * Safely dispatches a value to a set of listeners.
+ *
+ * Guarantees:
+ * 1. Subscribers receive notifications in order of registration.
+ * 2. Unsubscribing a listener during dispatch takes effect immediately for that tick.
+ * 3. Adding a new listener during dispatch does not invoke it during the current tick.
+ * 4. If any listener throws an error, all other eligible listeners are still executed.
+ * 5. All thrown errors are collected and raised in a single LineFlowSubscriberError.
+ */
+export function notifyListeners(listeners, value, contextDescription) {
+    if (listeners.size === 0)
+        return;
+    const errors = [];
+    const snapshot = Array.from(listeners);
+    for (const listener of snapshot) {
+        if (!listeners.has(listener)) {
+            continue;
+        }
+        try {
+            listener(value);
+        }
+        catch (err) {
+            errors.push(err);
+        }
+    }
+    if (errors.length > 0) {
+        throw new LineFlowSubscriberError(`Error(s) encountered in subscriber(s) during ${contextDescription}`, errors);
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/line-flow/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/line-flow/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG/E;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAW,EAAE,OAAO,GAAG,MAAM;IACtD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,uBAAuB,CAC/B,WAAW,OAAO,kDAAkD,MAAM,CAAC,EAAE,CAAC,GAAG,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,uBAAuB,CAC/B,uDAAuD,OAAO,QAAQ,GAAG,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAExE;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAmC,EACnC,KAAQ,EACR,kBAA0B;IAE1B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEvC,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,uBAAuB,CAC/B,gDAAgD,kBAAkB,EAAE,EACpE,MAAM,CACP,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/paramsSerializer.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Advanced Params Serializer
+ *
+ * Serializes complex query parameters including:
+ * - Nested objects: filters[status]=active
+ * - Arrays: ids[]=1&ids[]=2
+ * - Sort objects: sort[field]=name&sort[order]=asc
+ * - Pagination: page=1&per_page=10
+ * - Date ranges: date[from]=2024-01-01&date[to]=2024-12-31
+ *
+ * @example
+ * ```ts
+ * serializeParams({
+ *     page: 1,
+ *     filters: { status: 'active', types: ['a', 'b'] },
+ *     sort: { field: 'name', order: 'asc' }
+ * });
+ * // Returns: "page=1&filters[status]=active&filters[types][]=a&filters[types][]=b&sort[field]=name&sort[order]=asc"
+ * ```
+ */
+export type ParamValue = string | number | boolean | null | undefined | Date | ParamValue[] | {
+    [key: string]: ParamValue;
+};
+export interface SerializerOptions {
+    /**
+     * Array format: 'brackets' for key[]=value, 'indices' for key[0]=value, 'repeat' for key=value&key=value
+     * @default 'brackets'
+     */
+    arrayFormat?: "brackets" | "indices" | "repeat";
+    /**
+     * Whether to encode keys and values
+     * @default true
+     */
+    encode?: boolean;
+    /**
+     * Whether to skip null/undefined values
+     * @default true
+     */
+    skipNull?: boolean;
+    /**
+     * Whether to skip empty strings
+     * @default true
+     */
+    skipEmpty?: boolean;
+}
+/**
+ * Serialize an object of parameters into a query string
+ *
+ * @param params - The parameters object to serialize
+ * @param options - Serialization options
+ * @returns The serialized query string (without leading ?)
+ */
+export declare const serializeParams: (params?: Record<string, ParamValue>, options?: SerializerOptions) => string;
+/**
+ * Create an Axios-compatible params serializer function
+ */
+export declare const createParamsSerializer: (options?: SerializerOptions) => (params: Record<string, ParamValue>) => string;
+/**
+ * Standard pagination params interface
+ */
+export interface PaginationParams {
+    page?: number;
+    perPage?: number;
+    per_page?: number;
+}
+/**
+ * Standard sort params interface
+ */
+export interface SortParams {
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+    sort?: {
+        field?: string;
+        order?: "asc" | "desc";
+    };
+}
+/**
+ * Standard filter params interface (generic)
+ */
+export interface FilterParams<T = Record<string, ParamValue>> {
+    filters?: T;
+    search?: string;
+}
+/**
+ * Combined query params type for list endpoints
+ */
+export type ListQueryParams<TFilters = Record<string, ParamValue>> = PaginationParams & SortParams & FilterParams<TFilters>;

package/dist/paramsSerializer.js

@@ -0,0 +1,138 @@
+/**
+ * Advanced Params Serializer
+ *
+ * Serializes complex query parameters including:
+ * - Nested objects: filters[status]=active
+ * - Arrays: ids[]=1&ids[]=2
+ * - Sort objects: sort[field]=name&sort[order]=asc
+ * - Pagination: page=1&per_page=10
+ * - Date ranges: date[from]=2024-01-01&date[to]=2024-12-31
+ *
+ * @example
+ * ```ts
+ * serializeParams({
+ *     page: 1,
+ *     filters: { status: 'active', types: ['a', 'b'] },
+ *     sort: { field: 'name', order: 'asc' }
+ * });
+ * // Returns: "page=1&filters[status]=active&filters[types][]=a&filters[types][]=b&sort[field]=name&sort[order]=asc"
+ * ```
+ */
+const defaultOptions = {
+    arrayFormat: "brackets",
+    encode: true,
+    skipNull: true,
+    skipEmpty: true,
+};
+/**
+ * Serialize a single value with proper encoding
+ */
+const encodeValue = (value, encode) => {
+    const stringValue = String(value);
+    if (!encode)
+        return stringValue;
+    return encodeURIComponent(stringValue)
+        .replace(/%3D/g, "=")
+        .replace(/%3E/g, ">")
+        .replace(/%3C/g, "<");
+};
+/**
+ * Serialize a key with proper encoding, keeping square brackets unencoded
+ */
+const encodeKey = (key, encode) => {
+    if (!encode)
+        return key;
+    return encodeURIComponent(key).replace(/%5B/g, "[").replace(/%5D/g, "]");
+};
+/**
+ * Build a nested key path like "filters[status]" or "filters[types][]"
+ */
+const buildKey = (prefix, key, isArrayItem, arrayFormat, index) => {
+    if (!prefix) {
+        return key;
+    }
+    if (isArrayItem) {
+        switch (arrayFormat) {
+            case "indices":
+                return `${prefix}[${index}]`;
+            case "repeat":
+                return prefix;
+            case "brackets":
+            default:
+                return `${prefix}[]`;
+        }
+    }
+    return `${prefix}[${key}]`;
+};
+/**
+ * Recursively serialize parameters with circular reference protection
+ */
+const serializeValue = (key, value, options, parts, seen = new WeakSet()) => {
+    // Skip null/undefined
+    if (value === null || value === undefined) {
+        if (!options.skipNull) {
+            parts.push(`${encodeKey(key, options.encode)}=`);
+        }
+        return;
+    }
+    // Skip empty strings
+    if (value === "" && options.skipEmpty) {
+        return;
+    }
+    // Handle Date objects
+    if (value instanceof Date) {
+        parts.push(`${encodeKey(key, options.encode)}=${encodeValue(value.toISOString(), options.encode)}`);
+        return;
+    }
+    // Handle arrays
+    if (Array.isArray(value)) {
+        value.forEach((item, index) => {
+            const arrayKey = buildKey(key, "", true, options.arrayFormat, index);
+            serializeValue(arrayKey, item, options, parts, seen);
+        });
+        return;
+    }
+    // Handle objects (nested params)
+    if (typeof value === "object") {
+        // Circular reference protection
+        if (seen.has(value)) {
+            console.warn(`[paramsSerializer] Circular reference detected for key "${key}", skipping`);
+            return;
+        }
+        seen.add(value);
+        Object.entries(value).forEach(([nestedKey, nestedValue]) => {
+            const fullKey = buildKey(key, nestedKey, false, options.arrayFormat);
+            serializeValue(fullKey, nestedValue, options, parts, seen);
+        });
+        return;
+    }
+    // Handle primitives (string, number, boolean)
+    parts.push(`${encodeKey(key, options.encode)}=${encodeValue(value, options.encode)}`);
+};
+/**
+ * Serialize an object of parameters into a query string
+ *
+ * @param params - The parameters object to serialize
+ * @param options - Serialization options
+ * @returns The serialized query string (without leading ?)
+ */
+export const serializeParams = (params, options) => {
+    if (!params || Object.keys(params).length === 0) {
+        return "";
+    }
+    const mergedOptions = { ...defaultOptions, ...options };
+    const parts = [];
+    Object.entries(params).forEach(([key, value]) => {
+        serializeValue(key, value, mergedOptions, parts);
+    });
+    return parts.join("&");
+};
+/**
+ * Create an Axios-compatible params serializer function
+ */
+export const createParamsSerializer = (options) => {
+    return (params) => {
+        return serializeParams(params, options);
+    };
+};
+//# sourceMappingURL=paramsSerializer.js.map

package/dist/paramsSerializer.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,10 @@
+import type { Manifest, Registry } from "./types";
+export declare const normalizePath: (value: string) => string;
+export declare const joinPath: (...parts: string[]) => string;
+export declare function createRegistry(manifest: Manifest, layouts: string[]): Registry;
+export declare function createPaths(base: string): {
+    main: string;
+    create: () => string;
+    detail: (id: string | number) => string;
+    edit: (id: string | number) => string;
+};

package/dist/registry.js

@@ -0,0 +1,115 @@
+export const normalizePath = (value) => "/" + value.split("/").filter(Boolean).join("/");
+export const joinPath = (...parts) => normalizePath(parts.join("/"));
+const ownerDir = (file) => file.replaceAll("\\", "/").replace(/\/navigation\/index\.[jt]sx?$/, "");
+export function createRegistry(manifest, layouts) {
+    const modules = [];
+    const ids = new Set();
+    for (const { file, definition } of manifest.definitions) {
+        if (!definition || !["module", "feature"].includes(definition.kind))
+            throw new Error(`GoStack: ${file} must default-export defineModule() or defineFeature().`);
+        if (definition.kind !== "module")
+            continue;
+        if (ids.has(definition.id))
+            throw new Error(`GoStack: duplicate module "${definition.id}" in ${file}.`);
+        ids.add(definition.id);
+        if (!layouts.includes(definition.layout))
+            throw new Error(`GoStack: unknown layout "${definition.layout}" in ${file}. Available: ${layouts.join(", ")}.`);
+        modules.push({ dir: ownerDir(file), definition });
+    }
+    const features = [];
+    const disabledSources = [];
+    const featureIds = new Set();
+    const routePaths = new Map();
+    for (const { file, definition } of manifest.definitions) {
+        if (definition.kind !== "feature")
+            continue;
+        const dir = ownerDir(file);
+        const hierarchy = modules
+            .filter((m) => dir.startsWith(m.dir + "/"))
+            .sort((a, b) => a.dir.length - b.dir.length);
+        const parent = hierarchy.at(-1);
+        if (!parent)
+            throw new Error(`GoStack: feature ${file} has no containing module navigation/index.ts.`);
+        const qualifiedId = `${parent.definition.id}/${definition.id}`;
+        if (featureIds.has(qualifiedId))
+            throw new Error(`GoStack: duplicate feature "${qualifiedId}" in ${file}.`);
+        featureIds.add(qualifiedId);
+        const layout = definition.layout ?? parent.definition.layout;
+        if (!layouts.includes(layout))
+            throw new Error(`GoStack: unknown layout "${layout}" in ${file}.`);
+        if (definition.enabled === false ||
+            hierarchy.some((m) => m.definition.enabled === false)) {
+            disabledSources.push(dir);
+            continue;
+        }
+        const base = joinPath(parent.definition.basePath, definition.basePath);
+        const visit = (routes, prefix) => {
+            for (const route of routes) {
+                if (route.index && (route.path !== undefined || route.children))
+                    throw new Error(`GoStack: index route cannot have path or children in ${file}.`);
+                if (route.path?.startsWith("/"))
+                    throw new Error(`GoStack: feature routes must use relative paths in ${file}.`);
+                const full = joinPath(prefix, route.path ?? "");
+                if (!route.children?.length || route.index) {
+                    const signature = full.replace(/:[^/]+/g, ":param").toLowerCase();
+                    if (routePaths.has(signature))
+                        throw new Error(`GoStack: conflicting route "${full}" in ${file} and ${routePaths.get(signature)}.`);
+                    routePaths.set(signature, file);
+                }
+                if (route.children)
+                    visit(route.children, full);
+            }
+        };
+        visit(definition.routes, base);
+        features.push({
+            ...definition,
+            module: parent.definition,
+            ancestors: hierarchy.slice(0, -1).map((m) => m.definition),
+            qualifiedId,
+            namespace: qualifiedId.replaceAll("/", "."),
+            source: dir,
+        });
+    }
+    const resources = {};
+    for (const locale of manifest.locales) {
+        const file = locale.file.replaceAll("\\", "/");
+        if (disabledSources.some((dir) => file.startsWith(dir + "/")))
+            continue;
+        const match = file.match(/\/(?:locales|locals)\/([\w-]+)\.json$/);
+        if (!match)
+            continue;
+        const feature = features
+            .filter((f) => file.startsWith(f.source + "/"))
+            .sort((a, b) => b.source.length - a.source.length)[0];
+        const module = modules
+            .filter((m) => file.startsWith(m.dir + "/"))
+            .sort((a, b) => b.dir.length - a.dir.length)[0];
+        const namespace = feature?.namespace ??
+            (file.includes("/design-system/")
+                ? "designSystem"
+                : module
+                    ? module.definition.id.replaceAll("/", ".")
+                    : "shared");
+        const language = match[1];
+        resources[language] ??= {};
+        if (resources[language][namespace])
+            throw new Error(`GoStack: duplicate translation namespace "${namespace}" for ${language}: ${file}.`);
+        resources[language][namespace] = locale.data;
+    }
+    return {
+        modules: modules
+            .map((m) => m.definition)
+            .filter((m) => m.enabled !== false),
+        features,
+        resources,
+    };
+}
+export function createPaths(base) {
+    return {
+        main: normalizePath(base),
+        create: () => joinPath(base, "create"),
+        detail: (id) => joinPath(base, encodeURIComponent(String(id))),
+        edit: (id) => joinPath(base, encodeURIComponent(String(id)), "edit"),
+    };
+}
+//# sourceMappingURL=registry.js.map