🧱 Add div directive (#1140)

.changeset/afraid-moose-compete.md

@@ -0,0 +1,5 @@
+---
+"myst-directives": patch
+---
+
+Add div directive

packages/myst-directives/src/div.ts

@@ -0,0 +1,31 @@
+import type { DirectiveSpec, DirectiveData, GenericNode } from 'myst-common';
+import type { FlowContent, ListContent, PhrasingContent } from 'myst-spec';
+import { normalizeLabel } from 'myst-common';
+
+export const divDirective: DirectiveSpec = {
+  name: 'div',
+  options: {
+    label: {
+      type: String,
+      alias: ['name'],
+    },
+    class: {
+      type: String,
+    },
+  },
+  body: {
+    type: 'myst',
+    required: true,
+  },
+  run(data: DirectiveData): GenericNode[] {
+    const { label, identifier } = normalizeLabel(data.options?.label as string | undefined) || {};
+    const div: GenericNode = {
+      type: 'div',
+      children: data.body as unknown as (FlowContent | ListContent | PhrasingContent)[],
+      class: data.options?.class as string | undefined,
+      label,
+      identifier,
+    };
+    return [div];
+  },
+};

packages/myst-directives/src/index.ts

@@ -17,6 +17,7 @@ import { mystdemoDirective } from './mystdemo.js';
 import { outputDirective } from './output.js';
 import { blockquoteDirective } from './blockquote.js';
 import { rawDirective } from './raw.js';
+import { divDirective } from './div.js';
 
 export const defaultDirectives = [
   admonitionDirective,
@@ -41,6 +42,7 @@ export const defaultDirectives = [
   mystdemoDirective,
   outputDirective,
   rawDirective,
+  divDirective,
 ];
 
 export { admonitionDirective } from './admonition.js';
@@ -61,3 +63,4 @@ export { mystdemoDirective } from './mystdemo.js';
 export { outputDirective } from './output.js';
 export { blockquoteDirective } from './blockquote.js';
 export { rawDirective } from './raw.js';
+export { divDirective } from './div.js';