upgrade to astro-adocx 0.0.14

.vscode/settings.json

@@ -22,5 +22,4 @@
   "asciidoc.preview.asciidoctorAttributes": {
     "skip-front-matter": true
   },
-  "asciidoc.antora.enableAntoraSupport": false,
 }

adocx/config.ts

@@ -1,17 +1,20 @@
 import path from 'node:path';
 
+import type {
+  AdocNodeConverters,
+  AdocOptions,
+  AstroAdocxOptions,
+} from '@sransara/astro-adocx/types';
 // @ts-ignore: Types are not available
 import { register as krokiPluginRegisterHandle } from 'asciidoctor-kroki';
-import type { AdocOptions, AstroAdocxOptions, Template } from '@sransara/astro-adocx/types.js';
 
 import { register as inlineMacroCalloutRegisterHandle } from './extensions/inlineMacroCallout';
 
-const templates = Object.fromEntries(
-  Object.entries(import.meta.glob('./templates/*.ts', { eager: true })).map(([key, value]) => [
-    path.basename(key, '.ts'),
-    value as Template,
-  ]),
-);
+const nodeConverters = Object.fromEntries(
+  Object.entries(import.meta.glob('./nodeConverters/*.ts', { eager: true, import: 'convert' })).map(
+    ([key, value]) => [path.basename(key, '.ts'), value],
+  ),
+) as AdocNodeConverters;
 
 const astroFenced = `
 // For astro-layout-args
@@ -29,7 +32,13 @@ export const adocxConfig = {
     // useful for asciidoctor-diagrams/kroki
     document.setAttribute('outdir', path.dirname(filePath));
   },
-  templates,
+  nodeConverters,
+  astroLayouts: {
+    note: {
+      path: '@/src/layouts/adocNoteLayout/AdocNoteLayout.astro',
+      args: 'poster={poster} metadata={metadata}',
+    },
+  },
 } satisfies AstroAdocxOptions;
 
 export const asciidoctorConfig = {
@@ -45,7 +54,5 @@ export const asciidoctorConfig = {
     imagesdir: './_assets/',
     'kroki-fetch-diagram': true,
     'kroki-default-format': 'png',
-    'astro-layout-path': '@/src/layouts/adocNoteLayout/AdocNoteLayout.astro',
-    'astro-layout-args': '{...{ metadata, poster, docattrs, outline }}',
   },
 } satisfies AdocOptions;

adocx/extensions/inlineMacroCallout.ts

@@ -1,6 +1,6 @@
 import type { Extensions } from 'asciidoctor';
 
-import { isExtensionSingleton } from '@sransara/astro-adocx/types.js';
+import { isExtensionSingleton } from '@sransara/astro-adocx/types';
 
 export function register(registry: typeof Extensions | Extensions.Registry) {
   if (isExtensionSingleton(registry)) {

adocx/templates/inline_quoted.ts → adocx/nodeConverters/inline_quoted.ts

@@ -1,8 +1,8 @@
+import { UnsupportedNode, type AdocNodeConverter } from '@sransara/astro-adocx/types';
+import { addOnceToAstroFence } from '@sransara/astro-adocx/utils/astroFence';
 import type { Inline } from 'asciidoctor';
-import { UnsupportedNode, type Template } from '@sransara/astro-adocx/types.js';
-import { addOnceToAstroFence } from '@sransara/astro-adocx/utils/astroFence.js';
 
-export const convert: Template<Inline>['convert'] = (node: Inline, _opts?: any) => {
+export const convert: AdocNodeConverter<Inline> = (node: Inline, _opts?: any) => {
   const nodeType = node.getType();
   if (['asciimath', 'latexmath'].includes(nodeType)) {
     addOnceToAstroFence(node, "import Mathtex from '@/src/lib/astro/mathtex/Mathtex.astro';");

adocx/templates/listing.ts → adocx/nodeConverters/listing.ts

@@ -1,12 +1,12 @@
 // Reference:
 // - https://github.com/asciidoctor/asciidoctor-backends/blob/master/erb/html5/block_math.html.erb
 
+import { type AdocNodeConverter } from '@sransara/astro-adocx/types';
+import { addOnceToAstroFence } from '@sransara/astro-adocx/utils/astroFence';
+import { atag } from '@sransara/astro-adocx/utils/asx';
 import type { Block } from 'asciidoctor';
-import { type Template } from '@sransara/astro-adocx/types.js';
-import { addOnceToAstroFence } from '@sransara/astro-adocx/utils/astroFence.js';
-import { atag } from '@sransara/astro-adocx/utils/asx.js';
 
-export const convert: Template<Block>['convert'] = (node: Block, _opts?: any) => {
+export const convert: AdocNodeConverter<Block> = (node: Block, _opts?: any) => {
   const id = node.getId();
   const title = node.getCaptionedTitle();
   const roles = node.getRoles().join(' ');

adocx/templates/stem.ts → adocx/nodeConverters/stem.ts

@@ -2,11 +2,11 @@
 // - https://github.com/asciidoctor/asciidoctor-backends/blob/master/erb/html5/block_math.html.erb
 
 import type { Block } from 'asciidoctor';
-import { type Template } from '@sransara/astro-adocx/types.js';
-import { addOnceToAstroFence } from '@sransara/astro-adocx/utils/astroFence.js';
-import { atag } from '@sransara/astro-adocx/utils/asx.js';
+import { type AdocNodeConverter } from '@sransara/astro-adocx/types';
+import { addOnceToAstroFence } from '@sransara/astro-adocx/utils/astroFence';
+import { atag } from '@sransara/astro-adocx/utils/asx';
 
-export const convert: Template<Block>['convert'] = (node: Block, _opts?: any) => {
+export const convert: AdocNodeConverter<Block> = (node: Block, _opts?: any) => {
   const id = node.getId();
   const title = node.getCaptionedTitle();
   const roles = node.getRoles().join(' ');

astro.config.js

@@ -1,7 +1,7 @@
 import sitemap from '@astrojs/sitemap';
 import solid from '@astrojs/solid-js';
 import tailwind from '@astrojs/tailwind';
-import { adocx } from '@sransara/astro-adocx/integration.js';
+import { adocx } from '@sransara/astro-adocx/integration';
 import { defineConfig } from 'astro/config';
 
 import { adocxConfig, asciidoctorConfig } from './adocx/config';

package.json

@@ -18,7 +18,7 @@
     "@astrojs/solid-js": "^4.4.0",
     "@astrojs/tailwind": "^5.1.0",
     "@eslint/js": "^9.6.0",
-    "@sransara/astro-adocx": "^0.0.13",
+    "@sransara/astro-adocx": "^0.0.14",
     "@types/eslint": "^8.56.10",
     "@types/eslint__js": "^8.42.3",
     "@types/katex": "^0.16.7",

src/layouts/adocNoteLayout/AdocNoteLayout.astro

@@ -1,6 +1,6 @@
 ---
 import type { ImageMetadata } from 'astro';
-import type { Outline } from '@sransara/astro-adocx/utils/outline.js';
+import type { Outline } from '@sransara/astro-adocx/utils/outline';
 
 import type { Metadata } from '@/src/lib/types/notes';
 import NoteLayout from '@/src/layouts/noteLayout/NoteLayout.astro';

src/lib/astro/codeListing/CodeListing.astro

@@ -1,6 +1,6 @@
 ---
 import { codeToHtml, bundledLanguages } from 'shiki';
-import { decodeSpecialChars } from '@sransara/astro-adocx/utils/string.js';
+import { decodeSpecialChars } from '@sransara/astro-adocx/utils/string';
 
 interface Props {
   lang: string;

src/lib/astro/mathtex/Mathtex.astro

@@ -1,6 +1,6 @@
 ---
 import AsciiMathParser from 'asciimath2tex';
-import { decodeSpecialChars } from '@sransara/astro-adocx/utils/string.js';
+import { decodeSpecialChars } from '@sransara/astro-adocx/utils/string';
 import katex, { type KatexOptions } from 'katex';
 import 'katex/dist/katex.min.css';
 

src/pages/notes/2019/build-yourself-a-git/index.adoc

@@ -1,5 +1,6 @@
 = Conceptually building up to the fundamentals datastructures of Git.
 :sectnums:
+:astro-layout: note
 
 Have you ever wondered how Git works?
 In this note we will incrementally build a version control system while taking inspiration from Git.

src/pages/notes/2019/hello-world/index.adoc

@@ -2,6 +2,7 @@
 import { Counter } from './_islands/Counter.jsx';
 ---
 = Hello from another world.
+:astro-layout: note
 
 This is first contact.
 

src/pages/notes/2023/bazel-python-venv/index.adoc

@@ -1,5 +1,5 @@
 = Missing guide for creating a Python virtual environment in Bazel
-:astro-layout-path: @/src/layouts/asciidocNoteLayout/AsciidocNoteLayout.astro
+:astro-layout: note
 
 Bazel provides great tooling for building and testing Python code, but https://github.com/bazelbuild/rules_python[rules_python] as of this note (2023-05-05) do not provide an obvious way to create a Python shell with the `PYTHONPATH` footnote:[A Python shell with the `PYTHONPATH` is what I call a Python virtual environment in this guide.].
 As we venture outside the norms like `venv` by using Bazel, having access to a Python shell/enviroment lets us:

src/pages/notes/2023/power-to-tail-recursion/index.adoc

@@ -1,4 +1,5 @@
 = Step by step tail recursion elimination of power function as an example
+:astro-layout: note
 
 [discrete]
 === TLDR

tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions": {
     "baseUrl": ".",
     "paths": {
-      "@/*": ["*"]
+      "@/*": ["./*"]
     },
     "checkJs": true,
     "jsx": "preserve",