@veryfront/ext-content-mdx 0.1.1226 → 0.1.1228

package/esm/src/extensions/parser/yaml-parser.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Extension boundary for general-purpose YAML decoding.
+ *
+ * Core owns front matter framing, mapping policy, and every call site's
+ * downstream validation. Implementations own only YAML decoding, which is the
+ * one part that needs a third-party parser and therefore may not live in core.
+ *
+ * This is a sibling of `SkillDocumentParserProvider`, not an extension of it,
+ * for two reasons. First, `snapshotSkillDocumentParserProvider` enforces that
+ * a provider has exactly one own key named `parseFrontmatter`; adding a second
+ * method would mean weakening an invariant that guards an untrusted Skill
+ * document trust boundary. Second, general YAML decoding needs the decoding
+ * options (`schema`, `allowDuplicateKeys`) that the Skill contract
+ * deliberately withholds so that core, not the extension, fixes Skill policy.
+ *
+ * @module extensions/parser/yaml-parser
+ */
+/** Stable runtime identifier for the general YAML parser contract. */
+export declare const YamlParserProviderName: "YamlParserProvider";
+/**
+ * Decoding options, named after the `@std/yaml` options the framework's call
+ * sites already pass so that repointing a call site is a specifier change.
+ */
+export interface YamlParseOptions {
+    /**
+     * Accept a mapping that repeats a key. Defaults to false: a repeated key is
+     * a source defect, and picking a winner silently hides it.
+     */
+    readonly allowDuplicateKeys?: boolean;
+    /**
+     * `"json"` restricts resolution to JSON-representable types. Use it at
+     * trust boundaries where a timestamp, a binary blob, or any other
+     * implementation-specific tag must not appear in the decoded value.
+     */
+    readonly schema?: "core" | "json";
+}
+/** Dependency-free contract implemented by YAML parser extensions. */
+export interface YamlParserProvider {
+    /**
+     * Decode one YAML document.
+     *
+     * Implementations must be synchronous, must reject a source holding more
+     * than one document, and must raise `SyntaxError` for malformed input. The
+     * returned value is untrusted; core validates it at each call site.
+     */
+    readonly parseYaml: (source: string, options?: YamlParseOptions) => unknown;
+}
+/**
+ * Capture one immutable provider generation.
+ *
+ * The captured facade re-checks the synchronous contract on every call: an
+ * implementation that returns a Promise would otherwise hand a pending value
+ * to synchronous call sites that cannot await it, and the resulting `[object
+ * Promise]` front matter is far harder to diagnose than a thrown TypeError.
+ */
+export declare function snapshotYamlParserProvider(value: unknown): Readonly<YamlParserProvider>;
+/** Create immutable provider registration metadata from a standalone parser. */
+export declare function createYamlParserProvider(parseYaml: YamlParserProvider["parseYaml"]): Readonly<YamlParserProvider>;
+//# sourceMappingURL=yaml-parser.d.ts.map

package/esm/src/extensions/parser/yaml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-parser.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/parser/yaml-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,EAAG,oBAA6B,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACnC;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC;CAC7E;AAQD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,QAAQ,CAAC,kBAAkB,CAAC,CA4B9B;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,kBAAkB,CAAC,WAAW,CAAC,GACzC,QAAQ,CAAC,kBAAkB,CAAC,CAE9B"}

package/esm/src/extensions/parser/yaml-parser.js

