@askrjs/askr 0.0.47 → 0.0.49

package/dist/router/internal-types.d.ts

@@ -0,0 +1,31 @@
+import { RenderableChild } from "../common/vnode.js";
+import { LayoutScopeRecord, PageScopeRecord, Route, RouteHandler, RoutePolicy, RouteRecord } from "../common/router.js";
+
+//#region src/router/internal-types.d.ts
+type AnyRouteComponent = (...args: any[]) => RenderableChild;
+type InternalRoute = Route & {
+  fallbackPrefix?: string;
+};
+type InternalRouteRecord = RouteRecord & {
+  fallbackPrefix?: string;
+  renderHandler?: RouteHandler;
+};
+type AccessScopeState = {
+  guestOnly: boolean;
+  authenticated: boolean;
+};
+type RegistrationScope = {
+  kind: 'group' | 'page';
+  pathPrefix: string;
+  layout?: LayoutScopeRecord['component'];
+  page?: PageScopeRecord['component'];
+  hasIndex?: boolean;
+  policies: readonly RoutePolicy[];
+  state: AccessScopeState;
+};
+type RegistrationSession = {
+  authConfigured: boolean;
+};
+//#endregion
+export { AccessScopeState, AnyRouteComponent, InternalRoute, InternalRouteRecord, RegistrationScope, RegistrationSession };
+//# sourceMappingURL=internal-types.d.ts.map

package/dist/router/internal-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-types.d.ts","names":[],"sources":["../../src/router/internal-types.ts"],"mappings":";;;;KAUY,iBAAA,OAAwB,IAAA,YAAgB,eAAe;AAAA,KAEvD,aAAA,GAAgB,KAAK;EAC/B,cAAc;AAAA;AAAA,KAGJ,mBAAA,GAAsB,WAAA;EAChC,cAAA;EACA,aAAA,GAAgB,YAAY;AAAA;AAAA,KAGlB,gBAAA;EACV,SAAA;EACA,aAAa;AAAA;AAAA,KAGH,iBAAA;EACV,IAAA;EACA,UAAA;EACA,MAAA,GAAS,iBAAA;EACT,IAAA,GAAO,eAAA;EACP,QAAA;EACA,QAAA,WAAmB,WAAA;EACnB,KAAA,EAAO,gBAAA;AAAA;AAAA,KAGG,mBAAA;EACV,cAAc;AAAA"}

package/dist/router/lazy.d.ts

@@ -0,0 +1,19 @@
+import { RouteManifest, RouteRegistry } from "../common/router.js";
+import { AnyRouteComponent } from "./internal-types.js";
+
+//#region src/router/lazy.d.ts
+declare function lazy<TComponent extends AnyRouteComponent>(factory: () => Promise<{
+  default: TComponent;
+} | TComponent>): TComponent;
+declare function _snapshotLazy(): Promise<unknown>[];
+declare function _snapshotRouteSourceLazy(source: {
+  registry?: RouteRegistry;
+  manifest?: RouteManifest;
+}): Promise<unknown>[];
+declare function _drainLazy(additionalPending?: Iterable<Promise<unknown>>): Promise<void>;
+declare function associateRouteSourceLazy(registry: RouteRegistry, manifest: RouteManifest, lazyImports: Promise<unknown>[]): void;
+declare function clearPendingLazy(): void;
+declare function restorePendingLazy(lazyImports: readonly Promise<unknown>[]): void;
+//#endregion
+export { lazy };
+//# sourceMappingURL=lazy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","names":[],"sources":["../../src/router/lazy.ts"],"mappings":";;;;iBAYgB,IAAA,oBAAwB,iBAAA,EACtC,OAAA,QAAe,OAAA;EAAU,OAAA,EAAS,UAAA;AAAA,IAAe,UAAA,IAChD,UAAA;AAAA,iBA+Ba,aAAA,IAAiB,OAAO;AAAA,iBAIxB,wBAAA,CAAyB,MAAA;EACvC,QAAA,GAAW,aAAA;EACX,QAAA,GAAW,aAAA;AAAA,IACT,OAAA;AAAA,iBAmBY,UAAA,CACd,iBAAA,GAAmB,QAAA,CAAS,OAAA,aAC3B,OAAA;AAAA,iBASa,wBAAA,CACd,QAAA,EAAU,aAAA,EACV,QAAA,EAAU,aAAA,EACV,WAAA,EAAa,OAAA;AAAA,iBAUC,gBAAA;AAAA,iBAIA,kBAAA,CAAmB,WAAwC,WAAlB,OAAO"}

