@d10f/asciidoc-astro-loader 0.0.1

package/dist/lib/asciidoc/templates/engines/index.cjs

@@ -0,0 +1,191 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/asciidoc/templates/engines/index.ts
+var engines_exports = {};
+__export(engines_exports, {
+  AbstractEngine: () => AbstractEngine,
+  HandlebarsEngine: () => HandlebarsEngine,
+  NunjucksEngine: () => NunjucksEngine,
+  PhpEngine: () => PhpEngine
+});
+module.exports = __toCommonJS(engines_exports);
+
+// src/lib/asciidoc/templates/engines/Base.ts
+var AbstractEngine = class {
+  constructor(_name, _extensions) {
+    this._name = _name;
+    this._extensions = _extensions;
+    this.templateList = /* @__PURE__ */ new Map();
+  }
+  templateList;
+  /**
+   * Returns the given name to this template engine.
+   */
+  get name() {
+    return this._name;
+  }
+  /**
+   * Returns the list of extensions this template engine supports.
+   */
+  get extensions() {
+    return this._extensions;
+  }
+  /**
+   * Accessor method to check if instance implements the
+   * TemplateModule interface.
+   */
+  get canLoad() {
+    return "load" in this && typeof this.load === "function";
+  }
+  /**
+   * Accessor method to check if instance implements the
+   * AsciidocTemplate interface.
+   */
+  get canRenderNode() {
+    return "renderNode" in this && typeof this.renderNode === "function";
+  }
+  /**
+   * Accessor method to check if instance implements the
+   * FilesystemTemplate interface.
+   */
+  get canRenderFile() {
+    return "renderFile" in this && typeof this.renderFile === "function";
+  }
+  /**
+   * Accessor method to check if instance implements the
+   * RawTemplate interface.
+   */
+  get canRenderString() {
+    return "renderString" in this && typeof this.renderString === "function";
+  }
+  /**
+   * Appends a new context that this template engine will act upon.
+   */
+  addContext(context, filepath) {
+    this.templateList.set(context, filepath);
+  }
+  /**
+   * Verifies whether the specified context is being tracked or not.
+   */
+  hasContext(context) {
+    return typeof context === "string" ? this.templateList.has(context) : this.templateList.has(context.getNodeName());
+  }
+  /**
+   * Verifies if the specified file extension is supported
+   * by this template engine.
+   */
+  supportsExt(extension) {
+    return this.extensions.includes(extension);
+  }
+};
+
+// src/lib/asciidoc/templates/engines/Handlebars.ts
+var import_node_fs = require("fs");
+var HandlebarsEngine = class extends AbstractEngine {
+  render;
+  constructor(name = "handlebars", extensions = ["handlebars", "hbs"]) {
+    super(name, extensions);
+    this.render = null;
+  }
+  async load() {
+    const Handlebars = await import("handlebars");
+    this.render = (input, opts) => {
+      return Handlebars.default.compile(input)(opts);
+    };
+  }
+  renderNode(node, options = {}) {
+    const context = node.getNodeName();
+    return this.renderFile(this.templateList.get(context), options);
+  }
+  renderFile(filepath, options = {}) {
+    const fileContents = (0, import_node_fs.readFileSync)(filepath, { encoding: "utf8" });
+    return this.renderString(fileContents, options);
+  }
+  renderString(str, options = {}) {
+    if (this.render === null) {
+      throw new Error("This template doesn't have a render method!");
+    }
+    return this.render(str, options);
+  }
+};
+
+// src/lib/asciidoc/templates/engines/Nunjucks.ts
+var import_node_fs2 = require("fs");
+var NunjucksEngine = class extends AbstractEngine {
+  render;
+  constructor(name = "nunjucks", extensions = ["nunjucks", "njk"]) {
+    super(name, extensions);
+    this.render = null;
+  }
+  async load() {
+    const nunjucks = await import("nunjucks");
+    this.render = nunjucks.default.renderString;
+  }
+  renderNode(node, options = {}) {
+    const context = node.getNodeName();
+    return this.renderFile(this.templateList.get(context), options);
+  }
+  renderFile(filepath, options = {}) {
+    const fileContents = (0, import_node_fs2.readFileSync)(filepath, { encoding: "utf8" });
+    return this.renderString(fileContents, options);
+  }
+  renderString(str, options = {}) {
+    if (this.render === null) {
+      throw new Error("This template doesn't have a render method!");
+    }
+    return this.render(str, options);
+  }
+};
+
+// src/lib/asciidoc/templates/engines/Php.ts
+var import_php_node = require("@platformatic/php-node");
+var PhpEngine = class extends AbstractEngine {
+  server;
+  constructor(name = "php", extensions = ["php"], docroot) {
+    super(name, extensions);
+    this.server = new import_php_node.Php({ docroot });
+  }
+  renderFile(filepath, options) {
+    const request = new import_php_node.Request({
+      method: "POST",
+      url: "http://localhost/" + filepath,
+      body: Buffer.from(JSON.stringify(options))
+    });
+    const response = this.server.handleRequestSync(request);
+    return response.body.toString();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AbstractEngine,
+  HandlebarsEngine,
+  NunjucksEngine,
+  PhpEngine
+});

