@ereo/core 0.1.6

package/dist/plugin.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @ereo/core - Plugin System
+ *
+ * A simple yet powerful plugin system inspired by Vite.
+ * Plugins can hook into various lifecycle events and transform code.
+ */
+import type { Plugin, DevServer, FrameworkConfig } from './types';
+/**
+ * Plugin registry for managing framework plugins.
+ */
+export declare class PluginRegistry {
+    private plugins;
+    private context;
+    constructor(config: FrameworkConfig, mode: 'development' | 'production', root: string);
+    /**
+     * Register a plugin.
+     */
+    register(plugin: Plugin): Promise<void>;
+    /**
+     * Register multiple plugins.
+     */
+    registerAll(plugins: Plugin[]): Promise<void>;
+    /**
+     * Get all registered plugins.
+     */
+    getPlugins(): readonly Plugin[];
+    /**
+     * Get a plugin by name.
+     */
+    getPlugin(name: string): Plugin | undefined;
+    /**
+     * Run transform hooks on code.
+     */
+    transform(code: string, id: string): Promise<string>;
+    /**
+     * Resolve a module ID (for virtual modules).
+     */
+    resolveId(id: string): string | null;
+    /**
+     * Load a virtual module.
+     */
+    load(id: string): Promise<string | null>;
+    /**
+     * Configure the dev server with all plugins.
+     */
+    configureServer(server: DevServer): Promise<void>;
+    /**
+     * Run buildStart hooks.
+     */
+    buildStart(): Promise<void>;
+    /**
+     * Run buildEnd hooks.
+     */
+    buildEnd(): Promise<void>;
+}
+/**
+ * Helper to create a plugin with proper typing.
+ */
+export declare function definePlugin(plugin: Plugin): Plugin;
+/**
+ * Compose multiple plugins into one.
+ */
+export declare function composePlugins(name: string, plugins: Plugin[]): Plugin;
+/**
+ * Built-in security headers plugin.
+ * Adds sensible security defaults to all responses.
+ */
+export declare const securityHeadersPlugin: Plugin;
+/**
+ * Check if a value is a valid plugin.
+ */
+export declare function isPlugin(value: unknown): value is Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEjF;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAgB;gBAEnB,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,GAAG,YAAY,EAAE,IAAI,EAAE,MAAM;IAIrF;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB7C;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD;;OAEG;IACH,UAAU,IAAI,SAAS,MAAM,EAAE;IAI/B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe1D;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAYpC;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAY9C;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAkEtE;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAKhC,CAAC;AAEH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOxD"}

package/dist/types/path-parser.d.ts