package/dist/router/lazy.js

@@ -0,0 +1,52 @@
+//#region src/router/lazy.ts
+const pendingLazy = /* @__PURE__ */ new Set();
+const registryLazyImports = /* @__PURE__ */ new WeakMap();
+const manifestLazyImports = /* @__PURE__ */ new WeakMap();
+function lazy(factory) {
+	let resolved = null;
+	let loadError = null;
+	const promise = factory().then((mod) => {
+		resolved = typeof mod === "function" ? mod : mod.default;
+		pendingLazy.delete(promise);
+	}, (err) => {
+		loadError = err;
+		pendingLazy.delete(promise);
+	});
+	pendingLazy.add(promise);
+	return ((params) => {
+		if (loadError) throw loadError;
+		if (!resolved) throw new Error("lazy() component used before it was resolved. Await createSPA() / hydrateSPA() to ensure all chunks load first.");
+		return resolved(params);
+	});
+}
+function _snapshotLazy() {
+	return [...pendingLazy];
+}
+function _snapshotRouteSourceLazy(source) {
+	const imports = /* @__PURE__ */ new Set();
+	if (source.registry) for (const lazyImport of registryLazyImports.get(source.registry) ?? []) imports.add(lazyImport);
+	const manifest = source.manifest ?? source.registry?.manifest;
+	if (manifest) for (const lazyImport of manifestLazyImports.get(manifest) ?? []) imports.add(lazyImport);
+	return [...imports];
+}
+function _drainLazy(additionalPending = []) {
+	const combined = /* @__PURE__ */ new Set([...additionalPending, ...pendingLazy]);
+	if (combined.size === 0) return Promise.resolve();
+	return Promise.allSettled(combined).then(() => void 0);
+}
+function associateRouteSourceLazy(registry, manifest, lazyImports) {
+	if (lazyImports.length === 0) return;
+	registryLazyImports.set(registry, lazyImports);
+	manifestLazyImports.set(manifest, lazyImports);
+}
+function clearPendingLazy() {
+	pendingLazy.clear();
+}
+function restorePendingLazy(lazyImports) {
+	pendingLazy.clear();
+	for (const lazyImport of lazyImports) pendingLazy.add(lazyImport);
+}
+//#endregion
+export { _drainLazy, _snapshotLazy, _snapshotRouteSourceLazy, associateRouteSourceLazy, clearPendingLazy, lazy, restorePendingLazy };
+
+//# sourceMappingURL=lazy.js.map

