@dogsbay/minja 0.2.0-beta.100

package/dist/types.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Type definitions for minja template engine
+ */
+export type ASTNode = TextNode | VariableNode | SetNode | IfNode | IncludeNode | CommentNode | SwitchNode | LeveloffsetNode;
+export interface TextNode {
+    type: 'text';
+    value: string;
+}
+export interface VariableNode {
+    type: 'variable';
+    name: string;
+}
+export interface SetNode {
+    type: 'set';
+    name: string;
+    value: Expression;
+}
+export interface IfNode {
+    type: 'if';
+    condition: Expression;
+    trueBranch: ASTNode[];
+    elifBranches?: Array<{
+        condition: Expression;
+        body: ASTNode[];
+    }>;
+    elseBranch?: ASTNode[];
+}
+export interface IncludeNode {
+    type: 'include';
+    path: string;
+}
+export interface CommentNode {
+    type: 'comment';
+    value: string;
+}
+export interface SwitchNode {
+    type: 'switch';
+    expression: Expression;
+    cases: Array<{
+        value: Expression;
+        body: ASTNode[];
+    }>;
+}
+export interface LeveloffsetNode {
+    type: 'leveloffset';
+    offset: number;
+    isRelative: boolean;
+    body: ASTNode[];
+}
+export type Expression = LiteralExpression | VariableExpression | BinaryExpression | UnaryExpression;
+export interface LiteralExpression {
+    type: 'literal';
+    value: string | number | boolean | null;
+}
+export interface VariableExpression {
+    type: 'variable';
+    name: string;
+}
+export interface BinaryExpression {
+    type: 'binary';
+    operator: '==' | '!=' | '<' | '>' | '<=' | '>=' | 'and' | 'or';
+    left: Expression;
+    right: Expression;
+}
+export interface UnaryExpression {
+    type: 'unary';
+    operator: 'not';
+    operand: Expression;
+}
+export interface Loader {
+    /**
+     * Load a file from the given path.
+     * @param path - The path to load (can be relative or absolute)
+     * @param basePath - The base path to resolve relative paths against
+     * @returns The file contents as a string
+     */
+    load(path: string, basePath?: string): Promise<string>;
+}
+export interface RenderOptions {
+    /**
+     * File loader for {% include %} statements
+     */
+    loader?: Loader;
+    /**
+     * Initial context (variables)
+     */
+    context?: Record<string, unknown>;
+    /**
+     * Base path for resolving relative includes (e.g., current file URL)
+     */
+    basePath?: string;
+    /**
+     * Maximum include depth (default: 10)
+     */
+    maxIncludeDepth?: number;
+    /**
+     * Timeout in milliseconds (default: 5000)
+     */
+    timeout?: number;
+    /**
+     * Convert hyphenated variable names to underscores during lookup.
+     * When true, {{ my-var }} will look up 'my_var' in the context.
+     * (default: false)
+     */
+    hyphenToUnderscore?: boolean;
+    /**
+     * What to do when a `{{ var }}` references an identifier that
+     * isn't in the context.
+     *
+     * - `'empty'` (default) — emit an empty string. Unchanged behaviour
+     *   for existing callers; matches the standard Nunjucks default.
+     * - `'throw'` — throw `Error('Undefined variable: <name>')`. Useful
+     *   in strict pipelines that want to fail-fast on typos.
+     * - `'preserve'` — emit the literal `{{ <name> }}` (or `{% if … %}…`
+     *   for conditionals whose condition references undefined vars).
+     *   Used by the AsciiDoc convert pipeline so unresolved attributes
+     *   survive into the post-render artifact for downstream resolution.
+     *   See plans/format-asciidoc-import.md.
+     * - `'asciidoc-literal'` — emit the single-brace `{<name>}` form:
+     *   what asciidoctor renders for an undefined attribute reference.
+     *   For terminal builds of AsciiDoc-migrated corpora, where every
+     *   `{{ name }}` the renderer sees was converted from an `{name}`
+     *   attribute ref — an unresolvable one is a literal placeholder
+     *   (`{namespace}`, `${url}`), not a variable to carry forward.
+     *   Behaves like `'preserve'` for conditionals and includes.
+     *   NOTE: the emitted name keeps Minja's underscore normalization
+     *   (`{policy_gen_cr}` for source `{policy-gen-cr}`).
+     */
+    undefinedBehavior?: 'empty' | 'throw' | 'preserve' | 'asciidoc-literal';
+    /**
+     * How `{% if %}` conditions that reference an undefined variable
+     * behave. Only consulted when `undefinedBehavior` is `'preserve'`
+     * or `'asciidoc-literal'`.
+     *
+     * - `'preserve'` (default) — round-trip the whole
+     *   `{% if … %}…{% endif %}` verbatim so a later pass (with the value
+     *   supplied) can resolve it. Back-compat with the migrate pipeline.
+     * - `'falsy'` — treat the undefined reference as falsy and evaluate
+     *   the condition now, dropping (or `else`-branching) the block. This
+     *   matches AsciiDoc `ifdef::attr[]` semantics, where an undefined
+     *   attribute is false. Use for a *terminal* build where no further
+     *   Minja pass will run — undefined `{{ var }}` interpolations are
+     *   still preserved, but dangling conditionals don't leak to readers.
+     */
+    undefinedConditions?: 'preserve' | 'falsy';
+}
+export interface IContext {
+    /**
+     * Get a variable from the context
+     */
+    get(name: string): unknown;
+    /**
+     * Set a variable in the context
+     */
+    set(name: string, value: unknown): void;
+    /**
+     * Create a child scope
+     */
+    push(): IContext;
+    /**
+     * Return to parent scope
+     */
+    pop(): IContext | null;
+}
+export interface ParseResult {
+    ast: ASTNode[];
+    errors: ParseError[];
+}
+export interface ParseError {
+    message: string;
+    position: number;
+    line: number;
+    column: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for minja template engine
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@dogsbay/minja",
+  "version": "0.2.0-beta.100",
+  "description": "Minimal, secure Jinja2/Nunjucks subset for documentation preprocessing with zero code execution",
+  "keywords": [
+    "template",
+    "jinja2",
+    "nunjucks",
+    "asciidoc",
+    "documentation",
+    "secure",
+    "sandbox",
+    "safe"
+  ],
+  "author": "",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./browser": {
+      "import": {
+        "types": "./dist/browser.d.ts",
+        "default": "./dist/browser.js"
+      },
+      "require": {
+        "types": "./dist/browser.d.ts",
+        "default": "./dist/browser.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "bin": {
+    "minja": "./bin/minja.js"
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "commander": "^15.0.0",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "esbuild": "^0.19.12",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "dev": "node build.mjs --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\""
+  }
+}