@craft-ts/core 0.7.0-beta.13 → 0.7.0-beta.16

package/src/lib/craft-route-meta.d.ts

@@ -1,7 +1,7 @@
-import type { WritableSignal } from './host/craft-compat';
-import type { ActivatedRouteSnapshot, RouterStateSnapshot } from './host/craft-router-types';
-import type { CraftRouteExceptionHandlerMap } from './craft-guard-runtime';
-import type { CraftExceptionComponentInput, CraftPendingComponentInput } from './craft-route-exceptions';
+import type { WritableSignal } from './host/craft-compat.js';
+import type { ActivatedRouteSnapshot, RouterStateSnapshot } from './host/craft-router-types.js';
+import type { CraftRouteExceptionHandlerMap } from './craft-guard-runtime.js';
+import type { CraftExceptionComponentInput, CraftPendingComponentInput } from './craft-route-exceptions.js';
 /**
  * Symbol key under which `craftRoutes` stashes a route's craft-only execution
  * metadata onto the Angular `Route.data`. The
@@ -49,4 +49,3 @@ export interface CraftRouteMeta {
 }
 /** Reads the craft route meta a `craftRoutes`-built route stashes on its `data`. */
 export declare function getCraftRouteMeta(data: Record<string | symbol, unknown> | null | undefined): CraftRouteMeta | undefined;
-//# sourceMappingURL=craft-route-meta.d.ts.map

package/src/lib/craft-route-meta.js

@@ -13,4 +13,3 @@ export function getCraftRouteMeta(data) {
     }
     return data[CRAFT_ROUTE_META];
 }
-//# sourceMappingURL=craft-route-meta.js.map

package/src/lib/craft-route-target.d.ts

@@ -1,4 +1,4 @@
-import { InjectionToken } from './host/craft-compat';
+import { InjectionToken } from './host/craft-compat.js';
 /**
  * What a route mounts. Everything Craft renders is a Craft component, so the
  * kind is informational: it exists because a route target used to be able to
@@ -24,4 +24,3 @@ export declare function isCraftRouteTarget(value: unknown): value is CraftRouteT
  * component would have thrown at mount.
  */
 export declare function normalizeCraftRouteTarget(input: CraftRouteTargetInput): CraftRouteTarget;
-//# sourceMappingURL=craft-route-target.d.ts.map

package/src/lib/craft-route-target.js