package/dist/router/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","names":[],"sources":["../../src/router/lazy.ts"],"sourcesContent":["import type {\n  RouteManifest,\n  RouteParams,\n  RouteRegistry,\n  RouteComponent,\n} from '../common/router';\nimport type { AnyRouteComponent } from './internal-types';\n\nconst pendingLazy = new Set<Promise<unknown>>();\nconst registryLazyImports = new WeakMap<RouteRegistry, Promise<unknown>[]>();\nconst manifestLazyImports = new WeakMap<RouteManifest, Promise<unknown>[]>();\n\nexport function lazy<TComponent extends AnyRouteComponent>(\n  factory: () => Promise<{ default: TComponent } | TComponent>\n): TComponent {\n  let resolved: TComponent | null = null;\n  let loadError: unknown = null;\n\n  const promise = factory().then(\n    (mod) => {\n      resolved =\n        typeof mod === 'function'\n          ? mod\n          : (mod as { default: TComponent }).default;\n      pendingLazy.delete(promise);\n    },\n    (err: unknown) => {\n      loadError = err;\n      pendingLazy.delete(promise);\n    }\n  );\n  pendingLazy.add(promise);\n\n  return ((params: RouteParams) => {\n    if (loadError) throw loadError as Error;\n    if (!resolved) {\n      throw new Error(\n        'lazy() component used before it was resolved. ' +\n          'Await createSPA() / hydrateSPA() to ensure all chunks load first.'\n      );\n    }\n    return (resolved as RouteComponent<RouteParams>)(params);\n  }) as TComponent;\n}\n\nexport function _snapshotLazy(): Promise<unknown>[] {\n  return [...pendingLazy];\n}\n\nexport function _snapshotRouteSourceLazy(source: {\n  registry?: RouteRegistry;\n  manifest?: RouteManifest;\n}): Promise<unknown>[] {\n  const imports = new Set<Promise<unknown>>();\n\n  if (source.registry) {\n    for (const lazyImport of registryLazyImports.get(source.registry) ?? []) {\n      imports.add(lazyImport);\n    }\n  }\n\n  const manifest = source.manifest ?? source.registry?.manifest;\n  if (manifest) {\n    for (const lazyImport of manifestLazyImports.get(manifest) ?? []) {\n      imports.add(lazyImport);\n    }\n  }\n\n  return [...imports];\n}\n\nexport function _drainLazy(\n  additionalPending: Iterable<Promise<unknown>> = []\n): Promise<void> {\n  const combined = new Set<Promise<unknown>>([\n    ...additionalPending,\n    ...pendingLazy,\n  ]);\n  if (combined.size === 0) return Promise.resolve();\n  return Promise.allSettled(combined).then(() => undefined);\n}\n\nexport function associateRouteSourceLazy(\n  registry: RouteRegistry,\n  manifest: RouteManifest,\n  lazyImports: Promise<unknown>[]\n): void {\n  if (lazyImports.length === 0) {\n    return;\n  }\n\n  registryLazyImports.set(registry, lazyImports);\n  manifestLazyImports.set(manifest, lazyImports);\n}\n\nexport function clearPendingLazy(): void {\n  pendingLazy.clear();\n}\n\nexport function restorePendingLazy(lazyImports: readonly Promise<unknown>[]) {\n  pendingLazy.clear();\n  for (const lazyImport of lazyImports) {\n    pendingLazy.add(lazyImport);\n  }\n}\n"],"mappings":";AAQA,MAAM,8BAAc,IAAI,IAAsB;AAC9C,MAAM,sCAAsB,IAAI,QAA2C;AAC3E,MAAM,sCAAsB,IAAI,QAA2C;AAE3E,SAAgB,KACd,SACY;CACZ,IAAI,WAA8B;CAClC,IAAI,YAAqB;CAEzB,MAAM,UAAU,QAAQ,CAAC,CAAC,MACvB,QAAQ;EACP,WACE,OAAO,QAAQ,aACX,MACC,IAAgC;EACvC,YAAY,OAAO,OAAO;CAC5B,IACC,QAAiB;EAChB,YAAY;EACZ,YAAY,OAAO,OAAO;CAC5B,CACF;CACA,YAAY,IAAI,OAAO;CAEvB,SAAS,WAAwB;EAC/B,IAAI,WAAW,MAAM;EACrB,IAAI,CAAC,UACH,MAAM,IAAI,MACR,iHAEF;EAEF,OAAQ,SAAyC,MAAM;CACzD;AACF;AAEA,SAAgB,gBAAoC;CAClD,OAAO,CAAC,GAAG,WAAW;AACxB;AAEA,SAAgB,yBAAyB,QAGlB;CACrB,MAAM,0BAAU,IAAI,IAAsB;CAE1C,IAAI,OAAO,UACT,KAAK,MAAM,cAAc,oBAAoB,IAAI,OAAO,QAAQ,KAAK,CAAC,GACpE,QAAQ,IAAI,UAAU;CAI1B,MAAM,WAAW,OAAO,YAAY,OAAO,UAAU;CACrD,IAAI,UACF,KAAK,MAAM,cAAc,oBAAoB,IAAI,QAAQ,KAAK,CAAC,GAC7D,QAAQ,IAAI,UAAU;CAI1B,OAAO,CAAC,GAAG,OAAO;AACpB;AAEA,SAAgB,WACd,oBAAgD,CAAC,GAClC;CACf,MAAM,2BAAW,IAAI,IAAsB,CACzC,GAAG,mBACH,GAAG,WACL,CAAC;CACD,IAAI,SAAS,SAAS,GAAG,OAAO,QAAQ,QAAQ;CAChD,OAAO,QAAQ,WAAW,QAAQ,CAAC,CAAC,WAAW,MAAS;AAC1D;AAEA,SAAgB,yBACd,UACA,UACA,aACM;CACN,IAAI,YAAY,WAAW,GACzB;CAGF,oBAAoB,IAAI,UAAU,WAAW;CAC7C,oBAAoB,IAAI,UAAU,WAAW;AAC/C;AAEA,SAAgB,mBAAyB;CACvC,YAAY,MAAM;AACpB;AAEA,SAAgB,mBAAmB,aAA0C;CAC3E,YAAY,MAAM;CAClB,KAAK,MAAM,cAAc,aACvB,YAAY,IAAI,UAAU;AAE9B"}