@@ -0,0 +1,62 @@
+/**
+ * Extension boundary for general-purpose YAML decoding.
+ *
+ * Core owns front matter framing, mapping policy, and every call site's
+ * downstream validation. Implementations own only YAML decoding, which is the
+ * one part that needs a third-party parser and therefore may not live in core.
+ *
+ * This is a sibling of `SkillDocumentParserProvider`, not an extension of it,
+ * for two reasons. First, `snapshotSkillDocumentParserProvider` enforces that
+ * a provider has exactly one own key named `parseFrontmatter`; adding a second
+ * method would mean weakening an invariant that guards an untrusted Skill
+ * document trust boundary. Second, general YAML decoding needs the decoding
+ * options (`schema`, `allowDuplicateKeys`) that the Skill contract
+ * deliberately withholds so that core, not the extension, fixes Skill policy.
+ *
+ * @module extensions/parser/yaml-parser
+ */
+import { isNativePromiseWithoutHooks } from "../../platform/compat/error-introspection.js";
+/** Stable runtime identifier for the general YAML parser contract. */
+export const YamlParserProviderName = "YamlParserProvider";
+function providerInspectionError() {
+    return new TypeError("YAML parser provider must be an object with a callable parseYaml property");
+}
+/**
+ * Capture one immutable provider generation.
+ *
+ * The captured facade re-checks the synchronous contract on every call: an
+ * implementation that returns a Promise would otherwise hand a pending value
+ * to synchronous call sites that cannot await it, and the resulting `[object
+ * Promise]` front matter is far harder to diagnose than a thrown TypeError.
+ */
+export function snapshotYamlParserProvider(value) {
+    if (typeof value !== "object" || value === null)
+        throw providerInspectionError();
+    const descriptor = Object.getOwnPropertyDescriptor(value, "parseYaml");
+    // An accessor descriptor has no own `value`, so a plain `descriptor.value`
+    // read would return whatever a poisoned `Object.prototype.value` supplies.
+    // Requiring the own property keeps an accessor-backed registration out.
+    if (descriptor === undefined ||
+        !Object.prototype.hasOwnProperty.call(descriptor, "value") ||
+        typeof descriptor.value !== "function") {
+        throw providerInspectionError();
+    }
+    const parseYaml = descriptor.value;
+    const facade = {
+        parseYaml(source, options) {
+            if (typeof source !== "string") {
+                throw new TypeError("YAML source must be a string");
+            }
+            const parsed = Reflect.apply(parseYaml, undefined, [source, options]);
+            if (isNativePromiseWithoutHooks(parsed)) {
+                throw new TypeError("YAML parser provider must be synchronous");
+            }
+            return parsed;
+        },
+    };
+    return Object.freeze(facade);
+}
+/** Create immutable provider registration metadata from a standalone parser. */
+export function createYamlParserProvider(parseYaml) {
+    return snapshotYamlParserProvider({ parseYaml });
+}

package/esm/src/extensions/recommendations.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Maps contract names to recommended first-party extension packages.
+ *
+ * @module extensions/recommendations
+ */
+/** Return recommendation. */
+export declare function getRecommendation(contractName: string): string | undefined;
+//# sourceMappingURL=recommendations.d.ts.map

package/esm/src/extensions/recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/recommendations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgCH,6BAA6B;AAC7B,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E"}

package/esm/src/extensions/recommendations.js

@@ -0,0 +1,38 @@
+/**
+ * Maps contract names to recommended first-party extension packages.
+ *
+ * @module extensions/recommendations
+ */
+const recommendations = new Map([
+    ["Bundler", "@veryfront/ext-bundler-esbuild"],
+    // ModuleLexer ships in the same package as Bundler (es-module-lexer +
+    // esbuild are co-bundled into ext-bundler-esbuild).
+    ["ModuleLexer", "@veryfront/ext-bundler-esbuild"],
+    ["TokenCacheStore", "@veryfront/ext-cache-redis"],
+    ["RedisRuntimeProvider", "npm:@veryfront/ext-redis"],
+    ["CSSProcessor", "@veryfront/ext-css-tailwind"],
+    ["CSSOptimizationEngine", "@veryfront/ext-css-lightning"],
+    ["CSSPurgingEngine", "@veryfront/ext-css-purgecss"],
+    ["ImageOptimizationEngine", "@veryfront/ext-image-sharp"],
+    ["ContentProcessor", "@veryfront/ext-content-mdx"],
+    ["DocumentExtractor", "@veryfront/ext-document-kreuzberg"],
+    ["AuthProvider", "@veryfront/ext-auth-jwt"],
+    ["TracingExporter", "@veryfront/ext-observability-opentelemetry"],
+    ["NodeTelemetryProvider", "@veryfront/ext-observability-opentelemetry"],
+    ["LLMProvider:openai", "@veryfront/ext-llm-openai"],
+    ["LLMProvider:anthropic", "@veryfront/ext-llm-anthropic"],
+    ["LLMProvider:google", "@veryfront/ext-llm-google"],
+    ["CodeParser", "@veryfront/ext-parser-babel"],
+    ["SchemaValidator", "@veryfront/ext-schema-zod"],
+    ["SqliteStore", "@veryfront/ext-db-sqlite"],
+    ["SandboxShellToolsProvider", "@veryfront/ext-sandbox-shell-tools"],
+    ["NodeWebSocketServerProvider", "@veryfront/ext-node-websocket-ws"],
+    // Skill frontmatter decoding and general YAML decoding are both satisfied by
+    // the single parser bundled in ext-yaml.
+    ["SkillDocumentParserProvider", "@veryfront/ext-yaml"],
+    ["YamlParserProvider", "@veryfront/ext-yaml"],
+]);
+/** Return recommendation. */
+export function getRecommendation(contractName) {
+    return recommendations.get(contractName);
+}