@@ -1,4 +1,4 @@
-import { InjectionToken } from './host/craft-compat';
+import { InjectionToken } from './host/craft-compat.js';
 /** Route-scoped target consumed by `CraftRouterOutletController`. */
 export const CRAFT_ROUTE_TARGET = new InjectionToken('CRAFT_ROUTE_TARGET', { providedIn: 'root', factory: () => null });
 export function craftRouteTarget(component) {
@@ -19,4 +19,3 @@ export function isCraftRouteTarget(value) {
 export function normalizeCraftRouteTarget(input) {
     return isCraftRouteTarget(input) ? input : craftRouteTarget(input);
 }
-//# sourceMappingURL=craft-route-target.js.map

package/src/lib/craft-router-outlet.d.ts

@@ -1,9 +1,9 @@
-import { EnvironmentInjector, Injector, InjectionToken, type Type } from './host/craft-compat';
-import { runCraftRouteChainAsync } from './craft-guard-runtime';
-import { type CraftExceptionComponentInput } from './craft-route-exceptions';
-import { type CraftRouteTarget, type CraftRouteTargetInput } from './craft-route-target';
-import { type CraftWritableSignal } from './host/craft-signal';
-import { type CraftMatch } from './host/craft-router-runtime';
+import { EnvironmentInjector, Injector, InjectionToken, type Type } from './host/craft-compat.js';
+import { runCraftRouteChainAsync } from './craft-guard-runtime.js';
+import { type CraftExceptionComponentInput } from './craft-route-exceptions.js';
+import { type CraftRouteTarget, type CraftRouteTargetInput } from './craft-route-target.js';
+import { type CraftWritableSignal } from './host/craft-signal.js';
+import { type CraftMatch } from './host/craft-router-runtime.js';
 export declare function collectMatchProps(match: CraftMatch | null | undefined): Record<string, unknown>;
 /** @deprecated Use {@link collectMatchProps}. */
 export declare const collectActivatedRouteProps: typeof collectMatchProps;
@@ -42,6 +42,7 @@ export declare class CraftRouterOutletController {
     private readonly viewTransitionSink;
     private readonly a11yNavigationFocus;
     private readonly platform;
+    private readonly hydrationRuntime;
     private readonly document;
     private readonly ssrRuntime;
     private a11yHasCompletedInitialActivation;
@@ -102,4 +103,3 @@ export declare class CraftRouterOutletController {
 export declare function createCraftRouterOutletController(): CraftRouterOutletController;
 export declare function resolveComponentInput(input: CraftExceptionComponentInput | null | undefined): Promise<CraftRouteTargetInput | null>;
 export declare function craftOutletStateOf(outlet: CraftRouterOutletController): CraftWritableSignal<CraftOutletState>;
-//# sourceMappingURL=craft-router-outlet.d.ts.map

package/src/lib/craft-router-outlet.js

@@ -1,20 +1,21 @@
-import { DestroyRef, EnvironmentInjector, inject, Injector, InjectionToken, runInInjectionContext, } from './host/craft-compat';
-import { DOCUMENT } from './host/craft-compat';
-import { CRAFT_A11Y_NAVIGATION_FOCUS } from './craft-a11y';
-import { isCraftException } from './craft-exception';
-import { evaluateCraftGuardSync, runCraftRouteChainAsync, } from './craft-guard-runtime';
-import { CRAFT_BLANK_MS, CRAFT_ERROR_COMPONENT, CRAFT_PENDING_COMPONENT, CRAFT_PENDING_MIN_MS, CRAFT_STAY_MS, } from './craft-pending';
-import { CRAFT_GLOBAL_ERROR, } from './craft-route-exceptions';
-import { createRouteLoadError, isCraftRouteLoadError, setActiveCraftRouteLoadError, } from './craft-route-load-error';
-import { getCraftRouteMeta, } from './craft-route-meta';
-import { CRAFT_START_VIEW_TRANSITION, CRAFT_VIEW_TRANSITION, CRAFT_VIEW_TRANSITION_SKIP_BLANK, CRAFT_VIEW_TRANSITION_STATE_KEY, CRAFT_VIEW_TRANSITIONS_ENABLED, } from './craft-view-transition';
-import { CRAFT_TEMPORAL_RUNTIME, } from './temporal-runtime';
-import { craftRouteTarget, CRAFT_ROUTE_TARGET, isCraftRouteTarget, normalizeCraftRouteTarget, } from './craft-route-target';
-import { craftSignal, craftWatch, } from './host/craft-signal';
-import { serializeLocation, sliceCraftMatchForOutlet, } from './host/craft-router-runtime';
-import { CRAFT_CHILD_MATCH, CRAFT_HISTORY, CRAFT_MATCH, CRAFT_ROUTER, } from './craft-router-tokens';
-import { CRAFT_SSR_RUNTIME } from './craft-ssr';
-import { CRAFT_PLATFORM } from './craft-platform';
+import { DestroyRef, EnvironmentInjector, inject, Injector, InjectionToken, runInInjectionContext, } from './host/craft-compat.js';
+import { DOCUMENT } from './host/craft-compat.js';
+import { CRAFT_A11Y_NAVIGATION_FOCUS } from './craft-a11y.js';
+import { isCraftException } from './craft-exception.js';
+import { evaluateCraftGuardSync, runCraftRouteChainAsync, } from './craft-guard-runtime.js';
+import { CRAFT_BLANK_MS, CRAFT_ERROR_COMPONENT, CRAFT_PENDING_COMPONENT, CRAFT_PENDING_MIN_MS, CRAFT_STAY_MS, } from './craft-pending.js';
+import { CRAFT_GLOBAL_ERROR, } from './craft-route-exceptions.js';
+import { createRouteLoadError, isCraftRouteLoadError, setActiveCraftRouteLoadError, } from './craft-route-load-error.js';
+import { getCraftRouteMeta, } from './craft-route-meta.js';
+import { CRAFT_START_VIEW_TRANSITION, CRAFT_VIEW_TRANSITION, CRAFT_VIEW_TRANSITION_SKIP_BLANK, CRAFT_VIEW_TRANSITION_STATE_KEY, CRAFT_VIEW_TRANSITIONS_ENABLED, } from './craft-view-transition.js';
+import { CRAFT_TEMPORAL_RUNTIME, } from './temporal-runtime.js';
+import { craftRouteTarget, CRAFT_ROUTE_TARGET, isCraftRouteTarget, normalizeCraftRouteTarget, } from './craft-route-target.js';
+import { craftSignal, craftWatch, } from './host/craft-signal.js';
+import { serializeLocation, sliceCraftMatchForOutlet, } from './host/craft-router-runtime.js';
+import { CRAFT_CHILD_MATCH, CRAFT_HISTORY, CRAFT_MATCH, CRAFT_ROUTER, } from './craft-router-tokens.js';
+import { CRAFT_SSR_RUNTIME } from './craft-ssr.js';
+import { CRAFT_PLATFORM } from './craft-platform.js';
+import { CRAFT_HYDRATION_RUNTIME } from './craft-hydration.js';
 const ROUTE_PROP_SKIP = new Set(['craftComponent', 'craftPendingComponent']);
 export function collectMatchProps(match) {
     if (!match) {
@@ -92,6 +93,9 @@ export class CraftRouterOutletController {
     viewTransitionSink = inject(CRAFT_VIEW_TRANSITION);
     a11yNavigationFocus = inject(CRAFT_A11Y_NAVIGATION_FOCUS);
     platform = inject(CRAFT_PLATFORM, { optional: true });
+    hydrationRuntime = inject(CRAFT_HYDRATION_RUNTIME, {
+        optional: true,
+    });
     document = this.platform?.document ?? inject(DOCUMENT);
     ssrRuntime = inject(CRAFT_SSR_RUNTIME, { optional: true });
     a11yHasCompletedInitialActivation = false;
@@ -213,6 +217,9 @@ export class CraftRouterOutletController {
         if (this.ssrRuntime) {
             this.ssrRuntime.track(`route:${activated.route.path}`, activation);
         }
+        else if (this.platform?.hydrating && this.hydrationRuntime) {
+            this.hydrationRuntime.track(`route:${activated.route.path}`, activation);
+        }
         else {
             void activation;
         }
@@ -732,4 +739,3 @@ function matchToSnapshot(match) {
         component: match.route.component,
     };
 }
-//# sourceMappingURL=craft-router-outlet.js.map

package/src/lib/craft-router-tokens.d.ts

@@ -1,6 +1,6 @@
-import { InjectionToken } from './host/craft-compat';
-import type { CraftCompiledRoute, CraftHistory, CraftLocation, CraftMatch } from './host/craft-router-runtime';
-import type { CraftSignal, CraftWritableSignal } from './host/craft-signal';
+import { InjectionToken } from './host/craft-compat.js';
+import type { CraftCompiledRoute, CraftHistory, CraftLocation, CraftMatch } from './host/craft-router-runtime.js';
+import type { CraftSignal, CraftWritableSignal } from './host/craft-signal.js';
 export type CraftUrlTree = {
     readonly __craftUrlTree: true;
     toString(): string;
@@ -46,4 +46,3 @@ export declare const CRAFT_MATCH: InjectionToken<CraftSignal<CraftMatch | null>>
 export declare const CRAFT_CHILD_MATCH: InjectionToken<CraftSignal<CraftMatch | null>>;
 export declare const CRAFT_COMPILED_ROUTES: InjectionToken<readonly CraftCompiledRoute[]>;
 export declare const CRAFT_ROUTER: InjectionToken<CraftRouterNavigationApi>;
-//# sourceMappingURL=craft-router-tokens.d.ts.map

package/src/lib/craft-router-tokens.js

@@ -1,5 +1,5 @@
-import { InjectionToken } from './host/craft-compat';
-import { craftToken, ɵregisterCraftTokenHostToken } from './host/craft-injector';
+import { InjectionToken } from './host/craft-compat.js';
+import { craftToken, ɵregisterCraftTokenHostToken } from './host/craft-injector.js';
 function angularCraftToken(debugName) {
     const native = craftToken(debugName);
     const host = new InjectionToken(debugName);
@@ -12,4 +12,3 @@ export const CRAFT_MATCH = angularCraftToken('CRAFT_MATCH');
 export const CRAFT_CHILD_MATCH = angularCraftToken('CRAFT_CHILD_MATCH');
 export const CRAFT_COMPILED_ROUTES = angularCraftToken('CRAFT_COMPILED_ROUTES');
 export const CRAFT_ROUTER = angularCraftToken('CRAFT_ROUTER');
-//# sourceMappingURL=craft-router-tokens.js.map

package/src/lib/craft-router-trace.d.ts

@@ -1,6 +1,6 @@
-import { InjectionToken, Injector, type EnvironmentProviders, type Provider } from './host/craft-compat';
-import type { CraftRoutePhase } from './craft-route-exceptions';
-import { type CraftRouterEvent } from './craft-router-tokens';
+import { InjectionToken, Injector, type EnvironmentProviders, type Provider } from './host/craft-compat.js';
+import type { CraftRoutePhase } from './craft-route-exceptions.js';
+import { type CraftRouterEvent } from './craft-router-tokens.js';
 export type CraftRouterTraceStage = 'match' | 'guard' | 'resolve' | 'exceptionHandler';
 export type CraftRouterTraceContext = Readonly<{
     kind: 'routerEvent' | 'routeChain' | 'routeStage';
@@ -15,4 +15,3 @@ export type CraftRouterTraceWrapper = (context: CraftRouterTraceContext, next: (
 export declare const CRAFT_ROUTER_TRACE: InjectionToken<readonly CraftRouterTraceWrapper[]>;
 export declare function provideCraftRouterTrace(wrapper: CraftRouterTraceWrapper): (Provider | EnvironmentProviders)[];
 export declare function executeCraftRouterTrace<Value>(injector: Injector, context: CraftRouterTraceContext, next: () => Value): Value;
-//# sourceMappingURL=craft-router-trace.d.ts.map

package/src/lib/craft-router-trace.js

@@ -1,5 +1,6 @@
-import { inject, InjectionToken, Injector, provideAppInitializer, runInInjectionContext, } from './host/craft-compat';
-import { CRAFT_ROUTER, } from './craft-router-tokens';
+import { inject, InjectionToken, Injector, provideAppInitializer, runInInjectionContext, } from './host/craft-compat.js';
+import { isCraftDevelopment } from './craft-runtime-mode.js';
+import { CRAFT_ROUTER } from './craft-router-tokens.js';
 export const CRAFT_ROUTER_TRACE = new InjectionToken('CRAFT_ROUTER_TRACE', {
     providedIn: 'root',
     factory: () => [],
@@ -19,6 +20,9 @@ export function provideCraftRouterTrace(wrapper) {
         },
         provideAppInitializer(() => {
             const injector = inject(Injector);
+            if (!isCraftDevelopment(injector)) {
+                return;
+            }
             const router = inject(CRAFT_ROUTER, { optional: true });
             const events = router ? craftRouterEvents(router) : undefined;
             if (!events || routerTraceListeners.has(injector)) {
@@ -38,6 +42,9 @@ export function provideCraftRouterTrace(wrapper) {
     ];
 }
 export function executeCraftRouterTrace(injector, context, next) {
+    if (!isCraftDevelopment(injector)) {
+        return next();
+    }
     const wrappers = injector.get(CRAFT_ROUTER_TRACE, []);
     if (wrappers.length === 0) {
         return next();
@@ -51,4 +58,3 @@ export function executeCraftRouterTrace(injector, context, next) {
     };
     return runInInjectionContext(injector, () => run(0));
 }
-//# sourceMappingURL=craft-router-trace.js.map

package/src/lib/craft-router.d.ts

@@ -1,13 +1,14 @@
-import { type EnvironmentProviders, type Provider } from './host/craft-compat';
-import type { GetDeps } from './branded-component/branded-component';
-import { type CraftLoadingFeature } from './craft-pending';
-import { type GetServiceYields, type SERVICE_HELPER_DEPENDENCIES, type ServiceTrackingMetadata } from './craft-service';
-import type { Simplify } from './craft-service.shared';
-import { type CraftViewTransitionInput, type ViewTransitionPayloadDef } from './craft-view-transition';
-import { type CraftCompiledRoute } from './host/craft-router-runtime';
-import { type CraftNavigation, type CraftNavigationExtras, type CraftRouterEvent, type CraftUrlTree } from './craft-router-tokens';
-export { createBrowserHistory, createMemoryHistory, matchCraftRoutes, matchCraftRoutesAsync, type CraftCompiledRoute, type CraftHistory, type CraftLocation, type CraftMatch, } from './host/craft-router-runtime';
-export { CRAFT_COMPILED_ROUTES, CRAFT_HISTORY, CRAFT_LOCATION, CRAFT_MATCH, CRAFT_ROUTER, type CraftNavigationExtras, type CraftRouterNavigationApi, type CraftUrlTree, } from './craft-router-tokens';
+import { type EnvironmentProviders, type Provider } from './host/craft-compat.js';
+import type { GetDeps } from './branded-component/branded-component.js';
+import { type CraftLoadingFeature } from './craft-pending.js';
+import { type GetServiceYields, type SERVICE_HELPER_DEPENDENCIES, type ServiceTrackingMetadata } from './craft-service.js';
+import type { Simplify } from './craft-service.shared.js';
+import { type CraftViewTransitionInput, type ViewTransitionPayloadDef } from './craft-view-transition.js';
+import { type CraftNodeDirective } from './craft-node-directive.js';
+import { type CraftCompiledRoute } from './host/craft-router-runtime.js';
+import { type CraftNavigation, type CraftNavigationExtras, type CraftRouterEvent, type CraftUrlTree } from './craft-router-tokens.js';
+export { createBrowserHistory, createMemoryHistory, matchCraftRoutes, matchCraftRoutesAsync, type CraftCompiledRoute, type CraftHistory, type CraftLocation, type CraftMatch, } from './host/craft-router-runtime.js';
+export { CRAFT_COMPILED_ROUTES, CRAFT_HISTORY, CRAFT_LOCATION, CRAFT_MATCH, CRAFT_ROUTER, type CraftNavigationExtras, type CraftRouterNavigationApi, type CraftUrlTree, } from './craft-router-tokens.js';
 export interface CraftRouterRoutesRegistry {
 }
 type CraftRouterRoutesRegistryKey = Extract<keyof CraftRouterRoutesRegistry, string>;
@@ -225,16 +226,15 @@ export declare function provideCraftRouter(routes: readonly CraftCompiledRoute[]
  * runner that mocks every endpoint a route can reach).
  */
 export declare const CraftRouter: CraftRouterHelper;
-type CraftRouterLinkProps = {
-    readonly craftRouterLink: CraftRouterLinkInput | null | undefined;
-};
+type CraftRouterLinkValue = CraftRouterLinkInput | null | undefined;
+type CraftRouterLinkBinding = CraftRouterLinkValue | (() => CraftRouterLinkValue | Generator<unknown, CraftRouterLinkValue, unknown>);
 /**
- * Functional Craft directive for type-safe router links.
+ * Creates a functional Craft directive for type-safe router links.
  *
  * @example
- * a({ craftRouterLink: { to: 'tasks' } }, 'Tasks').pipe(CraftRouterLink)
+ * a({}, 'Tasks').pipe(CraftRouterLink({ to: 'tasks' }))
  */
-export declare const CraftRouterLink: import("./craft-node-directive").CraftNodeDirective<CraftRouterLinkProps>;
+export declare function CraftRouterLink(link: CraftRouterLinkBinding): CraftNodeDirective<Readonly<Record<never, never>>>;
 export declare function shouldHandleCraftRouterLinkClick(event: MouseEvent, element: Element): boolean;
 export declare function createCraftRouterCommands(input: CraftRouterInputWithOptionalQueryParams): readonly unknown[];
 /** @deprecated Moved to `@craft-ts/angular`. */
@@ -245,4 +245,3 @@ export type GenDeps_LegacyCraftRouterLink = GetDeps<{
 }>;
 /** @deprecated DI metadata belongs to `LegacyCraftRouterLink` only. */
 export type GenDeps_CraftRouterLink = GenDeps_LegacyCraftRouterLink;
-//# sourceMappingURL=craft-router.d.ts.map

package/src/lib/craft-router.js

@@ -1,18 +1,18 @@
-import { DestroyRef, EnvironmentInjector, Injector, inject, getCraftRootDefaultProviders, } from './host/craft-compat';
-import { isCraftLoadingFeature, provideCraftLoading, } from './craft-pending';
-import { CRAFT_TITLE_STRATEGY, createCraftTitleStrategy, } from './craft-a11y';
-import { ActivatedRoute, } from './host/craft-router-types';
-import { ɵtoCraftService as toCraftService, } from './craft-service';
-import { CRAFT_VIEW_TRANSITION_STATE_KEY, } from './craft-view-transition';
-import { CRAFT_NODE_EFFECT_FACTORY, craftNodeDirective, } from './craft-node-directive';
-import { executeYieldable } from './yieldable';
-import { executeGeneratorCompatibleFactoryAsync } from './craft-program-runtime';
-import { buildPathFromTemplate, createBrowserHistory, createUrlFromParts, findUnresolvedLoadChildrenRoute, matchCraftRoutes, matchCraftRoutesAsync, parseSearchParams, serializeLocation, splitPath, } from './host/craft-router-runtime';
-import { craftSignal, craftWatch, } from './host/craft-signal';
-import { CRAFT_COMPILED_ROUTES, CRAFT_HISTORY, CRAFT_LOCATION, CRAFT_MATCH, CRAFT_ROUTER, } from './craft-router-tokens';
-import { CRAFT_PLATFORM } from './craft-platform';
-export { createBrowserHistory, createMemoryHistory, matchCraftRoutes, matchCraftRoutesAsync, } from './host/craft-router-runtime';
-export { CRAFT_COMPILED_ROUTES, CRAFT_HISTORY, CRAFT_LOCATION, CRAFT_MATCH, CRAFT_ROUTER, } from './craft-router-tokens';
+import { DestroyRef, EnvironmentInjector, Injector, inject, getCraftRootDefaultProviders, } from './host/craft-compat.js';
+import { isCraftLoadingFeature, provideCraftLoading, } from './craft-pending.js';
+import { CRAFT_TITLE_STRATEGY, createCraftTitleStrategy, } from './craft-a11y.js';
+import { ActivatedRoute, } from './host/craft-router-types.js';
+import { ɵtoCraftService as toCraftService, } from './craft-service.js';
+import { CRAFT_VIEW_TRANSITION_STATE_KEY, } from './craft-view-transition.js';
+import { CRAFT_NODE_EFFECT_FACTORY, craftNodeDirective, } from './craft-node-directive.js';
+import { executeYieldable } from './yieldable.js';
+import { executeGeneratorCompatibleFactoryAsync } from './craft-program-runtime.js';
+import { buildPathFromTemplate, createBrowserHistory, createUrlFromParts, findUnresolvedLoadChildrenRoute, matchCraftRoutes, matchCraftRoutesAsync, parseSearchParams, serializeLocation, splitPath, } from './host/craft-router-runtime.js';
+import { craftSignal, craftWatch, } from './host/craft-signal.js';
+import { CRAFT_COMPILED_ROUTES, CRAFT_HISTORY, CRAFT_LOCATION, CRAFT_MATCH, CRAFT_ROUTER, } from './craft-router-tokens.js';
+import { CRAFT_PLATFORM } from './craft-platform.js';
+export { createBrowserHistory, createMemoryHistory, matchCraftRoutes, matchCraftRoutesAsync, } from './host/craft-router-runtime.js';
+export { CRAFT_COMPILED_ROUTES, CRAFT_HISTORY, CRAFT_LOCATION, CRAFT_MATCH, CRAFT_ROUTER, } from './craft-router-tokens.js';
 // The `toCraftService` return type references internal Angular symbols
 // (`SIGNAL`, `[iterator]`, `[unscopables]`) that ng-packagr cannot serialize to
 // `.d.ts` (TS4023/TS4118). Cast through `unknown` and re-shape the destructured
@@ -106,69 +106,71 @@ export function provideCraftRouter(routes, ...features) {
  */
 export const CraftRouter = CraftRouterInternal;
 /**
- * Functional Craft directive for type-safe router links.
+ * Creates a functional Craft directive for type-safe router links.
  *
  * @example
- * a({ craftRouterLink: { to: 'tasks' } }, 'Tasks').pipe(CraftRouterLink)
+ * a({}, 'Tasks').pipe(CraftRouterLink({ to: 'tasks' }))
  */
-export const CraftRouterLink = craftNodeDirective('CraftRouterLink', ['craftRouterLink'], (context) => {
-    const router = context.injector.get(CRAFT_ROUTER);
-    let currentInput;
-    let currentUrlTree;
-    const syncAriaCurrent = () => {
-        if (!currentUrlTree) {
-            context.renderer.removeAttribute(context.element, 'aria-current');
-            return;
-        }
-        const active = router.isActive(currentUrlTree, {
-            paths: 'exact',
-            queryParams: 'ignored',
-            fragment: 'ignored',
-            matrixParams: 'ignored',
-        });
-        if (active) {
-            context.renderer.setAttribute(context.element, 'aria-current', 'page');
-        }
-        else {
-            context.renderer.removeAttribute(context.element, 'aria-current');
-        }
-    };
-    const hrefEffect = context.injector.get(CRAFT_NODE_EFFECT_FACTORY)('router-link-href', () => {
-        const candidate = context.props.craftRouterLink;
-        currentInput =
-            typeof candidate === 'function'
-                ? executeYieldable(candidate, [], context.injector)
-                : candidate;
-        if (!currentInput) {
-            currentUrlTree = undefined;
-            context.renderer.removeAttribute(context.element, 'href');
-            syncAriaCurrent();
-            return;
-        }
-        currentUrlTree = router.createUrlTree(currentInput);
-        context.renderer.setAttribute(context.element, 'href', router.serializeUrl(currentUrlTree));
-        syncAriaCurrent();
-    });
-    const navigation = router.events.subscribe((event) => {
-        if (event.type === 'NavigationEnd')
+export function CraftRouterLink(link) {
+    return craftNodeDirective('CraftRouterLink', [], (context) => {
+        const router = context.injector.get(CRAFT_ROUTER);
+        let currentInput;
+        let currentUrlTree;
+        const syncAriaCurrent = () => {
+            if (!currentUrlTree) {
+                context.renderer.removeAttribute(context.element, 'aria-current');
+                return;
+            }
+            const active = router.isActive(currentUrlTree, {
+                paths: 'exact',
+                queryParams: 'ignored',
+                fragment: 'ignored',
+                matrixParams: 'ignored',
+            });
+            if (active) {
+                context.renderer.setAttribute(context.element, 'aria-current', 'page');
+            }
+            else {
+                context.renderer.removeAttribute(context.element, 'aria-current');
+            }
+        };
+        const hrefEffect = context.injector.get(CRAFT_NODE_EFFECT_FACTORY)('router-link-href', () => {
+            const candidate = link;
+            currentInput =
+                typeof candidate === 'function'
+                    ? executeYieldable(candidate, [], context.injector)
+                    : candidate;
+            if (!currentInput) {
+                currentUrlTree = undefined;
+                context.renderer.removeAttribute(context.element, 'href');
+                syncAriaCurrent();
+                return;
+            }
+            currentUrlTree = router.createUrlTree(currentInput);
+            context.renderer.setAttribute(context.element, 'href', router.serializeUrl(currentUrlTree));
             syncAriaCurrent();
+        });
+        const navigation = router.events.subscribe((event) => {
+            if (event.type === 'NavigationEnd')
+                syncAriaCurrent();
+        });
+        const removeClickListener = context.renderer.listen(context.element, 'click', (event) => {
+            const mouseEvent = event;
+            if (!currentInput ||
+                !currentUrlTree ||
+                !shouldHandleCraftRouterLinkClick(mouseEvent, context.element)) {
+                return;
+            }
+            mouseEvent.preventDefault();
+            void router.navigateByUrl(currentUrlTree, getNavigationBehaviorOptions(currentInput));
+        });
+        return () => {
+            removeClickListener();
+            navigation.unsubscribe();
+            hrefEffect.destroy();
+        };
     });
-    const removeClickListener = context.renderer.listen(context.element, 'click', (event) => {
-        const mouseEvent = event;
-        if (!currentInput ||
-            !currentUrlTree ||
-            !shouldHandleCraftRouterLinkClick(mouseEvent, context.element)) {
-            return;
-        }
-        mouseEvent.preventDefault();
-        void router.navigateByUrl(currentUrlTree, getNavigationBehaviorOptions(currentInput));
-    });
-    return () => {
-        removeClickListener();
-        navigation.unsubscribe();
-        hrefEffect.destroy();
-    };
-});
+}
 export function shouldHandleCraftRouterLinkClick(event, element) {
     if (event.defaultPrevented ||
         event.button !== 0 ||
@@ -556,4 +558,3 @@ function withViewTransitionState(input, state) {
         [CRAFT_VIEW_TRANSITION_STATE_KEY]: input.viewTransition,
     };
 }
-//# sourceMappingURL=craft-router.js.map

package/src/lib/craft-routes.d.ts

@@ -1,18 +1,24 @@
-import { type Signal } from './host/craft-compat';
+import { type Signal } from './host/craft-compat.js';
 import { type Observable } from 'rxjs';
-import type { ActivatedRouteSnapshot, Data, GuardResult, PartialMatchRouteSnapshot, Route, RouterStateSnapshot, UrlSegment } from './host/craft-router-types';
-import type { CRAFT_COMPONENT_DEPS, ComponentExceptionsCarrier, ComponentDepsOf, ExtractDeps } from './branded-component/branded-component';
-import { type AnyCraftException } from './craft-exception';
-import type { CraftHttpRequest } from './craft-http-client';
-import type { ViewTransitionPayloadDef } from './craft-view-transition';
-import type { CraftExceptionComponentInput, CraftPendingComponentInput, CraftExceptionHandler, RouteExceptionUnion } from './craft-route-exceptions';
-import type { SERVICE_HELPER_DEPENDENCIES, BrandedServiceProvider, NamedBrandedServiceProvider, CraftServiceApi, GetServiceDependencies, ServiceDependencyMapFromYielded, ServiceTrackingMetadata, ServiceYieldRequest } from './craft-service';
-import { CRAFT_SERVICE_PROVIDER_BRAND, type MergeObjectUnion, type Simplify } from './craft-service.shared';
-import { type CraftRouteLazyLoadHelpers } from './craft-route-load-error';
-import type { CraftCompiledRoute } from './host/craft-router-runtime';
-import { type CraftUrlTree } from './craft-router-tokens';
-import { type CraftSsrPolicy } from './craft-ssr';
+import type { ActivatedRouteSnapshot, Data, GuardResult, PartialMatchRouteSnapshot, Route, RouterStateSnapshot, UrlSegment } from './host/craft-router-types.js';
+import type { CRAFT_COMPONENT_DEPS, ComponentExceptionsCarrier, ComponentDepsOf, ExtractDeps } from './branded-component/branded-component.js';
+import { type AnyCraftException } from './craft-exception.js';
+import type { CraftHttpRequest } from './craft-http-client.js';
+import type { ViewTransitionPayloadDef } from './craft-view-transition.js';
+import type { CraftExceptionComponentInput, CraftPendingComponentInput, CraftExceptionHandler, RouteExceptionUnion } from './craft-route-exceptions.js';
+import type { SERVICE_HELPER_DEPENDENCIES, BrandedServiceProvider, NamedBrandedServiceProvider, CraftServiceApi, GetServiceDependencies, ServiceDependencyMapFromYielded, ServiceTrackingMetadata, ServiceYieldRequest } from './craft-service.js';
+import { CRAFT_SERVICE_PROVIDER_BRAND, type MergeObjectUnion, type Simplify } from './craft-service.shared.js';
+import { type CraftRouteLazyLoadHelpers } from './craft-route-load-error.js';
+import type { CraftCompiledRoute } from './host/craft-router-runtime.js';
+import { type CraftUrlTree } from './craft-router-tokens.js';
+import { type CraftSsrPolicy } from './craft-ssr.js';
 type MaybeAsync<T> = T | Promise<T> | Observable<T>;
+/** Type-only carrier for providers passed to loadCraftComponent(...). */
+export declare const CRAFT_ROUTE_ADDITIONAL_PROVIDERS: unique symbol;
+export type CraftRouteAdditionalProvidersCarrier<Providers> = {
+    readonly [CRAFT_ROUTE_ADDITIONAL_PROVIDERS]?: Providers;
+};
+export type CraftRouteAdditionalProvidersOf<Route> = Route extends CraftRouteAdditionalProvidersCarrier<infer Providers> ? Providers : never;
 type AngularRouteBase = Omit<Route, 'canActivate' | 'canMatch' | 'children' | 'component' | 'data' | 'loadChildren' | 'loadComponent' | 'path' | 'providers' | 'redirectTo'>;
 type AngularRouteProviders = NonNullable<Route['providers']>;
 type AngularRouteComponent = NonNullable<Route['component']>;
@@ -349,7 +355,7 @@ type CraftRouteLoaderHelperConstraint = {
 type ExceptionCode<Exception> = Exception extends {
     _tag: infer Code extends string;
 } ? Code : never;
-type ExceptionHandlerResults<Codes extends string> = Record<Codes, Generator<any, import('./craft-route-exceptions').CraftExceptionOutcome, unknown>>;
+type ExceptionHandlerResults<Codes extends string> = Record<Codes, Generator<any, import('./craft-route-exceptions.js').CraftExceptionOutcome, unknown>>;
 type TypedExceptionHandlers<Exception extends AnyCraftException, Codes extends ExceptionCode<Exception>, Results extends ExceptionHandlerResults<Codes>> = {
     [Code in Codes]: CraftExceptionHandler<Extract<Exception, {
         _tag: Code;
@@ -752,4 +758,3 @@ export declare function craftRoutes<const Name extends string, const Routes exte
     [Index in keyof Routes]: Routes[Index];
 }): CraftRoutesResult<Routes, Name>;
 export {};
-//# sourceMappingURL=craft-routes.d.ts.map

package/src/lib/craft-routes.js

@@ -1,15 +1,17 @@
-import { inject, Injector, isSignal, runInInjectionContext, signal, } from './host/craft-compat';
-import { toObservable } from './host/craft-compat';
+import { inject, Injector, isSignal, runInInjectionContext, signal, } from './host/craft-compat.js';
+import { toObservable } from './host/craft-compat.js';
 import { filter, firstValueFrom, isObservable, take, } from 'rxjs';
-import { GUARD_AWAIT_REQUEST_MARKER, isGenerator, runCraftGenerator, } from './craft-generator-runtime';
-import { CRAFT_ROUTE_META, } from './craft-route-meta';
-import { CRAFT_VIEW_TRANSITION } from './craft-view-transition';
-import { craftService, getServiceMetaData } from './craft-service';
-import { provideHostName } from './host-tag';
-import { loadRouteWithRetry, } from './craft-route-load-error';
-import { CRAFT_MATCH } from './craft-router-tokens';
-import { craftComputed } from './host/craft-signal';
-import { CRAFT_SSR_POLICY } from './craft-ssr';
+import { GUARD_AWAIT_REQUEST_MARKER, isGenerator, runCraftGenerator, } from './craft-generator-runtime.js';
+import { CRAFT_ROUTE_META, } from './craft-route-meta.js';
+import { CRAFT_VIEW_TRANSITION } from './craft-view-transition.js';
+import { craftService, getServiceMetaData } from './craft-service.js';
+import { provideHostName } from './host-tag.js';
+import { loadRouteWithRetry, } from './craft-route-load-error.js';
+import { CRAFT_MATCH } from './craft-router-tokens.js';
+import { craftComputed } from './host/craft-signal.js';
+import { CRAFT_SSR_POLICY } from './craft-ssr.js';
+/** Type-only carrier for providers passed to loadCraftComponent(...). */
+export const CRAFT_ROUTE_ADDITIONAL_PROVIDERS = Symbol('CRAFT_ROUTE_ADDITIONAL_PROVIDERS');
 /**
  * Asserts (at compile time, in the **parent** collection's file) that every
  * `loadChildren` route mounting a `.withParent`-pinned child uses the path the
@@ -507,4 +509,3 @@ export function craftRoutes(routeCollectionName, routes) {
         return helpers;
     }
 }
-//# sourceMappingURL=craft-routes.js.map

package/src/lib/craft-runtime-mode.d.ts

@@ -0,0 +1,13 @@
+import { InjectionToken, type Injector, type Provider } from './host/craft-compat.js';
+/** Runtime mode used to gate optional diagnostics and development tooling. */
+export type CraftRuntimeMode = 'development' | 'production';
+/**
+ * Directly-created injectors remain development-compatible. Application
+ * entry points explicitly select their mode when they bootstrap.
+ */
+export declare const CRAFT_RUNTIME_MODE: InjectionToken<CraftRuntimeMode>;
+export declare function provideCraftRuntimeMode(mode: CraftRuntimeMode): Provider;
+export declare function provideCraftDevelopment(): Provider;
+export declare function provideCraftProduction(): Provider;
+export declare function craftRuntimeMode(injector: Injector): CraftRuntimeMode;
+export declare function isCraftDevelopment(injector: Injector): boolean;

package/src/lib/craft-runtime-mode.js

@@ -0,0 +1,21 @@
+import { InjectionToken, } from './host/craft-compat.js';
+/**
+ * Directly-created injectors remain development-compatible. Application
+ * entry points explicitly select their mode when they bootstrap.
+ */
+export const CRAFT_RUNTIME_MODE = new InjectionToken('CRAFT_RUNTIME_MODE', { providedIn: 'root', factory: () => 'development' });
+export function provideCraftRuntimeMode(mode) {
+    return { provide: CRAFT_RUNTIME_MODE, useValue: mode };
+}
+export function provideCraftDevelopment() {
+    return provideCraftRuntimeMode('development');
+}
+export function provideCraftProduction() {
+    return provideCraftRuntimeMode('production');
+}
+export function craftRuntimeMode(injector) {
+    return injector.get(CRAFT_RUNTIME_MODE, 'development');
+}
+export function isCraftDevelopment(injector) {
+    return craftRuntimeMode(injector) === 'development';
+}