package/dist/router/manifest.d.ts

@@ -0,0 +1,10 @@
+import { RegisterRoutesOptions, RouteDefinition, RouteManifest, RouteRegistry } from "../common/router.js";
+
+//#region src/router/manifest.d.ts
+declare function getManifest(): RouteManifest;
+declare function _applyManifest(manifest: RouteManifest): void;
+declare function clearRoutes(): void;
+declare function createRouteRegistry(definition: RouteDefinition, options?: RegisterRoutesOptions): RouteRegistry;
+//#endregion
+export { clearRoutes, createRouteRegistry, getManifest };
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","names":[],"sources":["../../src/router/manifest.ts"],"mappings":";;;iBA0BgB,WAAA,IAAe,aAAa;AAAA,iBAQ5B,cAAA,CAAe,QAAuB,EAAb,aAAa;AAAA,iBAkBtC,WAAA;AAAA,iBAKA,mBAAA,CACd,UAAA,EAAY,eAAA,EACZ,OAAA,GAAS,qBAAA,GACR,aAAA"}

package/dist/router/manifest.js

@@ -0,0 +1,49 @@
+import { addRouteToStores, clearRouteState, getDefaultRouteAuthOptions, getRouteRecords, getRoutes, insertRecordSorted, restoreRouteState, setDefaultRouteAuthOptions, snapshotRouteState } from "./store.js";
+import { registerRoutes } from "./authoring.js";
+import { _snapshotLazy, associateRouteSourceLazy, clearPendingLazy, restorePendingLazy } from "./lazy.js";
+//#region src/router/manifest.ts
+function getManifest() {
+	const auth = getDefaultRouteAuthOptions();
+	return {
+		records: [...getRouteRecords()],
+		...auth ? { auth } : {}
+	};
+}
+function _applyManifest(manifest) {
+	setDefaultRouteAuthOptions(manifest.auth);
+	for (const record of manifest.records) {
+		insertRecordSorted(record);
+		addRouteToStores({
+			path: record.path,
+			handler: record.handler,
+			namespace: record.options.namespace,
+			..."fallbackPrefix" in record && typeof record.fallbackPrefix === "string" ? { fallbackPrefix: record.fallbackPrefix } : {}
+		});
+	}
+}
+function clearRoutes() {
+	clearRouteState();
+	clearPendingLazy();
+}
+function createRouteRegistry(definition, options = {}) {
+	const previous = snapshotRouteState();
+	const previousLazy = _snapshotLazy();
+	clearRoutes();
+	try {
+		registerRoutes(definition, options);
+		const manifest = getManifest();
+		const registry = Object.freeze({
+			manifest,
+			routes: getRoutes()
+		});
+		associateRouteSourceLazy(registry, manifest, _snapshotLazy());
+		return registry;
+	} finally {
+		restoreRouteState(previous);
+		restorePendingLazy(previousLazy);
+	}
+}
+//#endregion
+export { _applyManifest, clearRoutes, createRouteRegistry, getManifest };
+
+//# sourceMappingURL=manifest.js.map