package/esm/src/extensions/runtime-validation.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Internal runtime validation for dynamically loaded extension boundaries.
+ *
+ * Static TypeScript contracts disappear at runtime. These helpers validate the
+ * small set of values that cross dynamic module and registry boundaries while
+ * containing hostile accessors behind contextual TypeErrors.
+ */
+export type ZeroArgumentConstructor<T> = new () => T;
+/** Require a non-empty string without hidden surrounding whitespace. */
+export declare function assertCanonicalNonEmptyString(value: unknown, label: string): asserts value is string;
+/** Read and validate a zero-argument constructor from a dynamic module. */
+export declare function getConstructibleModuleExport<T>(extensionModule: unknown, moduleName: string, exportName: string): ZeroArgumentConstructor<T>;
+/** Validate the required method surface of a dynamically constructed value. */
+export declare function assertRequiredMethods(instance: unknown, moduleName: string, exportName: string, methodNames: readonly string[]): void;
+/** Capture a registry entry's identity exactly once. */
+export declare function captureRegistrationId(value: unknown, registrationName: string): string;
+/** Require a callable method on a registry entry. */
+export declare function assertRegistrationMethod(value: unknown, registrationName: string, methodName: string): void;
+/** Validate an optional method when a registry entry supplies it. */
+export declare function assertOptionalRegistrationMethod(value: unknown, registrationName: string, methodName: string): void;
+//# sourceMappingURL=runtime-validation.d.ts.map

package/esm/src/extensions/runtime-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-validation.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/runtime-validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC;AAErD,wEAAwE;AACxE,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,IAAI,MAAM,CAQzB;AAcD,2EAA2E;AAC3E,wBAAgB,4BAA4B,CAAC,CAAC,EAC5C,eAAe,EAAE,OAAO,EACxB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,uBAAuB,CAAC,CAAC,CAAC,CA0B5B;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,IAAI,CAiBN;AAiCD,wDAAwD;AACxD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAOR;AAED,qDAAqD;AACrD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAWN;AAED,qEAAqE;AACrE,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,OAAO,EACd,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAWN"}

package/esm/src/extensions/runtime-validation.js

