@b4moss/hyogen-md 0.12.0 → 0.13.0

package/dist/component/ComponentRegistry.d.ts

@@ -0,0 +1,11 @@
+export type ComponentRegistration = {
+    alias: string;
+    componentPath: string;
+    definedAt?: string;
+};
+export declare class ComponentRegistry {
+    private readonly components;
+    register(entry: ComponentRegistration, contextKeys: string[], path?: string): void;
+    get(alias: string): ComponentRegistration | undefined;
+    has(alias: string): boolean;
+}

package/dist/component/parsePropsContract.d.ts

@@ -0,0 +1,10 @@
+import { HyogenContext } from '../types.js';
+export type PropType = "string" | "number" | "boolean" | "object" | "array";
+export type PropContract = {
+    type?: PropType;
+    isRequired?: boolean;
+    default?: unknown;
+};
+export declare function parsePropsContract(fmContext: HyogenContext, path?: string): Record<string, PropContract>;
+export declare function inferPropType(value: unknown): PropType | undefined;
+export declare function matchesPropType(value: unknown, expected: PropType): boolean;

package/dist/component/renderComponent.d.ts

@@ -0,0 +1,17 @@
+import { ComponentRegistry } from './ComponentRegistry.js';
+import { HyogenContext, HyogenWarning, Loader } from '../types.js';
+import { VisitStack } from '../include/VisitStack.js';
+export type RenderComponentOptions = {
+    alias: string;
+    props: Record<string, unknown>;
+    parentContext: HyogenContext;
+    registry: ComponentRegistry;
+    loader: Loader;
+    rootDir?: string;
+    path?: string;
+    warnings: HyogenWarning[];
+    visitStack: VisitStack;
+    preserveHgComments?: boolean;
+    constrainToRoot?: boolean;
+};
+export declare function renderComponent(options: RenderComponentOptions): Promise<string>;

package/dist/component/validateProps.d.ts

@@ -0,0 +1,7 @@
+import { HyogenWarning } from '../types.js';
+import { PropContract } from './parsePropsContract.js';
+export type ValidatePropsResult = {
+    values: Record<string, unknown>;
+    warnings: HyogenWarning[];
+};
+export declare function validateProps(callProps: Record<string, unknown>, contract: Record<string, PropContract>, componentAlias: string): ValidatePropsResult;

package/dist/config/defineConfig.d.ts

@@ -0,0 +1,5 @@
+import { HyogenConfig } from './types.js';
+/**
+ * Identity helper for typed `hyogen.config.*` default exports (Vite-style).
+ */
+export declare function defineConfig(config: HyogenConfig): HyogenConfig;

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export { defineConfig } from './defineConfig.js';
+export { loadConfig, resolveConfigPath } from './loadConfig.js';
+export type { HyogenConfig, ResolvedHyogenConfig, } from './types.js';

package/dist/config/index.js