package/dist/router/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","names":[],"sources":["../../src/router/manifest.ts"],"sourcesContent":["import type {\n  RegisterRoutesOptions,\n  RouteManifest,\n  RouteRegistry,\n  RouteDefinition,\n} from '../common/router';\nimport { registerRoutes } from './authoring';\nimport {\n  addRouteToStores,\n  clearRouteState,\n  getDefaultRouteAuthOptions,\n  getRouteRecords,\n  getRoutes,\n  insertRecordSorted,\n  restoreRouteState,\n  setDefaultRouteAuthOptions,\n  snapshotRouteState,\n} from './store';\nimport type { InternalRouteRecord } from './internal-types';\nimport {\n  _snapshotLazy,\n  associateRouteSourceLazy,\n  clearPendingLazy,\n  restorePendingLazy,\n} from './lazy';\n\nexport function getManifest(): RouteManifest {\n  const auth = getDefaultRouteAuthOptions();\n  return {\n    records: [...getRouteRecords()],\n    ...(auth ? { auth } : {}),\n  };\n}\n\nexport function _applyManifest(manifest: RouteManifest): void {\n  setDefaultRouteAuthOptions(manifest.auth);\n  for (const record of manifest.records) {\n    insertRecordSorted(record as InternalRouteRecord);\n    addRouteToStores({\n      path: record.path,\n      handler: record.handler,\n      namespace: record.options.namespace,\n      ...('fallbackPrefix' in record &&\n      typeof (record as InternalRouteRecord).fallbackPrefix === 'string'\n        ? {\n            fallbackPrefix: (record as InternalRouteRecord).fallbackPrefix,\n          }\n        : {}),\n    });\n  }\n}\n\nexport function clearRoutes(): void {\n  clearRouteState();\n  clearPendingLazy();\n}\n\nexport function createRouteRegistry(\n  definition: RouteDefinition,\n  options: RegisterRoutesOptions = {}\n): RouteRegistry {\n  const previous = snapshotRouteState();\n  const previousLazy = _snapshotLazy();\n  clearRoutes();\n\n  try {\n    registerRoutes(definition, options);\n    const manifest = getManifest();\n    const registry = Object.freeze({\n      manifest,\n      routes: getRoutes(),\n    });\n    const lazyImports = _snapshotLazy();\n    associateRouteSourceLazy(registry, manifest, lazyImports);\n\n    return registry;\n  } finally {\n    restoreRouteState(previous);\n    restorePendingLazy(previousLazy);\n  }\n}\n"],"mappings":";;;;AA0BA,SAAgB,cAA6B;CAC3C,MAAM,OAAO,2BAA2B;CACxC,OAAO;EACL,SAAS,CAAC,GAAG,gBAAgB,CAAC;EAC9B,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;CACzB;AACF;AAEA,SAAgB,eAAe,UAA+B;CAC5D,2BAA2B,SAAS,IAAI;CACxC,KAAK,MAAM,UAAU,SAAS,SAAS;EACrC,mBAAmB,MAA6B;EAChD,iBAAiB;GACf,MAAM,OAAO;GACb,SAAS,OAAO;GAChB,WAAW,OAAO,QAAQ;GAC1B,GAAI,oBAAoB,UACxB,OAAQ,OAA+B,mBAAmB,WACtD,EACE,gBAAiB,OAA+B,eAClD,IACA,CAAC;EACP,CAAC;CACH;AACF;AAEA,SAAgB,cAAoB;CAClC,gBAAgB;CAChB,iBAAiB;AACnB;AAEA,SAAgB,oBACd,YACA,UAAiC,CAAC,GACnB;CACf,MAAM,WAAW,mBAAmB;CACpC,MAAM,eAAe,cAAc;CACnC,YAAY;CAEZ,IAAI;EACF,eAAe,YAAY,OAAO;EAClC,MAAM,WAAW,YAAY;EAC7B,MAAM,WAAW,OAAO,OAAO;GAC7B;GACA,QAAQ,UAAU;EACpB,CAAC;EAED,yBAAyB,UAAU,UADf,cACyB,CAAW;EAExD,OAAO;CACT,UAAU;EACR,kBAAkB,QAAQ;EAC1B,mBAAmB,YAAY;CACjC;AACF"}

package/dist/router/navigate.d.ts

