devframe 0.9.0-beta.1 → 0.9.0-beta.10

package/dist/nostics-CzECRXpE.mjs

@@ -0,0 +1,59 @@
+import { Diagnostic, createConsoleReporter, defineDiagnostics, defineProdDiagnostics, formatDiagnostic } from "nostics";
+import { ansiFormatter, ansiFormatter as ansiFormatter$1 } from "nostics/formatters/ansi";
+//#region src/utils/colors.ts
+function makeColor(open, close) {
+	const o = `\x1B[${open}m`;
+	const c = `\x1B[${close}m`;
+	return ((arg, ...values) => {
+		if (Array.isArray(arg) && "raw" in arg) {
+			const strings = arg;
+			let out = "";
+			for (let i = 0; i < strings.length; i++) {
+				out += strings[i];
+				if (i < values.length) out += String(values[i]);
+			}
+			return `${o}${out}${c}`;
+		}
+		return `${o}${String(arg)}${c}`;
+	});
+}
+const colors = {
+	blue: makeColor(34, 39),
+	cyan: makeColor(36, 39),
+	gray: makeColor(90, 39),
+	green: makeColor(32, 39),
+	red: makeColor(31, 39),
+	yellow: makeColor(33, 39),
+	bold: makeColor(1, 22),
+	dim: makeColor(2, 22),
+	reset: makeColor(0, 0),
+	underline: makeColor(4, 24)
+};
+//#endregion
+//#region src/utils/nostics.ts
+const formatAnsi = ansiFormatter(colors);
+/**
+* The reporter every {@link defineDiagnostics} call below wires in ahead of
+* any caller-supplied ones: prints the diagnostic through devframe's own
+* ANSI colors via `console[method]` (default `'warn'`).
+*/
+function devframeReporter(d, { method = "warn" } = {}) {
+	console[method](formatAnsi(d));
+}
+/**
+* Drop-in replacement for `nostics`'s `defineDiagnostics()` with devframe's
+* ANSI console reporter pre-wired ahead of any `reporters` passed in. Every
+* `diagnostics.ts` in devframe core, `@devframes/hub`, `@devframes/json-render`,
+* and the built-in plugins defines its codes through this instead of
+* `nostics`'s own `defineDiagnostics` — the reporter registration lives
+* here, once, so none of them need to build their own reporter (`colors`,
+* `ansiFormatter`) or take a direct dependency on `nostics` themselves.
+*/
+function defineDiagnostics$1(options) {
+	return defineDiagnostics({
+		...options,
+		reporters: [devframeReporter, ...options.reporters ?? []]
+	});
+}
+//#endregion
+export { defineProdDiagnostics as a, defineDiagnostics$1 as i, ansiFormatter$1 as n, formatDiagnostic as o, createConsoleReporter as r, colors as s, Diagnostic as t };

package/dist/nostics-SPGDgHEP.d.mts

@@ -0,0 +1,33 @@
+import { AnyDiagnosticReporter, AnyDiagnosticReporter as AnyDiagnosticReporter$1, ConsoleMethod, ConsoleReporterOptions, Diagnostic, Diagnostic as Diagnostic$1, DiagnosticCallParams, DiagnosticDefinition, DiagnosticDefinition as DiagnosticDefinition$1, DiagnosticHandle, DiagnosticInit, DiagnosticReporter, Diagnostics, Diagnostics as Diagnostics$1, createConsoleReporter, defineProdDiagnostics, formatDiagnostic } from "nostics";
+import { ansiFormatter } from "nostics/formatters/ansi";
+//#region src/utils/nostics.d.ts
+/**
+ * The reporter every {@link defineDiagnostics} call below wires in ahead of
+ * any caller-supplied ones: prints the diagnostic through devframe's own
+ * ANSI colors via `console[method]` (default `'warn'`).
+ */
+declare function devframeReporter(d: Diagnostic, { method }?: {
+  method?: 'log' | 'warn' | 'error';
+}): void;
+/**
+ * Options accepted by {@link defineDiagnostics} — identical to `nostics`'s
+ * own `DefineDiagnosticsOptions`, minus the reporter devframe already
+ * prepends.
+ */
+type DevframeDefineDiagnosticsOptions<Codes extends Record<string, DiagnosticDefinition>, Reporters extends readonly AnyDiagnosticReporter[] = []> = Parameters<typeof defineDiagnostics<Codes, Reporters>>[0];
+/**
+ * Drop-in replacement for `nostics`'s `defineDiagnostics()` with devframe's
+ * ANSI console reporter pre-wired ahead of any `reporters` passed in. Every
+ * `diagnostics.ts` in devframe core, `@devframes/hub`, `@devframes/json-render`,
+ * and the built-in plugins defines its codes through this instead of
+ * `nostics`'s own `defineDiagnostics` — the reporter registration lives
+ * here, once, so none of them need to build their own reporter (`colors`,
+ * `ansiFormatter`) or take a direct dependency on `nostics` themselves.
+ */
+declare function defineDiagnostics<const Codes extends Record<string, DiagnosticDefinition>, const Reporters extends readonly AnyDiagnosticReporter[] = []>(options: {
+  docsBase?: string | ((code: keyof Codes) => string | undefined);
+  codes: Codes;
+  reporters?: Reporters;
+}): Diagnostics<Codes, readonly [typeof devframeReporter, ...Reporters]>;
+//#endregion
+export { Diagnostic$1 as a, DiagnosticHandle as c, Diagnostics$1 as d, ansiFormatter as f, formatDiagnostic as g, defineProdDiagnostics as h, DevframeDefineDiagnosticsOptions as i, DiagnosticInit as l, defineDiagnostics as m, ConsoleMethod as n, DiagnosticCallParams as o, createConsoleReporter as p, ConsoleReporterOptions as r, DiagnosticDefinition$1 as s, AnyDiagnosticReporter$1 as t, DiagnosticReporter as u };