@@ -0,0 +1,143 @@
+import { access as s } from "node:fs/promises";
+import i from "node:path";
+import { pathToFileURL as g } from "node:url";
+import { createJiti as h } from "jiti";
+import { c as n } from "../createError-WZmAl05N.js";
+function D(t) {
+  return t;
+}
+const l = [
+  "hyogen.config.ts",
+  "hyogen.config.mjs",
+  "hyogen.config.js",
+  "hyogen.config.cjs"
+];
+function f(t) {
+  return typeof t == "object" && t !== null && !Array.isArray(t);
+}
+function d(t) {
+  if (typeof t == "string") {
+    if (t.trim() === "")
+      throw n({
+        code: "parse_error",
+        path: "<config>",
+        details: {
+          path: "<config>",
+          message: "`input` must not be empty"
+        }
+      });
+    return;
+  }
+  if (Array.isArray(t) && t.every((r) => typeof r == "string")) {
+    if (t.length === 0 || t.some((r) => r.trim() === ""))
+      throw n({
+        code: "parse_error",
+        path: "<config>",
+        details: {
+          path: "<config>",
+          message: "`input` array is invalid"
+        }
+      });
+    return;
+  }
+  throw n({
+    code: "parse_error",
+    path: "<config>",
+    details: {
+      path: "<config>",
+      message: "`input` is required as a string or string[]"
+    }
+  });
+}
+async function m(t = {}) {
+  const r = i.resolve(t.cwd ?? process.cwd());
+  if (t.configFile) {
+    const o = i.isAbsolute(t.configFile) ? t.configFile : i.resolve(r, t.configFile);
+    try {
+      return await s(o), o;
+    } catch {
+      throw n({
+        code: "file_not_found",
+        path: o,
+        details: {
+          path: o,
+          from: r,
+          via: "config"
+        }
+      });
+    }
+  }
+  for (const o of l) {
+    const e = i.join(r, o);
+    try {
+      return await s(e), e;
+    } catch {
+    }
+  }
+  throw n({
+    code: "file_not_found",
+    path: r,
+    details: {
+      path: i.join(r, "hyogen.config.*"),
+      from: r,
+      via: "config"
+    }
+  });
+}
+async function y(t) {
+  const r = h(import.meta.url, {
+    interopDefault: !0
+  });
+  try {
+    return await r.import(t);
+  } catch (o) {
+    try {
+      return await import(g(t).href);
+    } catch {
+      const e = o instanceof Error ? o.message : String(o);
+      throw n({
+        code: "load_failed",
+        path: t,
+        details: { path: t, reason: e }
+      });
+    }
+  }
+}
+function w(t) {
+  return f(t) && "default" in t ? t.default : t;
+}
+function c(t, r) {
+  if (t !== void 0)
+    return i.isAbsolute(t) ? t : i.resolve(r, t);
+}
+function _(t, r) {
+  return typeof t == "string" ? c(t, r) : t.map((o) => c(o, r));
+}
+async function F(t = {}) {
+  const r = await m(t), o = i.dirname(r), e = w(await y(r));
+  if (!f(e))
+    throw n({
+      code: "parse_error",
+      path: r,
+      details: {
+        path: r,
+        message: "config must default-export an object"
+      }
+    });
+  d(e.input);
+  const a = e, u = c(a.outDir ?? "./out", o), p = c(a.root, o);
+  return {
+    ...a,
+    input: _(a.input, o),
+    outDir: u,
+    root: p,
+    configDir: o,
+    configPath: r
+  };
+}
+export {
+  D as defineConfig,
+  F as loadConfig,
+  m as resolveConfigPath
+};
+//# sourceMappingURL=index.js.map

package/dist/config/loadConfig.d.ts

@@ -0,0 +1,13 @@
+import { ResolvedHyogenConfig } from './types.js';
+export type LoadConfigOptions = {
+    /** Directory to search for config. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Explicit config file path (absolute or cwd-relative). */
+    configFile?: string;
+};
+export declare function resolveConfigPath(options?: LoadConfigOptions): Promise<string>;
+/**
+ * Load and normalize `hyogen.config.*`.
+ * Ensures `outDir` defaults to `./out` (resolved against the config directory).
+ */
+export declare function loadConfig(options?: LoadConfigOptions): Promise<ResolvedHyogenConfig>;

package/dist/config/types.d.ts

@@ -0,0 +1,26 @@
+import { DataSourcesMap, HyogenContext } from '../types.js';
+/**
+ * User-facing config for `hyogen.config.(js|ts)`.
+ * Maps onto library `build()` / `renderServer()` options.
+ */
+export type HyogenConfig = {
+    /** Entry markdown path(s) or glob(s). Required. */
+    input: string | string[];
+    /** Build output directory. Defaults to `./out`. Unused by `dev`. */
+    outDir?: string;
+    context?: HyogenContext;
+    serverContext?: HyogenContext;
+    dataSources?: DataSourcesMap;
+    root?: string;
+    includeUnderscoreEntries?: boolean;
+    preserveFrontMatter?: boolean;
+    preserveHgComments?: boolean;
+};
+export type ResolvedHyogenConfig = Omit<HyogenConfig, "outDir" | "input"> & {
+    input: string | string[];
+    outDir: string;
+    /** Absolute directory containing the config file. */
+    configDir: string;
+    /** Absolute path to the config file when loaded from disk. */
+    configPath?: string;
+};