@@ -0,0 +1,95 @@
+/**
+ * Internal runtime validation for dynamically loaded extension boundaries.
+ *
+ * Static TypeScript contracts disappear at runtime. These helpers validate the
+ * small set of values that cross dynamic module and registry boundaries while
+ * containing hostile accessors behind contextual TypeErrors.
+ */
+/** Require a non-empty string without hidden surrounding whitespace. */
+export function assertCanonicalNonEmptyString(value, label) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        value.trim() !== value) {
+        throw new TypeError(`${label} must be a non-empty canonical string`);
+    }
+}
+function isConstructor(value) {
+    if (typeof value !== "function")
+        return false;
+    try {
+        Reflect.construct(Object, [], value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Read and validate a zero-argument constructor from a dynamic module. */
+export function getConstructibleModuleExport(extensionModule, moduleName, exportName) {
+    if (extensionModule === null ||
+        (typeof extensionModule !== "object" && typeof extensionModule !== "function")) {
+        throw new TypeError(`Invalid ${moduleName} module: expected a module namespace`);
+    }
+    let candidate;
+    try {
+        candidate = extensionModule[exportName];
+    }
+    catch (cause) {
+        throw new TypeError(`Invalid ${moduleName} module: could not read export "${exportName}"`, { cause });
+    }
+    if (!isConstructor(candidate)) {
+        throw new TypeError(`Invalid ${moduleName} module: export "${exportName}" must be constructible`);
+    }
+    return candidate;
+}
+/** Validate the required method surface of a dynamically constructed value. */
+export function assertRequiredMethods(instance, moduleName, exportName, methodNames) {
+    for (const methodName of methodNames) {
+        let method;
+        try {
+            method = instance[methodName];
+        }
+        catch (cause) {
+            throw new TypeError(`Invalid ${moduleName} module: "${exportName}" instance could not expose method "${methodName}"`, { cause });
+        }
+        if (typeof method !== "function") {
+            throw new TypeError(`Invalid ${moduleName} module: "${exportName}" instance must implement method "${methodName}"`);
+        }
+    }
+}
+function assertRegistrationObject(value, registrationName) {
+    if (value === null ||
+        typeof value !== "object" ||
+        Array.isArray(value)) {
+        throw new TypeError(`Invalid ${registrationName} registration: expected an object`);
+    }
+}
+function readRegistrationProperty(value, registrationName, propertyName) {
+    assertRegistrationObject(value, registrationName);
+    try {
+        return value[propertyName];
+    }
+    catch (cause) {
+        throw new TypeError(`Invalid ${registrationName} registration: could not read "${propertyName}"`, { cause });
+    }
+}
+/** Capture a registry entry's identity exactly once. */
+export function captureRegistrationId(value, registrationName) {
+    const id = readRegistrationProperty(value, registrationName, "id");
+    assertCanonicalNonEmptyString(id, `Invalid ${registrationName} registration: "id"`);
+    return id;
+}
+/** Require a callable method on a registry entry. */
+export function assertRegistrationMethod(value, registrationName, methodName) {
+    const method = readRegistrationProperty(value, registrationName, methodName);
+    if (typeof method !== "function") {
+        throw new TypeError(`Invalid ${registrationName} registration: must implement method "${methodName}"`);
+    }
+}
+/** Validate an optional method when a registry entry supplies it. */
+export function assertOptionalRegistrationMethod(value, registrationName, methodName) {
+    const method = readRegistrationProperty(value, registrationName, methodName);
+    if (method !== undefined && typeof method !== "function") {
+        throw new TypeError(`Invalid ${registrationName} registration: optional method "${methodName}" must be a function when provided`);
+    }
+}

package/esm/src/observability/telemetry-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-error.d.ts","sourceRoot":"","sources":["../../../src/src/observability/telemetry-error.ts"],"names":[],"mappings":"AAiJA,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,GACtC,SAAS,CAAC;AAUd,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK9E;AAED,qDAAqD;AACrD,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,uBAAuB,GAC7B,uBAAuB,CAyBzB;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,CACzC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAAG,SAAS,EAC7D,UAAU,EAAE,CAAC,GAAG,CAAC,CAyClB;AA4JD;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAc9D;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAwB/D"}
+{"version":3,"file":"telemetry-error.d.ts","sourceRoot":"","sources":["../../../src/src/observability/telemetry-error.ts"],"names":[],"mappings":"AA8JA,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,GACtC,SAAS,CAAC;AAUd,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK9E;AAED,qDAAqD;AACrD,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,uBAAuB,GAC7B,uBAAuB,CAyBzB;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,CACzC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAAG,SAAS,EAC7D,UAAU,EAAE,CAAC,GAAG,CAAC,CAyClB;AA4JD;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAc9D;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAwB/D"}

package/esm/src/observability/telemetry-error.js

@@ -57,9 +57,21 @@ function readNativeErrorMessage(error) {
     return "";
 }
 function readNativeErrorStack(error) {
-    // Real runtime errors expose `stack` as an accessor, so the descriptor's
-    // value alone never carries one. The compat reader invokes the runtime's own
-    // getter behind a shadowed formatter and fails closed on foreign accessors.
+    if (readOwnErrorString(error, "message") === INVALID_ERROR_FIELD ||
+        readOwnErrorString(error, "name") === INVALID_ERROR_FIELD) {
+        return undefined;
+    }
+    try {
+        const descriptor = getOwnPropertyDescriptor(error, "stack");
+        if (descriptor && hasOwn(descriptor, "value")) {
+            return typeof descriptor.value === "string" ? descriptor.value : undefined;
+        }
+    }
+    catch (_) {
+        return undefined;
+    }
+    // Accessor-valued runtime stacks are delegated to the compat reader, which
+    // shadows the formatter and fails closed on foreign accessors.
     return readNativeErrorStackWithoutHooks(error);
 }
 function primitiveErrorMessage(error) {

package/esm/src/platform/compat/async-context.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Cross-runtime async context primitive.
+ *
+ * Node.js, Deno, and Bun expose the Node-compatible implementation. Browser
+ * bundles rewrite this builtin to Veryfront's no-op async-hooks polyfill.
+ */
+export { AsyncLocalStorage } from "node:async_hooks";
+//# sourceMappingURL=async-context.d.ts.map

package/esm/src/platform/compat/async-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-context.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/async-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/esm/src/platform/compat/async-context.js

@@ -0,0 +1,7 @@
+/**
+ * Cross-runtime async context primitive.
+ *
+ * Node.js, Deno, and Bun expose the Node-compatible implementation. Browser
+ * bundles rewrite this builtin to Veryfront's no-op async-hooks polyfill.
+ */
+export { AsyncLocalStorage } from "node:async_hooks";

package/esm/src/platform/compat/std/front-matter-yaml.js

@@ -3,7 +3,7 @@
  *
  * @module
  */
-import { parse } from "../../../../deps/jsr.io/@std/yaml/1.1.0/parse.js";
+import { parse } from "./yaml.js";
 const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)(?:\r?\n)?---(?:\r?\n|$)([\s\S]*)$/;
 function extractUnknown(text) {
     const match = text.match(FRONTMATTER_RE);

package/esm/src/platform/compat/std/yaml.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Portable `@std/yaml/parse` shim.
+ *
+ * `jsr:@std/yaml` only resolves under Deno, so importing it from core made
+ * every Node and Bun test that transitively touched YAML unresolvable. A
+ * third-party parser cannot move into core either. Core may depend on the
+ * Deno standard library and nothing else. So core keeps the call sites and the
+ * `YamlParserProvider` contract, and the first-party `ext-yaml` extension
+ * keeps the parser.
+ *
+ * @module platform/compat/std/yaml
+ */
+import { type YamlParseOptions } from "../../../extensions/parser/yaml-parser.js";
+/** Decode one YAML document. */
+export declare function parse(source: string, options?: YamlParseOptions): unknown;
+export type { YamlParseOptions };
+//# sourceMappingURL=yaml.d.ts.map

package/esm/src/platform/compat/std/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/std/yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,2CAA2C,CAAC;AAsBnD,gCAAgC;AAChC,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAEzE;AAED,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/esm/src/platform/compat/std/yaml.js

@@ -0,0 +1,39 @@
+/**
+ * Portable `@std/yaml/parse` shim.
+ *
+ * `jsr:@std/yaml` only resolves under Deno, so importing it from core made
+ * every Node and Bun test that transitively touched YAML unresolvable. A
+ * third-party parser cannot move into core either. Core may depend on the
+ * Deno standard library and nothing else. So core keeps the call sites and the
+ * `YamlParserProvider` contract, and the first-party `ext-yaml` extension
+ * keeps the parser.
+ *
+ * @module platform/compat/std/yaml
+ */
+import { resolve, tryResolve } from "../../../extensions/contracts.js";
+import { loadDefaultYamlParserProvider } from "../../../extensions/parser/yaml-defaults.js";
+import { YamlParserProviderName, } from "../../../extensions/parser/yaml-parser.js";
+/**
+ * Every framework call site for this module is synchronous. Front matter
+ * extraction runs inside synchronous render and build paths, so the
+ * extension-owned parser must be available before `parse` is first callable.
+ * Top-level await is the same mechanism `src/agent/runtime/skill-metadata.ts`
+ * uses to load this extension's Skill parser for its own synchronous callers.
+ */
+const defaultProvider = await loadDefaultYamlParserProvider();
+function requireProvider() {
+    // Extension orchestration owns the binding when an app configured one; the
+    // product distribution's default only fills the gap.
+    const registered = tryResolve(YamlParserProviderName);
+    if (registered !== undefined)
+        return registered;
+    if (defaultProvider !== undefined)
+        return defaultProvider;
+    // Raises the registry's missing-extension error, whose detail names the
+    // package to install. Never a bare throw.
+    return resolve(YamlParserProviderName);
+}
+/** Decode one YAML document. */
+export function parse(source, options) {
+    return requireProvider().parseYaml(source, options);
+}

package/esm/src/utils/constants/http.d.ts

@@ -1,7 +1,13 @@
 export { MS_PER_MINUTE, MS_PER_SECOND, SECONDS_PER_MINUTE } from "./cache.js";
 export declare const KB_IN_BYTES = 1024;
-/** Shared HTTP module fetch timeout ms value. */
-export declare const HTTP_MODULE_FETCH_TIMEOUT_MS = 2500;
+/** HTTP module fetch timeout, including cold upstream module generation. */
+export declare const HTTP_MODULE_FETCH_TIMEOUT_MS = 10000;
+/** Maximum attempts for one HTTP module fetch. */
+export declare const HTTP_MODULE_FETCH_MAX_ATTEMPTS = 3;
+/** Linear backoff base between HTTP module fetch attempts. */
+export declare const HTTP_MODULE_FETCH_RETRY_DELAY_MS = 100;
+/** Maximum time consumed by all HTTP module fetch attempts and backoffs. */
+export declare const HTTP_MODULE_FETCH_RETRY_BUDGET_MS: number;
 export declare const HTTP_FETCH_TIMEOUT_MS = 30000; /** Default timeout for HTTP module/bundle fetch operations (30 seconds) */
 export declare const HMR_RECONNECT_DELAY_MS = 1000;
 export declare const HMR_RELOAD_DELAY_MS = 1000;

package/esm/src/utils/constants/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/constants/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9E,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC,iDAAiD;AACjD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,qBAAqB,QAC3B,CAAC,CAAC,2EAA2E;AAEpF,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAEhD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,eAAO,MAAM,kCAAkC,QAAQ,CAAC;AAExD,4CAA4C;AAC5C,eAAO,MAAM,uBAAuB,QAAoB,CAAC;AACzD,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AACjD,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,4BAA4B;AAC5B,eAAO,MAAM,OAAO,MAAM,CAAC;AAC3B,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,qCAAqC;AACrC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,mCAAmC;AACnC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,oCAAoC,MAAM,CAAC;AAExD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,MAA6B,CAAC;AAC5D,yCAAyC;AACzC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,qCAAqC;AACrC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,iDAAiD;AACjD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,4CAA4C;AAC5C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,iDAAiD;AACjD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,iDAAiD;AACjD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,uCAAuC;AACvC,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAEX,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,cAAc,CAAC;AACvD,iDAAiD;AACjD,eAAO,MAAM,4BAA4B,eAAe,CAAC;AACzD,iDAAiD;AACjD,eAAO,MAAM,4BAA4B,eAAe,CAAC;AACzD,eAAO,MAAM,4BAA4B,eAAe,CAAC;AACzD,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAC3D,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,cAAc,CAAC;AACvD,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,iBAAiB,CAAC"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/constants/http.ts"],"names":[],"mappings":"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"}

package/esm/src/utils/constants/http.js

@@ -1,7 +1,15 @@
 export { MS_PER_MINUTE, MS_PER_SECOND, SECONDS_PER_MINUTE } from "./cache.js";
 export const KB_IN_BYTES = 1024;
-/** Shared HTTP module fetch timeout ms value. */
-export const HTTP_MODULE_FETCH_TIMEOUT_MS = 2500;
+/** HTTP module fetch timeout, including cold upstream module generation. */
+export const HTTP_MODULE_FETCH_TIMEOUT_MS = 10_000;
+/** Maximum attempts for one HTTP module fetch. */
+export const HTTP_MODULE_FETCH_MAX_ATTEMPTS = 3;
+/** Linear backoff base between HTTP module fetch attempts. */
+export const HTTP_MODULE_FETCH_RETRY_DELAY_MS = 100;
+/** Maximum time consumed by all HTTP module fetch attempts and backoffs. */
+export const HTTP_MODULE_FETCH_RETRY_BUDGET_MS = HTTP_MODULE_FETCH_TIMEOUT_MS * HTTP_MODULE_FETCH_MAX_ATTEMPTS +
+    HTTP_MODULE_FETCH_RETRY_DELAY_MS *
+        ((HTTP_MODULE_FETCH_MAX_ATTEMPTS - 1) * HTTP_MODULE_FETCH_MAX_ATTEMPTS / 2);
 export const HTTP_FETCH_TIMEOUT_MS = 30000; /** Default timeout for HTTP module/bundle fetch operations (30 seconds) */
 export const HMR_RECONNECT_DELAY_MS = 1000;
 export const HMR_RELOAD_DELAY_MS = 1000;

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.1226";
+export declare const VERSION = "0.1.1228";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.1226";
+export const VERSION = "0.1.1228";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veryfront/ext-content-mdx",
-  "version": "0.1.1226",
+  "version": "0.1.1228",
   "description": "Veryfront first-party extension package for ext-content-mdx",
   "keywords": [
     "veryfront",
@@ -67,7 +67,7 @@
     "vfile": "6.0.3"
   },
   "peerDependencies": {
-    "veryfront": "^0.1.1226"
+    "veryfront": "^0.1.1228"
   },
   "type": "module",
   "types": "./esm/extensions/ext-content-mdx/src/index.d.ts",

package/esm/deps/jsr.io/@std/yaml/1.1.0/_chars.d.ts

@@ -1,33 +0,0 @@
-export declare const BOM = 65279;
-export declare const TAB = 9;
-export declare const LINE_FEED = 10;
-export declare const CARRIAGE_RETURN = 13;
-export declare const SPACE = 32;
-export declare const EXCLAMATION = 33;
-export declare const DOUBLE_QUOTE = 34;
-export declare const SHARP = 35;
-export declare const PERCENT = 37;
-export declare const AMPERSAND = 38;
-export declare const SINGLE_QUOTE = 39;
-export declare const ASTERISK = 42;
-export declare const PLUS = 43;
-export declare const COMMA = 44;
-export declare const MINUS = 45;
-export declare const DOT = 46;
-export declare const COLON = 58;
-export declare const SMALLER_THAN = 60;
-export declare const GREATER_THAN = 62;
-export declare const QUESTION = 63;
-export declare const COMMERCIAL_AT = 64;
-export declare const LEFT_SQUARE_BRACKET = 91;
-export declare const BACKSLASH = 92;
-export declare const RIGHT_SQUARE_BRACKET = 93;
-export declare const GRAVE_ACCENT = 96;
-export declare const LEFT_CURLY_BRACKET = 123;
-export declare const VERTICAL_LINE = 124;
-export declare const RIGHT_CURLY_BRACKET = 125;
-export declare function isEOL(c: number): boolean;
-export declare function isWhiteSpace(c: number): boolean;
-export declare function isWhiteSpaceOrEOL(c: number): boolean;
-export declare function isFlowIndicator(c: number): boolean;
-//# sourceMappingURL=_chars.d.ts.map

package/esm/deps/jsr.io/@std/yaml/1.1.0/_chars.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_chars.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/yaml/1.1.0/_chars.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,GAAG,QAAS,CAAC;AAC1B,eAAO,MAAM,GAAG,IAAO,CAAC;AACxB,eAAO,MAAM,SAAS,KAAO,CAAC;AAC9B,eAAO,MAAM,eAAe,KAAO,CAAC;AACpC,eAAO,MAAM,KAAK,KAAO,CAAC;AAC1B,eAAO,MAAM,WAAW,KAAO,CAAC;AAChC,eAAO,MAAM,YAAY,KAAO,CAAC;AACjC,eAAO,MAAM,KAAK,KAAO,CAAC;AAC1B,eAAO,MAAM,OAAO,KAAO,CAAC;AAC5B,eAAO,MAAM,SAAS,KAAO,CAAC;AAC9B,eAAO,MAAM,YAAY,KAAO,CAAC;AACjC,eAAO,MAAM,QAAQ,KAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,KAAO,CAAC;AACzB,eAAO,MAAM,KAAK,KAAO,CAAC;AAC1B,eAAO,MAAM,KAAK,KAAO,CAAC;AAC1B,eAAO,MAAM,GAAG,KAAO,CAAC;AACxB,eAAO,MAAM,KAAK,KAAO,CAAC;AAC1B,eAAO,MAAM,YAAY,KAAO,CAAC;AACjC,eAAO,MAAM,YAAY,KAAO,CAAC;AACjC,eAAO,MAAM,QAAQ,KAAO,CAAC;AAC7B,eAAO,MAAM,aAAa,KAAO,CAAC;AAClC,eAAO,MAAM,mBAAmB,KAAO,CAAC;AACxC,eAAO,MAAM,SAAS,KAAO,CAAC;AAC9B,eAAO,MAAM,oBAAoB,KAAO,CAAC;AACzC,eAAO,MAAM,YAAY,KAAO,CAAC;AACjC,eAAO,MAAM,kBAAkB,MAAO,CAAC;AACvC,eAAO,MAAM,aAAa,MAAO,CAAC;AAClC,eAAO,MAAM,mBAAmB,MAAO,CAAC;AAExC,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAExC;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAQlD"}

package/esm/deps/jsr.io/@std/yaml/1.1.0/_chars.js

@@ -1,48 +0,0 @@
-// Ported from js-yaml v3.13.1:
-// https://github.com/nodeca/js-yaml/commit/665aadda42349dcae869f12040d9b10ef18d12da
-// Copyright 2011-2015 by Vitaly Puzrin. All rights reserved. MIT license.
-// Copyright 2018-2026 the Deno authors. MIT license.
-export const BOM = 0xfeff; /* BOM */
-export const TAB = 0x09; /* Tab */
-export const LINE_FEED = 0x0a; /* LF */
-export const CARRIAGE_RETURN = 0x0d; /* CR */
-export const SPACE = 0x20; /* Space */
-export const EXCLAMATION = 0x21; /* ! */
-export const DOUBLE_QUOTE = 0x22; /* " */
-export const SHARP = 0x23; /* # */
-export const PERCENT = 0x25; /* % */
-export const AMPERSAND = 0x26; /* & */
-export const SINGLE_QUOTE = 0x27; /* ' */
-export const ASTERISK = 0x2a; /* * */
-export const PLUS = 0x2b; /* + */
-export const COMMA = 0x2c; /* , */
-export const MINUS = 0x2d; /* - */
-export const DOT = 0x2e; /* . */
-export const COLON = 0x3a; /* : */
-export const SMALLER_THAN = 0x3c; /* < */
-export const GREATER_THAN = 0x3e; /* > */
-export const QUESTION = 0x3f; /* ? */
-export const COMMERCIAL_AT = 0x40; /* @ */
-export const LEFT_SQUARE_BRACKET = 0x5b; /* [ */
-export const BACKSLASH = 0x5c; /* \ */
-export const RIGHT_SQUARE_BRACKET = 0x5d; /* ] */
-export const GRAVE_ACCENT = 0x60; /* ` */
-export const LEFT_CURLY_BRACKET = 0x7b; /* { */
-export const VERTICAL_LINE = 0x7c; /* | */
-export const RIGHT_CURLY_BRACKET = 0x7d; /* } */
-export function isEOL(c) {
-    return c === LINE_FEED || c === CARRIAGE_RETURN;
-}
-export function isWhiteSpace(c) {
-    return c === TAB || c === SPACE;
-}
-export function isWhiteSpaceOrEOL(c) {
-    return isWhiteSpace(c) || isEOL(c);
-}
-export function isFlowIndicator(c) {
-    return (c === COMMA ||
-        c === LEFT_SQUARE_BRACKET ||
-        c === RIGHT_SQUARE_BRACKET ||
-        c === LEFT_CURLY_BRACKET ||
-        c === RIGHT_CURLY_BRACKET);
-}