@@ -1,40 +1,11 @@
-import { ComponentInstance } from "../runtime/component.js";
-import { Route, RouteAuthOptions, RouteManifest } from "../common/router.js";
+import { HistoryScrollBehavior, NavigationScrollBehavior, ScrollRestorationOptions } from "./navigation-scroll.js";
+import { NavigateOptions } from "./navigation-targets.js";
+import { RouteQueryParamInput, RouteQueryParamValue, RouteQueryUpdater, RouteQueryUpdates, UpdateRouteQueryOptions, updateRouteQuery } from "./route-query.js";
 
 //#region src/router/navigate.d.ts
-type AppNavigationSource = {
-  manifest?: RouteManifest;
-  routes?: readonly Route[];
-  auth?: RouteAuthOptions;
-};
-type NavigationScrollBehavior = 'top' | 'preserve';
-type HistoryScrollBehavior = 'restore' | 'top' | 'preserve';
-type ScrollRestorationOptions = {
-  navigation?: NavigationScrollBehavior;
-  history?: HistoryScrollBehavior;
-};
-type NavigateOptions = {
-  history?: 'push' | 'replace';
-  replace?: boolean;
-  scroll?: NavigationScrollBehavior;
-};
-declare function configureScrollRestoration(options?: boolean | ScrollRestorationOptions): void;
-/** Register the current app instance (called by createSPA/hydrateSPA). */
-declare function registerAppInstance(instance: ComponentInstance, path: string, source?: AppNavigationSource): void;
-declare function unregisterAppInstance(instance: ComponentInstance): void;
-/**
- * Navigate to a new path
- * Updates URL, resolves route, and re-mounts app with new handler
- */
 declare function navigate(path: string, options?: NavigateOptions): void;
-/**
- * Setup popstate listener for browser navigation
- */
 declare function initializeNavigation(): void;
-/**
- * Cleanup navigation listeners
- */
 declare function cleanupNavigation(): void;
 //#endregion
-export { HistoryScrollBehavior, NavigateOptions, NavigationScrollBehavior, ScrollRestorationOptions, navigate };
+export { type HistoryScrollBehavior, type NavigateOptions, type NavigationScrollBehavior, type RouteQueryParamInput, type RouteQueryParamValue, type RouteQueryUpdater, type RouteQueryUpdates, type ScrollRestorationOptions, type UpdateRouteQueryOptions, navigate, updateRouteQuery };
 //# sourceMappingURL=navigate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"navigate.d.ts","names":[],"sources":["../../src/router/navigate.ts"],"mappings":";;;;KA8CK,mBAAA;EACH,QAAA,GAAW,aAAA;EACX,MAAA,YAAkB,KAAA;EAClB,IAAA,GAAO,gBAAA;AAAA;AAAA,KA2DG,wBAAA;AAAA,KACA,qBAAA;AAAA,KAEA,wBAAA;EACV,UAAA,GAAa,wBAAA;EACb,OAAA,GAAU,qBAAqB;AAAA;AAAA,KAqBrB,eAAA;EACV,OAAA;EACA,OAAA;EACA,MAAA,GAAS,wBAAwB;AAAA;AAAA,iBAsInB,0BAAA,CACd,OAA4C,aAAxB,wBAAwB;;iBA0Y9B,mBAAA,CACd,QAAA,EAAU,iBAAA,EACV,IAAA,UACA,MAAA,GAAQ,mBAAwB;AAAA,iBA4BlB,qBAAA,CAAsB,QAA2B,EAAjB,iBAAiB;AA5kBjE;;;;AAAA,iBAmnBgB,QAAA,CAAS,IAAA,UAAc,OAAA,GAAS,eAAoB;AAjnBpE;;;AAAA,iBAiyBgB,oBAAA;;;;iBAYA,iBAAA"}
+{"version":3,"file":"navigate.d.ts","names":[],"sources":["../../src/router/navigate.ts"],"mappings":";;;;;iBAmDgB,QAAA,CAAS,IAAA,UAAc,OAAA,GAAS,eAAoB;AAAA,iBAyHpD,oBAAA;AAAA,iBASA,iBAAA"}