package/dist/recipes/common-rpc-functions.d.mts

@@ -1,6 +1,6 @@
-import "../devframe-Bdd9YXTy.mjs";
-import "../index-DSCq4M4q.mjs";
-import { E as Thenable, S as RpcFunctionSetupResult, c as RpcDump, g as RpcFunctionAgentOptions } from "../types-CnJSgRVa.mjs";
+import "../devframe-DJMg0WLe.mjs";
+import "../index-tdrk1bzV.mjs";
+import { E as Thenable, S as RpcFunctionSetupResult, c as RpcDump, g as RpcFunctionAgentOptions } from "../types-Djq7CBXh.mjs";
 import { SimpleSchema } from "../utils/simple-schema.mjs";
 //#region src/recipes/common-rpc-functions.d.ts
 /**

package/dist/recipes/interactive-auth.d.mts

@@ -1,5 +1,5 @@
-import { p as DevframeAuthHandler, x as DevframeNodeContext } from "../devframe-Bdd9YXTy.mjs";
-import "../index-CZRd2K1C.mjs";
+import { g as DevframeNodeContext, u as DevframeAuthHandler } from "../devframe-DJMg0WLe.mjs";
+import "../index-CB-fSUyn.mjs";
 //#region src/recipes/interactive-auth.d.ts
 interface CreateInteractiveAuthOptions {
   /**

package/dist/recipes/interactive-auth.mjs

@@ -1,8 +1,8 @@
-import { n as colors } from "../diagnostics-reporter-CsIG85Q5.mjs";
+import { s as colors } from "../nostics-CzECRXpE.mjs";
 import { n as defineRpcFunction } from "../define-BLWPsH6y.mjs";
 import { isAnonymousRpcMethod } from "../constants.mjs";
-import { a as verifyAuthToken, n as exchangeTempAuthCode, r as getTempAuthCode, t as buildOtpAuthUrl } from "../state-BeUHDDjk.mjs";
-import { t as getInternalContext } from "../context-C33rR7n0.mjs";
+import { a as verifyAuthToken, n as exchangeTempAuthCode, r as getTempAuthCode, t as buildOtpAuthUrl } from "../state-Cc1IeSmQ.mjs";
+import { t as getInternalContext } from "../context-xdynGSLP.mjs";
 import { t as s } from "../simple-schema-DQPZrAaZ.mjs";
 //#region src/recipes/interactive-auth.ts
 function defaultBanner(info) {

package/dist/remote-assets-Bg4gCUZ_.d.mts

@@ -0,0 +1,123 @@
+//#region src/types/remote-assets.d.ts
+/**
+ * A version-locked pointer at browser assets published as their own npm
+ * package (e.g. `@devframes/plugin-git-client`), served through devframe's
+ * caching back-proxy instead of a directory shipped inside the node package.
+ *
+ * Resolution order at serve time:
+ *
+ *   1. The package installed locally (resolved from {@link resolveFrom})
+ *      — the zero-network / air-gap path. Version skew warns; a major
+ *      version mismatch throws.
+ *   2. The per-file cache under
+ *      `<storageDir project>/.remote-assets/<package>@<version>/`.
+ *   3. The CDN {@link provider} — each requested file streams through to
+ *      the browser while being written into the cache.
+ *
+ * Anywhere a static mount accepts a dist directory (`cli.distDir`,
+ * `hostStatic`, `mountStatic`) it also accepts this object — see
+ * {@link StaticAssetsSource}.
+ */
+interface RemoteAssets {
+  /** npm package name that ships the assets, e.g. `@devframes/plugin-git-client`. */
+  package: string;
+  /** Exact version to serve, e.g. `1.2.3`. Typically the host package's own version. */
+  version: string;
+  /**
+   * Subpath inside the package the served assets live under.
+   *
+   * @default 'dist'
+   */
+  path?: string;
+  /**
+   * CDN that mirrors npm and serves individual package files.
+   *
+   * @default 'jsdelivr'
+   */
+  provider?: RemoteAssetsProvider;
+  /**
+   * `import.meta.url` of the declaring module. When set, a locally
+   * installed copy of {@link package} is resolved from this module's own
+   * dependency graph first (works under pnpm's strict layout) and served
+   * with zero network. Omitting it skips the installed-package step —
+   * cache + CDN still work.
+   */
+  resolveFrom?: string | null;
+  /** Custom fetch implementation (proxies, tests). Defaults to the global `fetch`. */
+  fetch?: typeof globalThis.fetch;
+  /**
+   * Never touch the network: serve only from the locally installed package
+   * or files already in the cache.
+   *
+   * @default false
+   */
+  offline?: boolean;
+}
+/**
+ * Built-in CDN providers (`'jsdelivr'` — default, `'unpkg'`) or a custom
+ * provider for corp mirrors.
+ */
+type RemoteAssetsProvider = 'jsdelivr' | 'unpkg' | RemoteAssetsProviderCustom;
+/** A custom {@link RemoteAssets} CDN provider (e.g. an internal npm mirror). */
+interface RemoteAssetsProviderCustom {
+  /**
+   * Absolute URL serving `filePath` (package-relative, POSIX, no leading
+   * slash) of `pkg@version`.
+   */
+  fileUrl: (pkg: string, version: string, filePath: string) => string;
+  /**
+   * List every file path in `pkg@version` (package-relative, no leading
+   * slash). Powers request-path resolution (correct 404s / SPA fallback)
+   * and build-time materialization. When omitted, requests are resolved by
+   * probing {@link fileUrl} directly and builds cannot materialize from
+   * this provider.
+   */
+  listFiles?: (pkg: string, version: string, fetchImpl: typeof globalThis.fetch) => Promise<string[]>;
+}
+/**
+ * What every static-assets seam accepts: a local dist directory, or a
+ * {@link RemoteAssets} pointer served through the caching back-proxy.
+ */
+type StaticAssetsSource = string | RemoteAssets;
+/**
+ * What the remote-assets fallback page posts to `window.parent` when a
+ * devframe's client assets could be served from neither a local install nor
+ * their provider. A viewer embedding the devframe in an iframe listens for
+ * `DEVFRAME_REMOTE_ASSETS_ERROR_MESSAGE_TYPE` (`devframe/constants`) and can
+ * render the failure in its own design, with the two ways out the page also
+ * spells out: install `package@version` locally, or restore network access.
+ */
+interface RemoteAssetsErrorMessage {
+  type: 'devframe:remote-assets-error';
+  /** npm package the assets are published as. */
+  package: string;
+  /** Exact version the devframe asked for. */
+  version: string;
+  /** Why the fetch failed, as reported by the provider or the network stack. */
+  reason: string;
+}
+/**
+ * A resolved, servable handle over a {@link RemoteAssets} declaration —
+ * produced by `resolveStaticAssetsSource()` (`devframe/utils/remote-assets`)
+ * and consumed by the static-serving engine (`devframe/utils/serve-static`).
+ */
+interface RemoteAssetsStore {
+  /** The declaration this store serves (with defaults applied). */
+  readonly assets: RemoteAssets & {
+    path: string;
+  };
+  /**
+   * Resolve a request path (relative to the mount base, SPA fallback to
+   * `index.html`) and return a `Response`: streamed from the cache when
+   * present, otherwise through the provider while being written into the
+   * cache. `null` on a miss (404); throws on provider/network failure.
+   */
+  serve: (urlPath: string) => Promise<Response | null>;
+  /**
+   * Download every listed file under `assets.path` into `targetDir`
+   * (paths relative to `assets.path`). Requires a provider file listing.
+   */
+  materialize: (targetDir: string) => Promise<void>;
+}
+//#endregion
+export { RemoteAssetsStore as a, RemoteAssetsProviderCustom as i, RemoteAssetsErrorMessage as n, StaticAssetsSource as o, RemoteAssetsProvider as r, RemoteAssets as t };