purity-world 1.0.0

package/types/http.d.ts

@@ -0,0 +1,211 @@
+import { type Signal } from './core';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+export type HttpResponseType = 'json' | 'text' | 'blob' | 'arraybuffer' | 'stream';
+export interface HttpRequestOptions {
+    headers?: Record<string, string | string[]> | HttpHeaders | Headers;
+    params?: Record<string, string | number | boolean | (string | number | boolean)[]> | HttpParams | URLSearchParams | string;
+    body?: any;
+    responseType?: HttpResponseType;
+    timeout?: number;
+    signal?: AbortSignal;
+    withCredentials?: boolean;
+    context?: Record<string, any> | Map<string, any>;
+}
+/**
+ * Immutable, case-insensitive HTTP headers container.
+ */
+export declare class HttpHeaders {
+    private map;
+    private displayNames;
+    constructor(headers?: Record<string, string | string[]> | HttpHeaders | Headers | [string, string | string[]][]);
+    private clone;
+    has(name: string): boolean;
+    get(name: string): string | null;
+    getAll(name: string): string[] | null;
+    keys(): string[];
+    set(name: string, value: string | string[]): HttpHeaders;
+    append(name: string, value: string | string[]): HttpHeaders;
+    delete(name: string): HttpHeaders;
+    forEach(fn: (value: string, name: string, headers: HttpHeaders) => void): void;
+    toRecord(): Record<string, string>;
+    toHeaders(): Headers;
+}
+/**
+ * Immutable URL query parameters container.
+ */
+export declare class HttpParams {
+    private map;
+    constructor(params?: Record<string, string | number | boolean | (string | number | boolean)[]> | HttpParams | URLSearchParams | string);
+    private clone;
+    has(name: string): boolean;
+    get(name: string): string | null;
+    getAll(name: string): string[] | null;
+    keys(): string[];
+    set(name: string, value: string | number | boolean | (string | number | boolean)[]): HttpParams;
+    append(name: string, value: string | number | boolean | (string | number | boolean)[]): HttpParams;
+    delete(name: string): HttpParams;
+    toString(): string;
+}
+/**
+ * Representation of an outgoing HTTP request.
+ */
+export declare class HttpRequest<T = any> {
+    readonly method: HttpMethod;
+    readonly url: string;
+    readonly headers: HttpHeaders;
+    readonly params: HttpParams;
+    readonly body: T | null;
+    readonly responseType: HttpResponseType;
+    readonly timeout?: number;
+    readonly signal?: AbortSignal;
+    readonly withCredentials?: boolean;
+    readonly context: Map<string, any>;
+    constructor(method: HttpMethod, url: string, options?: HttpRequestOptions);
+    /**
+     * Creates an immutable clone with updated properties.
+     */
+    clone(update?: Partial<HttpRequestOptions & {
+        method?: HttpMethod;
+        url?: string;
+    }>): HttpRequest<any>;
+    /**
+     * Resolves the full URL including serialized query parameters.
+     */
+    getUrlWithParams(): string;
+}
+/**
+ * Representation of an incoming HTTP response.
+ */
+export declare class HttpResponse<T = any> {
+    readonly data: T;
+    readonly status: number;
+    readonly statusText: string;
+    readonly headers: HttpHeaders;
+    readonly url: string;
+    readonly ok: boolean;
+    readonly request: HttpRequest;
+    constructor(init: {
+        data: T;
+        status: number;
+        statusText: string;
+        headers: HttpHeaders;
+        url: string;
+        request: HttpRequest;
+    });
+}
+/**
+ * Custom error thrown when an HTTP request fails or returns a non-2xx status.
+ */
+export declare class HttpErrorResponse extends Error {
+    readonly error: any;
+    readonly status: number;
+    readonly statusText: string;
+    readonly url: string;
+    readonly headers: HttpHeaders;
+    readonly request: HttpRequest;
+    constructor(init: {
+        error: any;
+        status: number;
+        statusText: string;
+        url: string;
+        headers: HttpHeaders;
+        request: HttpRequest;
+        message?: string;
+    });
+}
+export type HttpNextFn = (req: HttpRequest) => Promise<HttpResponse<any>>;
+/**
+ * HTTP Interceptor contract for intercepting and mutating requests and responses.
+ */
+export interface HttpInterceptor {
+    intercept(req: HttpRequest, next: HttpNextFn): Promise<HttpResponse<any>>;
+}
+export type HttpInterceptorFn = (req: HttpRequest, next: HttpNextFn) => Promise<HttpResponse<any>>;
+export declare const HTTP_INTERCEPTORS = "HTTP_INTERCEPTORS";
+/**
+ * Provider helper to register centralized HTTP interceptors for bootstrapApplication.
+ */
+export declare function provideHttpInterceptors(...interceptors: Array<HttpInterceptor | (new (...args: any[]) => HttpInterceptor) | HttpInterceptorFn>): {
+    provide: string;
+    useValue: Array<HttpInterceptor | HttpInterceptorFn>;
+};
+/**
+ * Default HTTP fetch backend executing requests via window.fetch().
+ */
+export declare class HttpFetchBackend {
+    handle(req: HttpRequest): Promise<HttpResponse<any>>;
+}
+export interface HttpResource<T> {
+    data: Signal<T | null>;
+    loading: Signal<boolean>;
+    error: Signal<HttpErrorResponse | Error | null>;
+    status: Signal<number | null>;
+    refetch: () => Promise<HttpResponse<T> | null>;
+}
+/**
+ * Starts the animated Breeze progress/loading cursor.
+ * Supports reference counting across multiple concurrent HTTP requests and loaders.
+ */
+export declare function startLoadingCursor(): void;
+/**
+ * Stops the animated Breeze progress/loading cursor when all holders have released it.
+ */
+export declare function stopLoadingCursor(): void;
+/**
+ * Injectable HTTP Client Service providing comprehensive HTTP methods,
+ * interceptor pipeline chaining, and reactive signal helpers.
+ */
+export declare class HttpClient {
+    private backend;
+    private interceptors;
+    activeRequests: Signal<number>;
+    isLoading: Signal<boolean>;
+    constructor();
+    /**
+     * Appends an interceptor into the execution pipeline.
+     */
+    addInterceptor(interceptor: HttpInterceptor | HttpInterceptorFn): () => void;
+    /**
+     * Method chaining alias for adding interceptors.
+     */
+    use(interceptor: HttpInterceptor | HttpInterceptorFn): this;
+    /**
+     * Core request dispatcher executing through the interceptor pipeline.
+     */
+    request<T = any>(method: HttpMethod, url: string, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Standard HTTP GET request.
+     */
+    get<T = any>(url: string, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Standard HTTP POST request.
+     */
+    post<T = any>(url: string, body?: any, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Standard HTTP PUT request.
+     */
+    put<T = any>(url: string, body?: any, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Standard HTTP PATCH request.
+     */
+    patch<T = any>(url: string, body?: any, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Standard HTTP DELETE request.
+     */
+    delete<T = any>(url: string, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Standard HTTP HEAD request.
+     */
+    head(url: string, options?: HttpRequestOptions): Promise<HttpResponse<null>>;
+    /**
+     * Standard HTTP OPTIONS request.
+     */
+    options<T = any>(url: string, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * Reactive Signal Resource Helper.
+     * Generates fine-grained reactive signals (`data`, `loading`, `error`, `status`)
+     * that automatically manage request lifecycle and enable effortless template binding.
+     */
+    createResource<T>(fetcher: () => Promise<HttpResponse<T>>, autoFetch?: boolean): HttpResource<T>;
+}
+//# sourceMappingURL=http.d.ts.map

package/types/http.d.ts.map

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

package/types/pipe.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Interface defining the contract for Purity transform pipes.
+ */
+export interface PipeTransform {
+    transform(value: any, ...args: any[]): any;
+}
+/**
+ * Base class for Purity transform pipes.
+ */
+export declare abstract class BasePipe implements PipeTransform {
+    abstract transform(value: any, ...args: any[]): any;
+}
+export interface PipeOptions {
+    name: string;
+}
+/**
+ * Pipe decorator that registers a transform pipe class under the given name.
+ *
+ * @param nameOrOptions Pipe name (e.g. 'myTransformPipe' or 'uppercase') or options object
+ */
+export declare function Pipe(nameOrOptions: string | PipeOptions): any;
+/**
+ * Programmatically registers a pipe class by name.
+ */
+export declare function registerPipe(name: string, pipeClass: any): void;
+/**
+ * Resolves a singleton instance of the registered pipe class.
+ */
+export declare function getPipe(name: string): PipeTransform | null;
+/**
+ * Executes a pipe transform function at runtime.
+ */
+export declare function executePipe(name: string, value: any, ...args: any[]): any;
+//# sourceMappingURL=pipe.d.ts.map

package/types/pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../src/framework/pipe.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;CAC9C;AAED;;GAEG;AACH,8BAAsB,QAAS,YAAW,aAAa;IACnD,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;CACvD;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;CAChB;AAKD;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,GAAG,GAAG,CAa7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,CAG/D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAgB1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAYzE"}

package/types/router.d.ts

@@ -0,0 +1,145 @@
+import { type Signal } from './core';
+import { type Token, type Constructor } from './di';
+import { BaseDirective } from './directive';
+import type { SeoConfig } from './seo';
+export type CanActivateFn = (route: Route, state: RouterState) => boolean | Promise<boolean>;
+export interface RouteData {
+    [key: string]: any;
+}
+export type RouteParams = Record<string, string>;
+export type QueryParams = Record<string, string>;
+export interface Route {
+    path: string;
+    component?: Constructor | string;
+    redirectTo?: string;
+    title?: string | ((params: RouteParams) => string);
+    seo?: SeoConfig | ((params: RouteParams, data: RouteData) => SeoConfig);
+    canActivate?: Array<CanActivateFn | Token>;
+    data?: RouteData;
+    children?: Route[];
+}
+export type Routes = Route[];
+export interface RouterState {
+    url: string;
+    path: string;
+    params: RouteParams;
+    queryParams: QueryParams;
+    data: RouteData;
+}
+export interface NavigationOptions {
+    replaceUrl?: boolean;
+    queryParams?: QueryParams;
+    state?: any;
+    skipLocationChange?: boolean;
+}
+export interface RouterOptions {
+    mode?: 'history' | 'hash' | 'memory';
+    initialUrl?: string;
+    scrollRestoration?: boolean;
+}
+/**
+ * Normalizes route path strings by trimming trailing slashes while preserving root `/`.
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Parses query strings like `?key=val&foo=bar` into typed object records.
+ */
+export declare function parseQueryString(queryString: string): QueryParams;
+/**
+ * Serializes query parameters object into query string `?key=val&foo=bar`.
+ */
+export declare function serializeQueryParams(params: QueryParams): string;
+/**
+ * Matches a URL pathname against a route pattern (e.g. `/users/:id` or `**`),
+ * returning extracted route parameters or null if not matched.
+ */
+export declare function matchRoutePattern(routePattern: string, pathname: string): {
+    matched: boolean;
+    params: RouteParams;
+} | null;
+/**
+ * Purity Framework Router Service
+ * Fine-grained, signal-based routing service managing history, parameter extraction, and route guards.
+ */
+export declare class Router {
+    private routes;
+    private options;
+    private isListening;
+    readonly url: Signal<string>;
+    readonly path: Signal<string>;
+    readonly params: Signal<RouteParams>;
+    readonly queryParams: Signal<QueryParams>;
+    readonly data: Signal<RouteData>;
+    readonly activeRoute: Signal<Route | null>;
+    constructor();
+    /**
+     * Configures the route table and initial options for the application router.
+     */
+    configureRoutes(routes: Route[], options?: RouterOptions): void;
+    /**
+     * Returns the configured route definitions.
+     */
+    getRoutes(): Route[];
+    /**
+     * Starts listening to browser navigation events (popstate / hashchange).
+     */
+    private startListening;
+    /**
+     * Extracts current URL from window.location based on router mode.
+     */
+    private getCurrentLocationUrl;
+    /**
+     * Navigates to a target route path with optional query parameters and options.
+     */
+    navigate(targetPath: string, options?: NavigationOptions): Promise<boolean>;
+    /**
+     * Navigates to a full URL (including pathname and query parameters).
+     */
+    navigateByUrl(fullUrl: string, options?: NavigationOptions): Promise<boolean>;
+    /**
+     * Resolves the matching route definition and params from the route table.
+     */
+    private findMatchingRoute;
+    /**
+     * Navigates back in browser history.
+     */
+    back(): void;
+    /**
+     * Navigates forward in browser history.
+     */
+    forward(): void;
+    /**
+     * Returns the active router options.
+     */
+    getOptions(): RouterOptions;
+    /**
+     * Checks whether a given path is currently active.
+     */
+    isActive(targetPath: string, exact?: boolean): boolean;
+}
+/**
+ * <router-layout> Component
+ * Host container that dynamically instantiates and mounts components for the currently active route.
+ */
+export declare class RouterLayoutComponent {
+    private router;
+    private currentRenderedComponent;
+    private currentMountedElement;
+    protected onInit(): void;
+    protected onDestroy(): void;
+    private teardownCurrentComponent;
+    private renderRouteComponent;
+}
+/**
+ * routerLink Directive
+ * Binds click events on anchor tags or buttons to trigger programmatic SPA router navigation,
+ * and dynamically manages .active-link and .active-route CSS classes.
+ */
+export declare class RouterLinkDirective extends BaseDirective {
+    private router;
+    private clickHandler?;
+    onInit(): void;
+    onChanges(newValue: any): void;
+    onDestroy(): void;
+}
+//# sourceMappingURL=router.d.ts.map

package/types/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/framework/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAyB,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,MAAM,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAa,MAAM,aAAa,CAAC;AAEvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,MAAM,aAAa,GAAG,CACxB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,WAAW,KACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,WAAW,SAAS;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,KAAK;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,CAAC,CAAC;IACnD,GAAG,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC;IACxE,WAAW,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;CACtB;AAED,MAAM,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;AAE7B,MAAM,WAAW,WAAW;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAejE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAKhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACjB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAuDlD;AAED;;;GAGG;AACH,qBACa,MAAM;IACf,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAgE;IAC/E,OAAO,CAAC,WAAW,CAAS;IAG5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAe;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAe;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAc;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,CAAc;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAc;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,CAAgB;IAE1D,cAKC;IAED;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAS9D;IAED;;OAEG;IACH,SAAS,IAAI,KAAK,EAAE,CAEnB;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQhF;IAED;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAyHlF;IAED;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,IAAI,IAAI,IAAI,CAIX;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAId;IAED;;OAEG;IACH,UAAU,IAAI,aAAa,CAE1B;IAED;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAO5D;CACJ;AAED;;;GAGG;AACH,qBAGa,qBAAqB;IAC9B,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,wBAAwB,CAAa;IAC7C,OAAO,CAAC,qBAAqB,CAA4B;IAEzD,SAAS,CAAC,MAAM,IAAI,IAAI,CASvB;IAED,SAAS,CAAC,SAAS,IAAI,IAAI,CAE1B;IAED,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,oBAAoB;CA+D/B;AAED;;;;GAIG;AACH,qBACa,mBAAoB,SAAQ,aAAa;IAClD,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,YAAY,CAAC,CAA0B;IAE/C,MAAM,IAAI,IAAI,CA4Bb;IAED,SAAS,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAE7B;IAED,SAAS,IAAI,IAAI,CAIhB;CACJ"}

package/types/seo.d.ts

@@ -0,0 +1,134 @@
+export interface MetaDefinition {
+    name?: string;
+    property?: string;
+    httpEquiv?: string;
+    content: string;
+    [prop: string]: any;
+}
+export interface OpenGraphConfig {
+    title?: string;
+    description?: string;
+    url?: string;
+    type?: string;
+    image?: string;
+    imageSecureUrl?: string;
+    imageType?: string;
+    imageWidth?: number | string;
+    imageHeight?: number | string;
+    imageAlt?: string;
+    siteName?: string;
+    locale?: string;
+    [prop: string]: any;
+}
+export interface TwitterCardConfig {
+    card?: 'summary' | 'summary_large_image' | 'app' | 'player' | string;
+    site?: string;
+    creator?: string;
+    title?: string;
+    description?: string;
+    image?: string;
+    imageAlt?: string;
+    [prop: string]: any;
+}
+export interface RobotsOptions {
+    index?: boolean;
+    follow?: boolean;
+    noarchive?: boolean;
+    nosnippet?: boolean;
+    maxSnippet?: number;
+    maxImagePreview?: 'none' | 'standard' | 'large';
+    maxVideoPreview?: number;
+}
+export interface SeoConfig {
+    title?: string;
+    titlePrefix?: string;
+    titleSuffix?: string;
+    description?: string;
+    keywords?: string | string[];
+    author?: string;
+    canonical?: string;
+    robots?: RobotsOptions | string;
+    og?: OpenGraphConfig;
+    twitter?: TwitterCardConfig;
+    jsonLd?: Record<string, any> | Array<Record<string, any>>;
+    metaTags?: MetaDefinition[];
+}
+/**
+ * Purity Framework SEO & Head Metadata Service
+ * Fine-grained service managing document titles, canonical links, OpenGraph, Twitter Cards,
+ * meta tags, robots directives, and Schema.org JSON-LD structured data.
+ */
+export declare class SeoService {
+    private defaultSiteName;
+    private currentConfig;
+    /**
+     * Updates the document title and synchronized title meta tags.
+     */
+    setTitle(title: string, options?: {
+        prefix?: string;
+        suffix?: string;
+        separator?: string;
+    }): void;
+    /**
+     * Returns the current document title.
+     */
+    getTitle(): string;
+    /**
+     * Updates the meta description across primary, OpenGraph, and Twitter tags.
+     */
+    setDescription(description: string): void;
+    /**
+     * Updates the meta keywords tag.
+     */
+    setKeywords(keywords: string | string[]): void;
+    /**
+     * Updates or creates the canonical link tag and corresponding URL tags.
+     */
+    setCanonicalUrl(url: string): void;
+    /**
+     * Configures crawler indexing and robots directives.
+     */
+    setRobots(options: RobotsOptions | string): void;
+    /**
+     * Configures Open Graph metadata tags for rich social media sharing previews.
+     */
+    setOpenGraph(og: OpenGraphConfig): void;
+    /**
+     * Configures Twitter Card metadata tags.
+     */
+    setTwitterCard(twitter: TwitterCardConfig): void;
+    /**
+     * Injects or updates a Schema.org JSON-LD structured data script.
+     */
+    setJsonLd(schema: Record<string, any> | Array<Record<string, any>>, id?: string): void;
+    /**
+     * Updates an existing meta tag or creates a new one if it does not exist.
+     */
+    updateTag(tag: MetaDefinition): HTMLMetaElement | null;
+    /**
+     * Finds and returns a matching meta tag by CSS selector.
+     */
+    getTag(attrSelector: string): HTMLMetaElement | null;
+    /**
+     * Removes a meta tag matching the given attribute selector.
+     */
+    removeTag(attrSelector: string): void;
+    /**
+     * Batch updates full SEO metadata for a route, page, or view.
+     */
+    setSeo(config: SeoConfig): void;
+    /**
+     * Returns the active SEO metadata snapshot.
+     */
+    getSeo(): SeoConfig;
+    /**
+     * Generates a precise CSS selector to locate an existing meta tag.
+     */
+    private buildTagSelector;
+}
+/**
+ * MetaService is an alias for SeoService to support standard metadata naming conventions.
+ */
+export declare class MetaService extends SeoService {
+}
+//# sourceMappingURL=seo.d.ts.map

package/types/seo.d.ts.map

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

package/types/validator.d.ts

@@ -0,0 +1,73 @@
+import type { Constructor } from './di';
+export interface FieldValidationConfig {
+    selector: string;
+    validClass?: string;
+    invalidClass?: string;
+    validate?: (value: string, element: HTMLElement) => boolean;
+}
+export interface ValidatorOptions {
+    form: string;
+    fields: Record<string, string | FieldValidationConfig>;
+    validClass?: string;
+    invalidClass?: string;
+    events?: string[];
+}
+export interface ValidatorLifecycle {
+    form: HTMLFormElement | HTMLElement | null;
+    fields: Map<string, HTMLElement>;
+    submitButtons: HTMLElement[];
+    isValid: boolean;
+    onInit?(): void;
+    onDestroy?(): void;
+    validateAll?(): boolean;
+    updateFormState?(isValid: boolean): void;
+    onFieldChange?(fieldName: string, value: string, isValid: boolean, element: HTMLElement): void;
+    onStateChange?(isValid: boolean, validator: this): void;
+    [key: string]: any;
+}
+export declare abstract class BaseValidator implements ValidatorLifecycle {
+    form: HTMLFormElement | HTMLElement | null;
+    fields: Map<string, HTMLElement>;
+    submitButtons: HTMLElement[];
+    isValid: boolean;
+    onInit?(): void;
+    onDestroy?(): void;
+    onFieldChange?(fieldName: string, value: string, isValid: boolean, element: HTMLElement): void;
+    onStateChange?(isValid: boolean, validator: this): void;
+    validateAll(): boolean;
+    updateFormState(isValid: boolean): void;
+}
+export declare const validatorRegistry: Map<string, {
+    constructor: Constructor<ValidatorLifecycle>;
+    options: ValidatorOptions;
+}>;
+/**
+ * Decorator to register a class as a Form Validator.
+ * Automatically tracks field mutations and toggles submit button disabled states and CSS classes.
+ *
+ * @example
+ * ```typescript
+ * @Validator({
+ *     form: '.forms-validation-form',
+ *     fields: {
+ *         input1: '#input1',
+ *         input2: '#input2',
+ *     },
+ *     validClass: 'is-valid',
+ *     invalidClass: 'is-invalid',
+ * })
+ * export class MyFormValidator extends BaseValidator {
+ *     validateInput1(value: string): boolean {
+ *         return value.trim().length >= 3;
+ *     }
+ * }
+ * ```
+ */
+export declare function Validator(options: ValidatorOptions): <T extends Constructor>(target: T, _context?: ClassDecoratorContext<T> | any) => T | void;
+/**
+ * Scans a DOM tree for forms matching registered validators and attaches form and field validation.
+ */
+export declare function bindValidators(root: HTMLElement, _context?: any): Array<{
+    destroy: () => void;
+}>;
+//# sourceMappingURL=validator.d.ts.map

package/types/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/framework/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAExC,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC;CAC/D;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAAC,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI,CAAC;IAC3C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjC,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,IAAI,IAAI,CAAC;IAChB,SAAS,CAAC,IAAI,IAAI,CAAC;IACnB,WAAW,CAAC,IAAI,OAAO,CAAC;IACxB,eAAe,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,aAAa,CAAC,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,WAAW,GACrB,IAAI,CAAC;IACR,aAAa,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACxD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,8BAAsB,aAAc,YAAW,kBAAkB;IAC7D,IAAI,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI,CAAQ;IAClD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAa;IAC7C,aAAa,EAAE,WAAW,EAAE,CAAM;IAClC,OAAO,EAAE,OAAO,CAAS;IAEzB,MAAM,CAAC,IAAI,IAAI,CAAC;IAChB,SAAS,CAAC,IAAI,IAAI,CAAC;IACnB,aAAa,CAAC,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,WAAW,GACrB,IAAI,CAAC;IACR,aAAa,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IAExD,WAAW,IAAI,OAAO,CAErB;IAED,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtC;CACJ;AAED,eAAO,MAAM,iBAAiB;iBAGT,WAAW,CAAC,kBAAkB,CAAC;aACnC,gBAAgB;EAE9B,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,IAC9B,CAAC,SAAS,WAAW,UAC1B,CAAC,aACE,qBAAqB,CAAC,CAAC,CAAC,GAAG,GAAG,KAC1C,CAAC,GAAG,IAAI,CAQd;AAkCD;;GAEG;AACH,wBAAgB,cAAc,CAC1B,IAAI,EAAE,WAAW,EACjB,QAAQ,GAAE,GAAU,GACrB,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,CA0MhC"}

package/types/virtual-for.d.ts

@@ -0,0 +1,36 @@
+export interface VirtualForOptions {
+    itemHeight: number;
+    buffer: number;
+    height?: string;
+    dynamicHeight?: boolean;
+    scrollIndexExpr?: string;
+    scrollAlign?: 'start' | 'center' | 'end';
+}
+export interface VirtualScrollMetrics {
+    totalItems: number;
+    renderedCount: number;
+    startIndex: number;
+    endIndex: number;
+    scrollTop: number;
+    totalHeight: number;
+    itemHeight: number;
+}
+export declare function getVirtualForAttribute(el: Element): string | null;
+export declare function hasVirtualForAttribute(el: Element): boolean;
+export declare function removeVirtualForAttributes(el: Element): void;
+/**
+ * Parses virtual-for expression:
+ * e.g. "let item, index of items; itemHeight: 48; buffer: 8; height: 420px; scrollIndex: jumpSignal"
+ */
+export declare function parseVirtualForExpression(rawExpr: string): {
+    itemVar: string;
+    indexVar: string;
+    arrayExpr: string;
+    options: VirtualForOptions;
+};
+/**
+ * Binds high-performance virtual scrolling repeater on elements with `virtual-for`
+ * or inside `<virtual-scroll>` custom containers.
+ */
+export declare function bindVirtualFor(rootEl: HTMLElement, context: any, componentInstance: any, bindTemplateTreeFn: (root: HTMLElement, ctx: any, inst: any) => void, evaluateValueFn: (expr: string, ctx: any) => any, isInsideNestedComponentFn: (node: Node, root: HTMLElement) => boolean): void;
+//# sourceMappingURL=virtual-for.d.ts.map