package/dist/context/mergeContext.d.ts

@@ -0,0 +1,3 @@
+import { HyogenContext } from '../types.js';
+/** Shallow merge; later objects win. Skips null/undefined arguments. */
+export declare function mergeContext(...sources: (HyogenContext | null | undefined)[]): HyogenContext;

package/dist/control/StructureNestTracker.d.ts

@@ -0,0 +1,14 @@
+export declare const STRUCTURE_NEST_LIMIT = 20;
+export type NestEnterResult = {
+    exceeded: false;
+    depth: number;
+} | {
+    exceeded: true;
+    limit: number;
+};
+export declare class StructureNestTracker {
+    private depth;
+    get currentDepth(): number;
+    enter(): NestEnterResult;
+    exit(): void;
+}

package/dist/control/expandControlStructures.d.ts

@@ -0,0 +1,3 @@
+import { EvaluateExpressionOptions } from '../types.js';
+export declare function expandControlStructures(source: string, options: EvaluateExpressionOptions): Promise<string>;
+export declare function expandControlStructuresOrThrow(source: string, options: EvaluateExpressionOptions): Promise<string>;

package/dist/control/parseControlOpener.d.ts

@@ -0,0 +1,2 @@
+import { ControlOpener } from '../types.js';
+export declare function parseControlOpener(source: string, path?: string): ControlOpener | null;

package/dist/control/parseControlStructures.d.ts

@@ -0,0 +1,2 @@
+import { ControlNode } from '../types.js';
+export declare function parseControlStructures(source: string, path?: string): ControlNode[];

package/dist/createError-WZmAl05N.js

@@ -0,0 +1,30 @@
+const s = { file_not_found: "File not found: {path} (referenced from {from} via {via})", frontmatter_too_large: "Front matter exceeds size limit in {path} ({size} bytes, limit {limit})", duplicate_component_alias: 'Duplicate component alias "{alias}" in {path}', alias_collision: 'Component alias "{alias}" collides with an existing binding in {path}', forbidden_property_access: 'Forbidden property access "{property}" in {path}', parse_error: "Parse error in {path}: {message}", server_context_on_client: "serverContext is not allowed with renderClient", load_failed: "Failed to load {path}: {reason}", data_sources_on_client: "dataSources is not allowed with renderClient", data_source_too_large: "Data source exceeds size limit in {path} ({size} bytes, limit {limit})" }, c = { circular_include: "Circular reference detected; skipped {path} (referenced from {from} via {via})", nest_limit_exceeded: "Nesting limit exceeded ({limit}); skipped block in {path}", extend_in_component: "extend is not allowed inside a component; skipped in {path}", prop_type_mismatch: 'Prop "{prop}" type mismatch in component "{component}"; expected {expected}, got {actual}', prop_missing: 'Required prop "{prop}" is missing for component "{component}"', prop_unknown: 'Unknown prop "{prop}" passed to component "{component}"; ignored', suspicious_context_value: 'Suspicious value in context key "{key}" ({reason})' }, p = { contains_html_script_tag: "contains HTML script tag", contains_event_handler: "contains inline event handler", contains_dangerous_scheme: "contains dangerous URL scheme", contains_embed_tag: "contains embeddable HTML tag", contains_meta_refresh: "contains meta refresh" }, a = {
+  errors: s,
+  warnings: c,
+  warningReasons: p
+}, l = a.errors, d = a.warnings;
+function i(e, n) {
+  return e === void 0 ? "" : e.replace(/\{([^}]+)\}/g, (t, r) => {
+    if (n === void 0 || !(r in n))
+      return t;
+    const o = n[r];
+    return o == null ? "" : String(o);
+  });
+}
+function m(e, n) {
+  return i(l[e], n);
+}
+function _(e, n) {
+  return i(d[e], n);
+}
+function u(e) {
+  const n = e.message ?? m(e.code, e.details), t = new Error(n);
+  return t.name = "HyogenError", t.code = e.code, t.message = n, t.path = e.path, t.details = e.details, t;
+}
+export {
+  m as a,
+  u as c,
+  _ as f,
+  a as m
+};
+//# sourceMappingURL=createError-WZmAl05N.js.map