package/dist/lib/asciidoc/templates/engines/index.d.cts

@@ -0,0 +1,30 @@
+import { b as AbstractEngine, a as AsciidocTemplate, T as TemplateModule, F as FilesystemTemplate, R as RawTemplate } from '../../../../index-Cf7MF6tZ.cjs';
+import { AbstractNode } from 'asciidoctor';
+import 'shiki';
+import 'zod';
+
+declare class HandlebarsEngine extends AbstractEngine implements AsciidocTemplate, TemplateModule, FilesystemTemplate, RawTemplate {
+    private render;
+    constructor(name?: string, extensions?: string[]);
+    load(): Promise<void>;
+    renderNode(node: AbstractNode, options?: Record<string, unknown>): string;
+    renderFile(filepath: string, options?: Record<string, unknown>): string;
+    renderString(str: string, options?: Record<string, unknown>): string;
+}
+
+declare class NunjucksEngine extends AbstractEngine implements AsciidocTemplate, TemplateModule, FilesystemTemplate, RawTemplate {
+    private render;
+    constructor(name?: string, extensions?: string[]);
+    load(): Promise<void>;
+    renderNode(node: AbstractNode, options?: Record<string, unknown>): string;
+    renderFile(filepath: string, options?: Record<string, unknown>): string;
+    renderString(str: string, options?: Record<string, unknown>): string;
+}
+
+declare class PhpEngine extends AbstractEngine implements FilesystemTemplate {
+    private server;
+    constructor(name: string | undefined, extensions: string[] | undefined, docroot: string);
+    renderFile(filepath: string, options?: Record<string, unknown>): string;
+}
+
+export { AbstractEngine, HandlebarsEngine, NunjucksEngine, PhpEngine };

package/dist/lib/asciidoc/templates/engines/index.d.ts

@@ -0,0 +1,30 @@
+import { b as AbstractEngine, a as AsciidocTemplate, T as TemplateModule, F as FilesystemTemplate, R as RawTemplate } from '../../../../index-Cf7MF6tZ.js';
+import { AbstractNode } from 'asciidoctor';
+import 'shiki';
+import 'zod';
+
+declare class HandlebarsEngine extends AbstractEngine implements AsciidocTemplate, TemplateModule, FilesystemTemplate, RawTemplate {
+    private render;
+    constructor(name?: string, extensions?: string[]);
+    load(): Promise<void>;
+    renderNode(node: AbstractNode, options?: Record<string, unknown>): string;
+    renderFile(filepath: string, options?: Record<string, unknown>): string;
+    renderString(str: string, options?: Record<string, unknown>): string;
+}
+
+declare class NunjucksEngine extends AbstractEngine implements AsciidocTemplate, TemplateModule, FilesystemTemplate, RawTemplate {
+    private render;
+    constructor(name?: string, extensions?: string[]);
+    load(): Promise<void>;
+    renderNode(node: AbstractNode, options?: Record<string, unknown>): string;
+    renderFile(filepath: string, options?: Record<string, unknown>): string;
+    renderString(str: string, options?: Record<string, unknown>): string;
+}
+
+declare class PhpEngine extends AbstractEngine implements FilesystemTemplate {
+    private server;
+    constructor(name: string | undefined, extensions: string[] | undefined, docroot: string);
+    renderFile(filepath: string, options?: Record<string, unknown>): string;
+}
+
+export { AbstractEngine, HandlebarsEngine, NunjucksEngine, PhpEngine };

