@markii/stdlib 0.8.0 → 0.9.0

package/dist/contracts.d.ts

@@ -49,7 +49,7 @@ export interface ComponentContract {
 /**
  * The standard component set, seeded from the components that ship with
  * `@markii/react` today (`packages/platforms/markii-react/src/components/
- * {callout,kbd,rating,details,card,badge,figure,tabs,tab}.tsx`). Each
+ * {callout,kbd,rating,divider,details,card,badge,figure,tabs,tab}.tsx`). Each
  * contract was written by reading the real implementation — `kind` from how
  * the component is registered in `defaultRegistry`, `attributes` from
  * exactly the props the component reads (no invented attributes).

package/dist/contracts.js

@@ -44,7 +44,7 @@ function layoutWrapperContract(name, whatItDoes) {
 /**
  * The standard component set, seeded from the components that ship with
  * `@markii/react` today (`packages/platforms/markii-react/src/components/
- * {callout,kbd,rating,details,card,badge,figure,tabs,tab}.tsx`). Each
+ * {callout,kbd,rating,divider,details,card,badge,figure,tabs,tab}.tsx`). Each
  * contract was written by reading the real implementation — `kind` from how
  * the component is registered in `defaultRegistry`, `attributes` from
  * exactly the props the component reads (no invented attributes).
@@ -95,6 +95,24 @@ export const STANDARD_COMPONENTS = {
         },
         description: 'A leaf directive rendering a row of stars, e.g. `::rating{value=3 max=5}`. Has no body — both attributes are optional and degrade gracefully rather than throwing.',
     },
+    divider: {
+        name: 'divider',
+        kind: 'leaf',
+        attributes: {
+            label: {
+                type: 'string',
+                required: false,
+                description: 'Optional short text shown centered in the line. Absent or empty means an unlabeled divider.',
+            },
+            variant: {
+                type: 'string',
+                required: false,
+                enum: ['line', 'dots', 'ornament'],
+                description: 'Which break to draw: a solid hairline, a dotted hairline, or a centered ornament with no hairline. Defaults to `line` when absent or not one of the allowed values.',
+            },
+        },
+        description: 'A leaf directive drawing a section break, e.g. `::divider{label="Part 2" variant="dots"}`. Has no body, and both attributes are optional. A plain `---` thematic break keeps its own CommonMark meaning; this directive is for a break that carries a label or a chosen look.',
+    },
     details: {
         name: 'details',
         kind: 'container',

package/dist/index.d.ts

@@ -1 +1,2 @@
 export { getContract, STANDARD_COMPONENTS, type AttributeSchema, type ComponentContract, type ComponentKind, } from './contracts.js';
+export { ALIGN_PRESETS, LAYOUT_ATTRIBUTE_KEYS, LAYOUT_ATTRIBUTES, WIDTH_PRESETS, } from './layout.js';

package/dist/index.js

@@ -1 +1,2 @@
 export { getContract, STANDARD_COMPONENTS, } from './contracts.js';
+export { ALIGN_PRESETS, LAYOUT_ATTRIBUTE_KEYS, LAYOUT_ATTRIBUTES, WIDTH_PRESETS, } from './layout.js';

package/dist/layout.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The neutral definition of docs/format.md's layout system: the two
+ * reserved attributes every block directive can carry (`width`, `align`)
+ * and their closed preset vocabularies. Zero dependency, matching this
+ * package's own posture — every renderer (`@markii/react`, `@markii/html`,
+ * and any future one) builds its class-mapping logic off these same value
+ * lists instead of hand-copying the literals, which is how the two
+ * existing renderers drifted into two near-identical copies in the first
+ * place.
+ *
+ * This module carries VALUES only (the attribute names, the preset lists,
+ * and the two attributes expressed as `AttributeSchema`s for a tool that
+ * documents or completes attributes). It says nothing about markup,
+ * classes, or rendering; see each renderer's own `layout.ts` for that.
+ */
+import type { AttributeSchema } from './contracts.js';
+/** The two attribute names docs/format.md reserves on every block directive. */
+export declare const LAYOUT_ATTRIBUTE_KEYS: readonly ["width", "align"];
+/** The closed `width=` preset vocabulary (docs/format.md), in the order the docs list them. */
+export declare const WIDTH_PRESETS: readonly ["normal", "narrow", "wide", "full"];
+/** The closed `align=` preset vocabulary (docs/format.md), in the order the docs list them. */
+export declare const ALIGN_PRESETS: readonly ["left", "center", "right"];
+/**
+ * The two reserved layout attributes as `AttributeSchema`s, so a tool that
+ * completes or documents attributes reads them exactly like a component's
+ * own.
+ */
+export declare const LAYOUT_ATTRIBUTES: Readonly<Record<'width' | 'align', AttributeSchema>>;

package/dist/layout.js

@@ -0,0 +1,31 @@
+/** The two attribute names docs/format.md reserves on every block directive. */
+export const LAYOUT_ATTRIBUTE_KEYS = ['width', 'align'];
+/** The closed `width=` preset vocabulary (docs/format.md), in the order the docs list them. */
+export const WIDTH_PRESETS = ['normal', 'narrow', 'wide', 'full'];
+/** The closed `align=` preset vocabulary (docs/format.md), in the order the docs list them. */
+export const ALIGN_PRESETS = ['left', 'center', 'right'];
+/**
+ * The two reserved layout attributes as `AttributeSchema`s, so a tool that
+ * completes or documents attributes reads them exactly like a component's
+ * own.
+ */
+export const LAYOUT_ATTRIBUTES = {
+    width: {
+        type: 'string',
+        required: false,
+        enum: WIDTH_PRESETS,
+        description: 'Sets how wide the directive renders: `normal` (the default column ' +
+            'width), `narrow`, `wide`, or `full`. `normal` is the explicit ' +
+            'default and produces no class, the same as leaving `width` off ' +
+            'entirely. An invalid value is ignored as if absent; nothing errors.',
+    },
+    align: {
+        type: 'string',
+        required: false,
+        enum: ALIGN_PRESETS,
+        description: 'Sets how the directive is aligned within the column: `left`, ' +
+            '`center`, or `right`. Only has a visible effect when the block is ' +
+            'narrower than the column; a full-width block has nothing to align. ' +
+            'An invalid value is ignored as if absent; nothing errors.',
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markii/stdlib",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Neutral, framework-agnostic standard component contracts for Mark (.mk.md) — the kind/attribute-schema seam every renderer (e.g. @markii/react) implements against. No React, zero dependencies.",
   "keywords": [
     "markdown",