@@ -0,0 +1,200 @@
+/**
+ * @ereo/core - Compile-Time Path Parser Types
+ *
+ * Template literal types for parsing route paths and extracting typed parameters.
+ * Infers { id: string; postId: string } from '/users/[id]/posts/[postId]'.
+ *
+ * Supports:
+ * - Dynamic params: [id] → { id: string }
+ * - Optional params: [[page]] → { page?: string }
+ * - Catch-all params: [...path] → { path: string[] }
+ *
+ * Performance optimizations:
+ * - Object maps instead of tuples for better TypeScript compiler performance
+ * - Lazy evaluation patterns to defer computation
+ * - Maximum depth guards to prevent infinite recursion
+ */
+/**
+ * Trim leading slashes from a path string.
+ */
+type TrimLeadingSlash<T extends string> = T extends `/${infer Rest}` ? TrimLeadingSlash<Rest> : T;
+/**
+ * Trim trailing slashes from a path string.
+ */
+type TrimTrailingSlash<T extends string> = T extends `${infer Rest}/` ? TrimTrailingSlash<Rest> : T;
+/**
+ * Normalize a path by removing leading/trailing slashes.
+ */
+type NormalizePath<T extends string> = TrimLeadingSlash<TrimTrailingSlash<T>>;
+/**
+ * Represents a parsed path segment.
+ */
+type ParsedSegment = {
+    type: 'static';
+    value: string;
+} | {
+    type: 'dynamic';
+    name: string;
+} | {
+    type: 'optional';
+    name: string;
+} | {
+    type: 'catchAll';
+    name: string;
+};
+/**
+ * Parse a single path segment into its type.
+ *
+ * Examples:
+ * - 'users' → { type: 'static'; value: 'users' }
+ * - '[id]' → { type: 'dynamic'; name: 'id' }
+ * - '[[page]]' → { type: 'optional'; name: 'page' }
+ * - '[...path]' → { type: 'catchAll'; name: 'path' }
+ */
+type ParseSegment<S extends string> = S extends `[[${infer Name}]]` ? {
+    type: 'optional';
+    name: Name;
+} : S extends `[...${infer Name}]` ? {
+    type: 'catchAll';
+    name: Name;
+} : S extends `[${infer Name}]` ? {
+    type: 'dynamic';
+    name: Name;
+} : {
+    type: 'static';
+    value: S;
+};
+/**
+ * Split a path string into an array of segment strings.
+ */
+type SplitPath<Path extends string, Acc extends string[] = []> = Path extends `${infer Segment}/${infer Rest}` ? Segment extends '' ? SplitPath<Rest, Acc> : SplitPath<Rest, [...Acc, Segment]> : Path extends '' ? Acc : [...Acc, Path];
+/**
+ * Parse all segments of a path into ParsedSegment types.
+ */
+type ParsePathSegments<Path extends string, Segments extends string[] = SplitPath<NormalizePath<Path>>> = {
+    [K in keyof Segments]: ParseSegment<Segments[K] & string>;
+};
+/**
+ * Extract a single parameter entry from a parsed segment.
+ * Returns empty object for static segments.
+ */
+type ExtractParamFromSegment<Seg> = Seg extends {
+    type: 'dynamic';
+    name: infer N extends string;
+} ? {
+    [K in N]: string;
+} : Seg extends {
+    type: 'optional';
+    name: infer N extends string;
+} ? {
+    [K in N]?: string;
+} : Seg extends {
+    type: 'catchAll';
+    name: infer N extends string;
+} ? {
+    [K in N]: string[];
+} : {};
+/**
+ * Merge two types into one, combining their properties.
+ * Uses intersection and simplification for cleaner output.
+ */
+type Merge<A, B> = {
+    [K in keyof A | keyof B]: K extends keyof B ? B[K] : K extends keyof A ? A[K] : never;
+};
+/**
+ * Extract parameters from a tuple of parsed segments.
+ * Uses recursive type with accumulator for performance.
+ */
+type ExtractParamsFromSegments<Segments extends readonly unknown[], Acc = {}> = Segments extends readonly [infer First, ...infer Rest] ? ExtractParamsFromSegments<Rest, Merge<Acc, ExtractParamFromSegment<First>>> : Acc;
+/**
+ * Extract all parameters from parsed path segments.
+ */
+type ExtractParams<Segments> = Segments extends readonly unknown[] ? ExtractParamsFromSegments<Segments> : {};
+/**
+ * Infer parameter types from a route path pattern.
+ *
+ * This is the main entry point for path parameter inference.
+ *
+ * @example
+ * type Params1 = InferParams<'/users/[id]'>;
+ * // { id: string }
+ *
+ * type Params2 = InferParams<'/users/[id]/posts/[postId]'>;
+ * // { id: string; postId: string }
+ *
+ * type Params3 = InferParams<'/docs/[...path]'>;
+ * // { path: string[] }
+ *
+ * type Params4 = InferParams<'/blog/[[page]]'>;
+ * // { page?: string }
+ *
+ * type Params5 = InferParams<'/users/[id]/posts/[[postId]]/[...tags]'>;
+ * // { id: string; postId?: string; tags: string[] }
+ */
+export type InferParams<Path extends string> = ExtractParams<ParsePathSegments<Path>>;
+/**
+ * Check if a path has any dynamic parameters.
+ */
+export type HasParams<Path extends string> = keyof InferParams<Path> extends never ? false : true;
+/**
+ * Get the parameter names from a path.
+ */
+export type ParamNames<Path extends string> = keyof InferParams<Path>;
+/**
+ * Check if a parameter is optional.
+ */
+export type IsOptionalParam<Path extends string, Name extends string> = {} extends Pick<InferParams<Path>, Name & keyof InferParams<Path>> ? true : false;
+/**
+ * Check if a parameter is a catch-all.
+ */
+export type IsCatchAllParam<Path extends string, Name extends string> = Name extends keyof InferParams<Path> ? InferParams<Path>[Name] extends string[] ? true : false : false;
+/**
+ * Build a concrete path from a pattern and params.
+ * This is a type-level representation; actual building happens at runtime.
+ */
+export type BuildPath<Pattern extends string, Params extends InferParams<Pattern>> = string;
+/**
+ * Validate that params match the expected shape for a path.
+ * Returns true if valid, error message if invalid.
+ */
+export type ValidateParams<Path extends string, Params> = Params extends InferParams<Path> ? true : `Invalid params for path "${Path}". Expected: ${keyof InferParams<Path> & string}`;
+/**
+ * Extract the static prefix of a path (before first dynamic segment).
+ *
+ * @example
+ * type Prefix = StaticPrefix<'/users/[id]/posts'>;
+ * // '/users'
+ */
+export type StaticPrefix<Path extends string> = Path extends `${infer Static}[${string}` ? TrimTrailingSlash<Static> : Path;
+/**
+ * Check if a path is fully static (no dynamic segments).
+ */
+export type IsStaticPath<Path extends string> = Path extends `${string}[${string}` ? false : true;
+/**
+ * Get the parent path (remove last segment).
+ */
+export type ParentPath<Path extends string> = NormalizePath<Path> extends `${infer Parent}/${string}` ? `/${Parent}` : '/';
+/**
+ * Check if a path pattern can match a concrete path.
+ * This is a simplified type-level check.
+ */
+export type PathMatches<Pattern extends string, Path extends string> = InferParams<Pattern> extends Record<string, never> ? Pattern extends Path ? true : false : boolean;
+/**
+ * Union of all possible concrete paths for static paths.
+ * Dynamic paths return string as they can match many concrete paths.
+ */
+export type PossiblePaths<Pattern extends string> = IsStaticPath<Pattern> extends true ? Pattern : string;
+/**
+ * Branded type to preserve path information through transformations.
+ * Used by the builder pattern to maintain type safety.
+ */
+declare const PathBrand: unique symbol;
+export type BrandedPath<Path extends string> = string & {
+    readonly [PathBrand]: Path;
+};
+/**
+ * Extract the original path from a branded path type.
+ */
+export type UnbrandPath<T> = T extends BrandedPath<infer Path> ? Path : never;
+export type { ParsedSegment, ParseSegment, ParsePathSegments, SplitPath, ExtractParams, };
+//# sourceMappingURL=path-parser.d.ts.map

package/dist/types/path-parser.d.ts.map

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