package/dist/lib/asciidoc/templates/engines/index.js

@@ -0,0 +1,30 @@
+import {
+  AbstractEngine,
+  HandlebarsEngine,
+  NunjucksEngine
+} from "../../../../chunk-2F52PMNV.js";
+
+// src/lib/asciidoc/templates/engines/Php.ts
+import { Php, Request } from "@platformatic/php-node";
+var PhpEngine = class extends AbstractEngine {
+  server;
+  constructor(name = "php", extensions = ["php"], docroot) {
+    super(name, extensions);
+    this.server = new Php({ docroot });
+  }
+  renderFile(filepath, options) {
+    const request = new Request({
+      method: "POST",
+      url: "http://localhost/" + filepath,
+      body: Buffer.from(JSON.stringify(options))
+    });
+    const response = this.server.handleRequestSync(request);
+    return response.body.toString();
+  }
+};
+export {
+  AbstractEngine,
+  HandlebarsEngine,
+  NunjucksEngine,
+  PhpEngine
+};

package/dist/lib/shiki/transformers/index.cjs

@@ -0,0 +1,127 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/shiki/transformers/index.ts
+var transformers_exports = {};
+__export(transformers_exports, {
+  transformAsciidocCallout: () => transformAsciidocCallout,
+  transformConsoleCodeBlock: () => transformConsoleCodeBlock
+});
+module.exports = __toCommonJS(transformers_exports);
+
+// src/lib/utils.ts
+function escapeRegexCharacters(str) {
+  const re = /[-\\^$*+?.()|\[\]{}]/g;
+  return str.replace(re, "\\$&");
+}
+
+// src/lib/shiki/transformers/transformAsciidocCallout.ts
+function transformAsciidocCallout({
+  node,
+  cssClasses = "pointer-events-none select-none ml-2"
+}) {
+  const lineComments = ["//", "#", ";;"];
+  const customLineComment = node.getAttribute("line-comment");
+  if (customLineComment) {
+    lineComments.push(escapeRegexCharacters(customLineComment));
+  }
+  const calloutReList = [
+    // Handles C-style and similar comments like Perl, Python...
+    new RegExp(`(?:${lineComments.join("|")})((?:\\s+<(\\d+)>)+)`),
+    // Handles XML comments
+    new RegExp(/((?:\s*<!--(\d+)-->)+)/)
+  ];
+  const linesWithCallout = {};
+  return {
+    preprocess(code) {
+      return code.split("\n").map((line, idx) => {
+        for (const re of calloutReList) {
+          const match = line.match(re);
+          if (!match) continue;
+          const callouts = match[0].trim().replaceAll(/(?:<!--|-->|[<>])/g, "").split(" ");
+          linesWithCallout[idx + 1] = callouts;
+          return line.replace(re, "");
+        }
+        return line;
+      }).join("\n");
+    },
+    line(hast, line) {
+      const callouts = linesWithCallout[line];
+      if (!callouts) return;
+      callouts.forEach((calloutId) => {
+        hast.properties[`data-callout-${calloutId}`] = "";
+        hast.children.push({
+          type: "element",
+          tagName: "i",
+          properties: {
+            class: `conum ${cssClasses}`,
+            "data-value": calloutId
+          },
+          children: [
+            {
+              type: "element",
+              tagName: "b",
+              properties: {},
+              children: [
+                {
+                  type: "text",
+                  value: calloutId
+                }
+              ]
+            }
+          ]
+        });
+      });
+    }
+  };
+}
+
+// src/lib/shiki/transformers/transformConsoleCodeBlock.ts
+function transformConsoleCodeBlock(options = {
+  cssClasses: "pointer-events-none select-none mr-2 opacity-50"
+}) {
+  const unselectablePrompt = `<span $1 class="${options.cssClasses}">$</span>`;
+  const linePrefix = '<span class="line[^>]+?>';
+  const splitPrompt = new RegExp(
+    `(?<=${linePrefix})(?:<span (style="[^"]*?")>\\s*?\\$\\s+?([^<]))`
+  );
+  const trimWhitespace = new RegExp(
+    `(?<=${linePrefix})(?:<span (style="[^"]*?")>\\s*?\\$\\s*?<\\/span>(?:<span>\\s+<\\/span>)?)`
+  );
+  const trimWhitespaceAhead = new RegExp(
+    `(?<=${linePrefix}<span [^>]+?>\\$<\\/span>)(<span style="[^"]+?">)\\s+?`
+  );
+  return {
+    postprocess: (html, { lang }) => {
+      if (lang === "console") {
+        return html.split("\n").map((line) => {
+          return line.replace(
+            splitPrompt,
+            unselectablePrompt + "<span $1>$2"
+          ).replace(trimWhitespace, unselectablePrompt).replace(trimWhitespaceAhead, "$1");
+        }).join("\n");
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  transformAsciidocCallout,
+  transformConsoleCodeBlock
+});

package/dist/lib/shiki/transformers/index.d.cts

@@ -0,0 +1,59 @@
+import { Block } from 'asciidoctor';
+import { ShikiTransformer } from 'shiki';
+import { ShikiTransformer as ShikiTransformer$1 } from 'shiki/types';
+
+type TransformOptions$1 = {
+    /**
+     * Instance of Asciidoc's Block element to act upon.
+     */
+    node: Block;
+    /**
+     * String of CSS classes to apply to Asciidoc callout elements.
+     * Note: this does not override Asciidoctor's default class "conum"
+     * that applies to callout elements.
+     *
+     * @default pointer-events-none select-none ml-2
+     */
+    cssClasses?: string;
+};
+/**
+ * Transforms source code blocks by converting Asciidoc's callout annotations
+ * into unselectable tokens.
+ */
+declare function transformAsciidocCallout({ node, cssClasses, }: TransformOptions$1): ShikiTransformer;
+
+type TransformOptions = {
+    /**
+     * String of CSS classes to apply to leading '$' character on console
+     * code blocks. By default, this transformer makes it unselectable and
+     * applies 50% opacity.
+     *
+     * @default pointer-events-none select-none mr-2 opacity-50
+     */
+    cssClasses?: string;
+};
+/**
+ * For code blocks of language "console", makes the leading prompt
+ * character "$" unselectable, as it often leads to confusion when
+ * copying the command and running with the preceding prompt.
+ *
+ * Likewise, the leading spaces before the actual command are deleted
+ * from the span elements generated by Shiki to avoid accidentally
+ * running commands that would not appear in the shell history.
+ *
+ * @example
+ *   before: <span>$ npm run dev</span>
+ *   after:  <span>$</span><span>npm run dev</span>
+ *
+ * @example
+ *   before: <span> $ </span><span> </span>
+ *   before: <span> $ </span>
+ *   after:  <span>$</span>
+ *
+ * @example
+ *   before: <span>$</span><span> npm run dev</span>
+ *   after:  <span>$</span><span>npm run dev</span>
+ */
+declare function transformConsoleCodeBlock(options?: TransformOptions): ShikiTransformer$1;
+
+export { transformAsciidocCallout, transformConsoleCodeBlock };

package/dist/lib/shiki/transformers/index.d.ts

@@ -0,0 +1,59 @@
+import { Block } from 'asciidoctor';
+import { ShikiTransformer } from 'shiki';
+import { ShikiTransformer as ShikiTransformer$1 } from 'shiki/types';
+
+type TransformOptions$1 = {
+    /**
+     * Instance of Asciidoc's Block element to act upon.
+     */
+    node: Block;
+    /**
+     * String of CSS classes to apply to Asciidoc callout elements.
+     * Note: this does not override Asciidoctor's default class "conum"
+     * that applies to callout elements.
+     *
+     * @default pointer-events-none select-none ml-2
+     */
+    cssClasses?: string;
+};
+/**
+ * Transforms source code blocks by converting Asciidoc's callout annotations
+ * into unselectable tokens.
+ */
+declare function transformAsciidocCallout({ node, cssClasses, }: TransformOptions$1): ShikiTransformer;
+
+type TransformOptions = {
+    /**
+     * String of CSS classes to apply to leading '$' character on console
+     * code blocks. By default, this transformer makes it unselectable and
+     * applies 50% opacity.
+     *
+     * @default pointer-events-none select-none mr-2 opacity-50
+     */
+    cssClasses?: string;
+};
+/**
+ * For code blocks of language "console", makes the leading prompt
+ * character "$" unselectable, as it often leads to confusion when
+ * copying the command and running with the preceding prompt.
+ *
+ * Likewise, the leading spaces before the actual command are deleted
+ * from the span elements generated by Shiki to avoid accidentally
+ * running commands that would not appear in the shell history.
+ *
+ * @example
+ *   before: <span>$ npm run dev</span>
+ *   after:  <span>$</span><span>npm run dev</span>
+ *
+ * @example
+ *   before: <span> $ </span><span> </span>
+ *   before: <span> $ </span>
+ *   after:  <span>$</span>
+ *
+ * @example
+ *   before: <span>$</span><span> npm run dev</span>
+ *   after:  <span>$</span><span>npm run dev</span>
+ */
+declare function transformConsoleCodeBlock(options?: TransformOptions): ShikiTransformer$1;
+
+export { transformAsciidocCallout, transformConsoleCodeBlock };

package/dist/lib/shiki/transformers/index.js

@@ -0,0 +1,8 @@
+import {
+  transformAsciidocCallout,
+  transformConsoleCodeBlock
+} from "../../../chunk-DDIUST2Z.js";
+export {
+  transformAsciidocCallout,
+  transformConsoleCodeBlock
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+	"name": "@d10f/asciidoc-astro-loader",
+	"version": "0.0.1",
+	"description": "An Astro collections loader for Asciidoc files",
+	"author": "D10f",
+	"license": "MIT",
+	"homepage": "https://codeberg.org/d10f/asciidoc-astro-loader",
+	"repository": {
+		"type": "git",
+		"url": "git+https://codeberg.org/d10f/asciidoc-astro-loader.git"
+	},
+	"bugs": {
+		"url": "https://codeberg.org/d10f/asciidoc-astro-loader/issues"
+	},
+	"keywords": [
+		"asciidoc",
+		"asciidoctor",
+		"astro",
+		"loader",
+		"collections"
+	],
+	"scripts": {
+		"build": "tsup",
+		"test": "vitest run",
+		"dev": "vitest"
+	},
+	"files": [
+		"dist"
+	],
+	"type": "module",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": "./dist/index.js",
+		"./engines": "./dist/lib/asciidoc/templates/engines/index.js",
+		"./converters": "./dist/lib/asciidoc/converters/index.js",
+		"./transformers": "./dist/lib/shiki/transformers/index.js"
+	},
+	"devDependencies": {
+		"eslint": "^9.36.0",
+		"eslint-plugin-prettier": "^5.5.4",
+		"globals": "^16.4.0",
+		"jiti": "^2.6.1",
+		"memfs": "^4.49.0",
+		"prettier": "^3.6.2",
+		"tsup": "^8.5.0",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "^8.45.0",
+		"vitest": "^3.2.4"
+	},
+	"dependencies": {
+		"@shikijs/transformers": "^3.13.0",
+		"asciidoctor": "^3.0.4",
+		"astro": "^5.14.6",
+		"shiki": "^3.13.0",
+		"ventojs": "^2.2.0",
+		"zod": "^4.1.12"
+	}
+}