package/dist/errors/createError.d.ts

@@ -0,0 +1,7 @@
+import { HyogenError } from '../types.js';
+export declare function createHyogenError(options: {
+    code: string;
+    message?: string;
+    path?: string;
+    details?: Record<string, unknown>;
+}): HyogenError;

package/dist/errors/formatDiagnosticLog.d.ts

@@ -0,0 +1,6 @@
+import { HyogenDiagnostic } from '../types.js';
+/**
+ * Formats a diagnostic as multi-line log text (api.md).
+ * Does not write to console — callers decide how to output.
+ */
+export declare function formatDiagnosticLog(kind: "error" | "warning", diagnostic: HyogenDiagnostic): string;

package/dist/errors/formatMessage.d.ts

@@ -0,0 +1,3 @@
+/** Unknown codes resolve to empty string (implementation choice for v0.1). */
+export declare function formatMessage(code: string, details?: Record<string, unknown>): string;
+export declare function formatWarningMessage(code: string, details?: Record<string, unknown>): string;

package/dist/expr/evaluateExpression.d.ts

@@ -0,0 +1,4 @@
+import { ExprNode, EvaluateExpressionOptions, HyogenContext } from '../types.js';
+export declare function evaluateExpression(node: ExprNode, options: EvaluateExpressionOptions): Promise<unknown>;
+/** @deprecated Use evaluateExpression with options object. */
+export declare function evaluateExpressionAsync(node: ExprNode, context: HyogenContext, options?: Omit<EvaluateExpressionOptions, "context">): Promise<unknown>;

package/dist/expr/interpolateExpressions.d.ts

@@ -0,0 +1,4 @@
+import { InterpolateExpressionsOptions } from '../types.js';
+export declare function interpolateExpressions(source: string, context: InterpolateExpressionsOptions["context"], options?: Omit<InterpolateExpressionsOptions, "context"> & {
+    path?: string;
+}): Promise<string>;

package/dist/expr/parseExpression.d.ts

@@ -0,0 +1,4 @@
+import { ExprNode } from '../types.js';
+export declare function parseExpression(source: string, path?: string, options?: {
+    allowCalls?: boolean;
+}): ExprNode;

package/dist/frontmatter/parseFrontMatter.d.ts

@@ -0,0 +1,3 @@
+import { ParseFrontMatterResult } from '../types.js';
+export declare const FRONTMATTER_SIZE_LIMIT: number;
+export declare function parseFrontMatter(source: string, path?: string): ParseFrontMatterResult;

package/dist/include/VisitStack.d.ts

@@ -0,0 +1,13 @@
+export type CircularIncludeResult = {
+    circular: false;
+} | {
+    circular: true;
+    path: string;
+    from: string;
+};
+export declare class VisitStack {
+    private readonly stack;
+    check(visitPath: string): CircularIncludeResult;
+    push(visitPath: string): void;
+    pop(): void;
+}

package/dist/include/expandIncludes.d.ts

@@ -0,0 +1,18 @@
+import { ComponentRegistry } from '../component/ComponentRegistry.js';
+import { VisitStack } from './VisitStack.js';
+import { HyogenContext, HyogenWarning, IncludeDirective, Loader } from '../types.js';
+export type ExpandIncludesOptions = {
+    source: string;
+    directives: IncludeDirective[];
+    context: HyogenContext;
+    loader: Loader;
+    root?: string;
+    path?: string;
+    preserveFrontMatter?: boolean;
+    preserveHgComments?: boolean;
+    visitStack?: VisitStack;
+    warnings?: HyogenWarning[];
+    registry?: ComponentRegistry;
+    constrainToRoot?: boolean;
+};
+export declare function expandIncludes(options: ExpandIncludesOptions): Promise<string>;

package/dist/index.d.ts

@@ -1,113 +1,11 @@
-export declare function build(options: BuildOptions): Promise<BuildResult>;
-
-export declare type BuildOptions = RenderOptions & {
-    input: string | string[];
-    outDir: string;
-    includeUnderscoreEntries?: boolean;
-    context?: HyogenContext;
-    serverContext?: HyogenContext;
-    dataSources?: DataSourcesMap;
-};
-
-export declare type BuildResult = {
-    files: {
-        path: string;
-        markdown: string;
-    }[];
-    warnings: HyogenWarning[];
-};
-
-declare type ClientRenderOptions = RenderOptions & {
-    /** Rejected on client — use renderServer/build instead */
-    serverContext?: HyogenContext;
-    /** Rejected on client — use renderServer/build instead */
-    dataSources?: DataSourcesMap;
-};
-
-export declare function createFsLoader(options?: FsLoaderOptions): Loader;
-
-export declare function createHyogenError(options: {
-    code: string;
-    message?: string;
-    path?: string;
-    details?: Record<string, unknown>;
-}): HyogenError;
-
-export declare function createNodeLoader(options?: NodeLoaderOptions): Loader;
-
-export declare type DataSourcesMap = Record<string, string>;
-
-/**
- * Formats a diagnostic as multi-line log text (api.md).
- * Does not write to console — callers decide how to output.
- */
-export declare function formatDiagnosticLog(kind: "error" | "warning", diagnostic: HyogenDiagnostic): string;
-
-/** Unknown codes resolve to empty string (implementation choice for v0.1). */
-export declare function formatMessage(code: string, details?: Record<string, unknown>): string;
-
-declare type FsLoaderOptions = {
-    from?: string;
-    via?: "include" | "component" | "extend";
-};
-
-export declare type HyogenContext = Record<string, unknown>;
-
-export declare type HyogenDiagnostic = {
-    code: string;
-    message: string;
-    path?: string;
-    details?: Record<string, unknown>;
-};
-
-export declare type HyogenError = Error & HyogenDiagnostic;
-
-export declare type HyogenWarning = HyogenDiagnostic;
-
-/** Returns true when path is an http(s) URL. */
-export declare function isRemotePath(path: string): boolean;
-
-export declare function loadDataSources(sources: DataSourcesMap, options?: LoadDataSourcesOptions): Promise<HyogenContext>;
-
-declare type LoadDataSourcesOptions = {
-    root?: string;
-    loader?: Loader;
-};
-
-export declare type Loader = (path: string) => Promise<string>;
-
-declare type NodeLoaderOptions = FsLoaderOptions;
-
-/**
- * Client-side render entry. Requires an injected loader; never uses
- * createNodeLoader / resolveRenderInput (no FS or network in the library).
- */
-export declare function renderClient(input: string | {
-    path: string;
-}, context?: HyogenContext, options?: ClientRenderOptions): Promise<RenderResult>;
-
-export declare type RenderOptions = {
-    preserveFrontMatter?: boolean;
-    preserveHgComments?: boolean;
-    loader?: Loader;
-    root?: string;
-    path?: string;
-    constrainToRoot?: boolean;
-};
-
-export declare type RenderResult = {
-    markdown: string;
-    warnings: HyogenWarning[];
-};
-
-export declare function renderServer(input: string | {
-    path: string;
-}, context?: HyogenContext, options?: ServerRenderOptions): Promise<RenderResult>;
-
-export declare type ServerRenderOptions = RenderOptions & {
-    serverContext?: HyogenContext;
-    /** Variable name → root-relative data file path (YAML / JSON / CSV). */
-    dataSources?: DataSourcesMap;
-};
-
-export { }
+export { renderServer } from './renderServer.js';
+export { renderClient } from './renderClient.js';
+export { build } from './build/build.js';
+export { createFsLoader } from './io/createFsLoader.js';
+export { createNodeLoader } from './io/createNodeLoader.js';
+export { loadDataSources } from './io/loadDataSources.js';
+export { isRemotePath } from './io/isRemotePath.js';
+export { createHyogenError } from './errors/createError.js';
+export { formatMessage } from './errors/formatMessage.js';
+export { formatDiagnosticLog } from './errors/formatDiagnosticLog.js';
+export type { HyogenContext, HyogenDiagnostic, HyogenError, HyogenWarning, Loader, DataSourcesMap, RenderOptions, RenderResult, ServerRenderOptions, BuildOptions, BuildResult, } from './types.js';