@vmprint/mkd-literature 1.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 cosmiciron
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,48 @@
+# @vmprint/mkd-literature
+
+Markdown to VMPrint `DocumentInput` transmuter with built-in literature defaults.
+
+Input is standard Markdown. Output is a pure object in VMPrint's AST format (`DocumentInput`), ready for JSON serialization or direct layout/rendering.
+
+## Features
+
+- Zero file access. No `fs`, no Node-specific loading.
+- No engine dependency. Types remain structurally compatible with `@vmprint/engine`.
+- Built-in literature config and theme defaults.
+- Caller overrides for `theme` and `config`.
+- Images via data URIs or a caller-supplied resolver callback.
+
+## Installation
+
+```bash
+npm install @vmprint/mkd-literature
+```
+
+## Usage
+
+```typescript
+import { transmute } from '@vmprint/mkd-literature';
+
+const doc = transmute('# Chapter One\n\nBody text.');
+
+const customized = transmute('# Chapter One', {
+  config: `references:\n  heading: Endnotes\n`,
+  theme: `styles:\n  paragraph:\n    lineHeight: 1.6\n`
+});
+```
+
+## API
+
+```typescript
+type LiteratureTransmuteOptions = {
+  theme?: string;
+  config?: string;
+  resolveImage?: (src: string) => { data: string; mimeType: 'image/png' | 'image/jpeg' } | null;
+};
+
+function transmute(markdown: string, options?: LiteratureTransmuteOptions): DocumentInput;
+```
+
+---
+
+Licensed under the [Apache License 2.0](LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,134 @@
+// Generated by dts-bundle-generator v9.5.1
+
+export { Transmuter, TransmuterOptions } from './transmuter';
+import { Transmuter, TransmuterOptions } from '@vmprint/contracts';
+
+// Generated by dts-bundle-generator v9.5.1
+/**
+ * Types compatible with @vmprint/engine's DocumentInput.
+ * Declared here so the transmuter has zero dependency on the engine package.
+ */
+export type TextAlign = "left" | "right" | "center" | "justify";
+export type HyphenationMode = "off" | "auto" | "soft";
+export type JustifyEngineMode = "legacy" | "advanced";
+export type JustifyStrategy = "auto" | "space" | "inter-character";
+export interface ElementStyle {
+	fontFamily?: string;
+	fontSize?: number;
+	fontWeight?: number | string;
+	fontStyle?: string;
+	textAlign?: TextAlign;
+	lang?: string;
+	direction?: string;
+	hyphenation?: HyphenationMode;
+	hyphenateCaps?: boolean;
+	justifyEngine?: JustifyEngineMode;
+	justifyStrategy?: JustifyStrategy;
+	marginTop?: number;
+	marginBottom?: number;
+	marginLeft?: number;
+	marginRight?: number;
+	textIndent?: number;
+	lineHeight?: number;
+	letterSpacing?: number;
+	verticalAlign?: "baseline" | "text-top" | "middle" | "text-bottom" | "bottom";
+	baselineShift?: number;
+	inlineMarginLeft?: number;
+	inlineMarginRight?: number;
+	padding?: number;
+	paddingTop?: number;
+	paddingBottom?: number;
+	paddingLeft?: number;
+	paddingRight?: number;
+	width?: number;
+	height?: number;
+	zIndex?: number;
+	color?: string;
+	backgroundColor?: string;
+	opacity?: number;
+	pageBreakBefore?: boolean;
+	keepWithNext?: boolean;
+	allowLineSplit?: boolean;
+	orphans?: number;
+	widows?: number;
+	overflowPolicy?: string;
+	borderWidth?: number;
+	borderColor?: string;
+	borderRadius?: number;
+	borderTopWidth?: number;
+	borderBottomWidth?: number;
+	borderLeftWidth?: number;
+	borderRightWidth?: number;
+	borderTopColor?: string;
+	borderBottomColor?: string;
+	borderLeftColor?: string;
+	borderRightColor?: string;
+	[key: string]: unknown;
+}
+interface Element$1 {
+	type: string;
+	content: string;
+	children?: Element$1[];
+	columns?: number;
+	gutter?: number;
+	balance?: boolean;
+	table?: Record<string, unknown>;
+	image?: Record<string, unknown>;
+	dropCap?: Record<string, unknown>;
+	properties?: Record<string, unknown>;
+}
+export interface DocumentLayout {
+	pageSize: "A4" | "LETTER" | {
+		width: number;
+		height: number;
+	};
+	margins: {
+		top: number;
+		right: number;
+		bottom: number;
+		left: number;
+	};
+	fontFamily: string;
+	fontSize: number;
+	lineHeight: number;
+	[key: string]: unknown;
+}
+export interface PageRegionContent {
+	elements: Element$1[];
+	style?: ElementStyle;
+}
+export interface PageRegionDefinition {
+	default?: PageRegionContent | null;
+	firstPage?: PageRegionContent | null;
+	odd?: PageRegionContent | null;
+	even?: PageRegionContent | null;
+}
+export interface DocumentInput {
+	documentVersion: "1.1";
+	layout: DocumentLayout;
+	fonts?: Record<string, string | undefined>;
+	styles: Partial<Record<string, ElementStyle>>;
+	elements: Element$1[];
+	header?: PageRegionDefinition;
+	footer?: PageRegionDefinition;
+}
+export type ResolvedImage = {
+	data: string;
+	mimeType: "image/png" | "image/jpeg";
+};
+export declare const DEFAULT_LITERATURE_CONFIG_YAML = "\nlist:\n  textIndentPerLevel: 15\n  markerGap: 5\n  itemSpacingAfter: 3.6\n  tightItemSpacingAfter: 1.2\n  continuationIndentLevels: 0\n  unorderedMarkers:\n    - \"\u2014\"\n    - \"\u2014\"\n    - \"\u2014\"\n  orderedMarkers:\n    - upper-roman\n    - decimal\n    - lower-alpha\n  taskMarkers:\n    checked: \"[done]\"\n    unchecked: \"[ ]\"\n\nlinks:\n  mode: citation\n  dedupe: true\n  citationStyle: bracket\n\nreferences:\n  enabled: true\n  heading: Notes\n  numberingStyle: lower-roman\n  includeLinkTitle: true\n\nblockquote:\n  attribution:\n    enabled: true\n    markerPattern: '^[-\u2014\u2013]{1,2}s+'\n\ntitle:\n  subheading:\n    enabled: false\n    markerPattern: '^::s+'\n    requireMarker: true\n    stripMarker: true\n    applyToFirstH1Only: true\n    keepWithNext: true\n\nimages:\n  blockStyle:\n    width: 286\n    marginTop: 5.4\n    marginBottom: 5\n    borderWidth: 0\n    borderRadius: 0\n    paddingTop: 0\n    paddingBottom: 0\n    paddingLeft: 0\n    paddingRight: 0\n  frame:\n    mode: \"off\"\n    markerPattern: '\b(frame|framed)\b'\n    style: {}\n\ncaptions:\n  pattern: '^(Plate|Figure|Fig.|Source)s+([0-9]+|[IVXLC]+)\b'\n  blockquoteUnderImageAsFigureCaption: false\n  style:\n    textAlign: left\n    hyphenation: \"off\"\n    fontStyle: italic\n    fontSize: 9.8\n    lineHeight: 1.3\n    color: \"#47443f\"\n    marginTop: 0\n    marginBottom: 9\n\ntables:\n  zebra: false\n  headerColor: \"#f3f4f6\"\n\ncodeBlocks:\n  defaultMode: extract\n  languageModes:\n    verse: verse\n    poetry: verse\n    poem: verse\n    extract: extract\n    archive: extract\n    epigraph: epigraph\n    letter: letter\n    marginalia: marginalia\n  modes:\n    verse:\n      style:\n        fontFamily: Caladea\n        fontStyle: italic\n        fontSize: 11.6\n        lineHeight: 1.58\n        textAlign: left\n        color: \"#252422\"\n        backgroundColor: \"#ffffff\"\n        borderWidth: 0\n        borderLeftWidth: 0\n        borderLeftColor: \"#96928a\"\n        paddingTop: 6\n        paddingBottom: 6\n        paddingLeft: 18\n        paddingRight: 8\n        marginTop: 0.4\n        marginBottom: 10\n    extract:\n      style:\n        fontFamily: Caladea\n        fontStyle: italic\n        fontSize: 11.2\n        lineHeight: 1.5\n        textAlign: left\n        color: \"#2a2a2a\"\n        backgroundColor: \"#ffffff\"\n        borderWidth: 0\n        borderLeftWidth: 0\n        borderLeftColor: \"#8d8a84\"\n        paddingTop: 6\n        paddingBottom: 6\n        paddingLeft: 14\n        paddingRight: 8\n        marginTop: 0\n        marginBottom: 10\n    epigraph:\n      style:\n        fontFamily: Caladea\n        fontStyle: italic\n        fontSize: 11\n        lineHeight: 1.5\n        textAlign: center\n        color: \"#2f2c28\"\n        backgroundColor: \"#ffffff\"\n        borderWidth: 0\n        paddingTop: 5\n        paddingBottom: 5\n        paddingLeft: 20\n        paddingRight: 20\n        marginTop: 1.4\n        marginBottom: 10\n    letter:\n      style:\n        fontFamily: Caladea\n        fontStyle: normal\n        fontSize: 11.2\n        lineHeight: 1.5\n        textAlign: left\n        color: \"#252525\"\n        backgroundColor: \"#ffffff\"\n        borderWidth: 0\n        borderColor: \"#cfcbc2\"\n        paddingTop: 7\n        paddingBottom: 7\n        paddingLeft: 10\n        paddingRight: 10\n        marginTop: 0\n        marginBottom: 10\n    marginalia:\n      style:\n        fontFamily: Caladea\n        fontStyle: italic\n        fontSize: 10.6\n        lineHeight: 1.45\n        textAlign: left\n        color: \"#3a3732\"\n        backgroundColor: \"#ffffff\"\n        borderWidth: 0\n        borderLeftWidth: 0\n        borderLeftColor: \"#b1a795\"\n        paddingTop: 5\n        paddingBottom: 5\n        paddingLeft: 10\n        paddingRight: 6\n        marginTop: 0\n        marginBottom: 8\n";
+export declare const DEFAULT_LITERATURE_THEME_YAML = "\nlayout:\n  fontFamily: Caladea\n  fontSize: 10.6\n  lineHeight: 1.52\n  pageSize:\n    width: 396\n    height: 612\n  margins:\n    top: 64\n    right: 54\n    bottom: 62\n    left: 54\n  hyphenation: soft\n  justifyEngine: advanced\n  justifyStrategy: auto\n\nfooter:\n  default:\n    elements:\n      - type: paragraph\n        content: \"{pageNumber}\"\n        properties:\n          style:\n            textAlign: center\n            fontSize: 9\n            color: \"#666666\"\n            fontFamily: Caladea\n            marginTop: 31\n\nstyles:\n  paragraph:\n    textAlign: left\n    marginBottom: 8.6\n    hyphenation: \"off\"\n    justifyEngine: legacy\n  heading-1:\n    fontSize: 20.8\n    marginTop: 9.4\n    marginBottom: 9\n    hyphenation: \"off\"\n    textAlign: left\n  heading-2:\n    fontSize: 16.2\n    marginTop: 5.4\n    marginBottom: 7\n    hyphenation: \"off\"\n    textAlign: left\n  heading-3:\n    fontSize: 13.9\n    marginTop: 5.4\n    marginBottom: 6\n    hyphenation: \"off\"\n    textAlign: left\n  inline-code:\n    fontFamily: Caladea\n    fontStyle: italic\n    fontSize: 11\n    backgroundColor: \"#ffffff\"\n  blockquote:\n    textAlign: left\n    fontStyle: italic\n    fontSize: 10.4\n    lineHeight: 1.45\n    color: \"#2b2a28\"\n    paddingLeft: 18\n    paddingRight: 8\n    borderLeftWidth: 0\n    marginTop: 0\n    marginBottom: 9\n  blockquote-attribution:\n    textAlign: right\n    fontStyle: normal\n    fontSize: 9.8\n    color: \"#47443f\"\n    marginTop: 2\n    marginBottom: 7\n  references-heading:\n    hyphenation: \"off\"\n    textAlign: left\n    fontSize: 12.4\n    marginTop: 3.4\n    marginBottom: 5\n  references-item:\n    textAlign: left\n    hyphenation: \"off\"\n    lineHeight: 1.3\n    fontSize: 9.8\n    marginBottom: 3\n    paddingLeft: 12\n    textIndent: -12\n  list-item-ordered-0:\n    textAlign: left\n    hyphenation: \"off\"\n    justifyEngine: legacy\n    marginBottom: 3.6\n  list-item-ordered-1:\n    textAlign: left\n    hyphenation: \"off\"\n    justifyEngine: legacy\n    marginBottom: 3.2\n  list-item-unordered-0:\n    textAlign: left\n    hyphenation: \"off\"\n    justifyEngine: legacy\n    marginBottom: 3.6\n  list-item-unordered-1:\n    textAlign: left\n    hyphenation: \"off\"\n    justifyEngine: legacy\n    marginBottom: 3.2\n  definition-term:\n    fontStyle: italic\n    fontWeight: 700\n    keepWithNext: true\n    marginTop: 0\n    marginBottom: 1.2\n  definition-desc:\n    paddingLeft: 14\n    marginTop: 0\n    marginBottom: 5.4\n  table-cell:\n    paddingTop: 4\n    paddingBottom: 4\n    paddingLeft: 5\n    paddingRight: 5\n    borderWidth: 0.6\n    borderColor: \"#111111\"\n";
+export type LiteratureTransmuteOptions = TransmuterOptions & {
+	resolveImage?: (src: string) => ResolvedImage | null;
+};
+export declare function transmute(markdown: string, options?: LiteratureTransmuteOptions): DocumentInput;
+export type LiteratureTransmuter = Transmuter<string, DocumentInput, LiteratureTransmuteOptions>;
+export declare const transmuter: LiteratureTransmuter;
+
+export {
+	Element$1 as Element,
+	Transmuter,
+	TransmuterOptions,
+};
+
+export {};

package/dist/index.js

@@ -0,0 +1,365 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_LITERATURE_CONFIG_YAML: () => DEFAULT_LITERATURE_CONFIG_YAML,
+  DEFAULT_LITERATURE_THEME_YAML: () => DEFAULT_LITERATURE_THEME_YAML,
+  transmute: () => transmute,
+  transmuter: () => transmuter
+});
+module.exports = __toCommonJS(index_exports);
+var import_markdown_core = require("@vmprint/markdown-core");
+var DEFAULT_LITERATURE_CONFIG_YAML = `
+list:
+  textIndentPerLevel: 15
+  markerGap: 5
+  itemSpacingAfter: 3.6
+  tightItemSpacingAfter: 1.2
+  continuationIndentLevels: 0
+  unorderedMarkers:
+    - "\u2014"
+    - "\u2014"
+    - "\u2014"
+  orderedMarkers:
+    - upper-roman
+    - decimal
+    - lower-alpha
+  taskMarkers:
+    checked: "[done]"
+    unchecked: "[ ]"
+
+links:
+  mode: citation
+  dedupe: true
+  citationStyle: bracket
+
+references:
+  enabled: true
+  heading: Notes
+  numberingStyle: lower-roman
+  includeLinkTitle: true
+
+blockquote:
+  attribution:
+    enabled: true
+    markerPattern: '^[-\u2014\u2013]{1,2}s+'
+
+title:
+  subheading:
+    enabled: false
+    markerPattern: '^::s+'
+    requireMarker: true
+    stripMarker: true
+    applyToFirstH1Only: true
+    keepWithNext: true
+
+images:
+  blockStyle:
+    width: 286
+    marginTop: 5.4
+    marginBottom: 5
+    borderWidth: 0
+    borderRadius: 0
+    paddingTop: 0
+    paddingBottom: 0
+    paddingLeft: 0
+    paddingRight: 0
+  frame:
+    mode: "off"
+    markerPattern: '\b(frame|framed)\b'
+    style: {}
+
+captions:
+  pattern: '^(Plate|Figure|Fig.|Source)s+([0-9]+|[IVXLC]+)\b'
+  blockquoteUnderImageAsFigureCaption: false
+  style:
+    textAlign: left
+    hyphenation: "off"
+    fontStyle: italic
+    fontSize: 9.8
+    lineHeight: 1.3
+    color: "#47443f"
+    marginTop: 0
+    marginBottom: 9
+
+tables:
+  zebra: false
+  headerColor: "#f3f4f6"
+
+codeBlocks:
+  defaultMode: extract
+  languageModes:
+    verse: verse
+    poetry: verse
+    poem: verse
+    extract: extract
+    archive: extract
+    epigraph: epigraph
+    letter: letter
+    marginalia: marginalia
+  modes:
+    verse:
+      style:
+        fontFamily: Caladea
+        fontStyle: italic
+        fontSize: 11.6
+        lineHeight: 1.58
+        textAlign: left
+        color: "#252422"
+        backgroundColor: "#ffffff"
+        borderWidth: 0
+        borderLeftWidth: 0
+        borderLeftColor: "#96928a"
+        paddingTop: 6
+        paddingBottom: 6
+        paddingLeft: 18
+        paddingRight: 8
+        marginTop: 0.4
+        marginBottom: 10
+    extract:
+      style:
+        fontFamily: Caladea
+        fontStyle: italic
+        fontSize: 11.2
+        lineHeight: 1.5
+        textAlign: left
+        color: "#2a2a2a"
+        backgroundColor: "#ffffff"
+        borderWidth: 0
+        borderLeftWidth: 0
+        borderLeftColor: "#8d8a84"
+        paddingTop: 6
+        paddingBottom: 6
+        paddingLeft: 14
+        paddingRight: 8
+        marginTop: 0
+        marginBottom: 10
+    epigraph:
+      style:
+        fontFamily: Caladea
+        fontStyle: italic
+        fontSize: 11
+        lineHeight: 1.5
+        textAlign: center
+        color: "#2f2c28"
+        backgroundColor: "#ffffff"
+        borderWidth: 0
+        paddingTop: 5
+        paddingBottom: 5
+        paddingLeft: 20
+        paddingRight: 20
+        marginTop: 1.4
+        marginBottom: 10
+    letter:
+      style:
+        fontFamily: Caladea
+        fontStyle: normal
+        fontSize: 11.2
+        lineHeight: 1.5
+        textAlign: left
+        color: "#252525"
+        backgroundColor: "#ffffff"
+        borderWidth: 0
+        borderColor: "#cfcbc2"
+        paddingTop: 7
+        paddingBottom: 7
+        paddingLeft: 10
+        paddingRight: 10
+        marginTop: 0
+        marginBottom: 10
+    marginalia:
+      style:
+        fontFamily: Caladea
+        fontStyle: italic
+        fontSize: 10.6
+        lineHeight: 1.45
+        textAlign: left
+        color: "#3a3732"
+        backgroundColor: "#ffffff"
+        borderWidth: 0
+        borderLeftWidth: 0
+        borderLeftColor: "#b1a795"
+        paddingTop: 5
+        paddingBottom: 5
+        paddingLeft: 10
+        paddingRight: 6
+        marginTop: 0
+        marginBottom: 8
+`;
+var DEFAULT_LITERATURE_THEME_YAML = `
+layout:
+  fontFamily: Caladea
+  fontSize: 10.6
+  lineHeight: 1.52
+  pageSize:
+    width: 396
+    height: 612
+  margins:
+    top: 64
+    right: 54
+    bottom: 62
+    left: 54
+  hyphenation: soft
+  justifyEngine: advanced
+  justifyStrategy: auto
+
+footer:
+  default:
+    elements:
+      - type: paragraph
+        content: "{pageNumber}"
+        properties:
+          style:
+            textAlign: center
+            fontSize: 9
+            color: "#666666"
+            fontFamily: Caladea
+            marginTop: 31
+
+styles:
+  paragraph:
+    textAlign: left
+    marginBottom: 8.6
+    hyphenation: "off"
+    justifyEngine: legacy
+  heading-1:
+    fontSize: 20.8
+    marginTop: 9.4
+    marginBottom: 9
+    hyphenation: "off"
+    textAlign: left
+  heading-2:
+    fontSize: 16.2
+    marginTop: 5.4
+    marginBottom: 7
+    hyphenation: "off"
+    textAlign: left
+  heading-3:
+    fontSize: 13.9
+    marginTop: 5.4
+    marginBottom: 6
+    hyphenation: "off"
+    textAlign: left
+  inline-code:
+    fontFamily: Caladea
+    fontStyle: italic
+    fontSize: 11
+    backgroundColor: "#ffffff"
+  blockquote:
+    textAlign: left
+    fontStyle: italic
+    fontSize: 10.4
+    lineHeight: 1.45
+    color: "#2b2a28"
+    paddingLeft: 18
+    paddingRight: 8
+    borderLeftWidth: 0
+    marginTop: 0
+    marginBottom: 9
+  blockquote-attribution:
+    textAlign: right
+    fontStyle: normal
+    fontSize: 9.8
+    color: "#47443f"
+    marginTop: 2
+    marginBottom: 7
+  references-heading:
+    hyphenation: "off"
+    textAlign: left
+    fontSize: 12.4
+    marginTop: 3.4
+    marginBottom: 5
+  references-item:
+    textAlign: left
+    hyphenation: "off"
+    lineHeight: 1.3
+    fontSize: 9.8
+    marginBottom: 3
+    paddingLeft: 12
+    textIndent: -12
+  list-item-ordered-0:
+    textAlign: left
+    hyphenation: "off"
+    justifyEngine: legacy
+    marginBottom: 3.6
+  list-item-ordered-1:
+    textAlign: left
+    hyphenation: "off"
+    justifyEngine: legacy
+    marginBottom: 3.2
+  list-item-unordered-0:
+    textAlign: left
+    hyphenation: "off"
+    justifyEngine: legacy
+    marginBottom: 3.6
+  list-item-unordered-1:
+    textAlign: left
+    hyphenation: "off"
+    justifyEngine: legacy
+    marginBottom: 3.2
+  definition-term:
+    fontStyle: italic
+    fontWeight: 700
+    keepWithNext: true
+    marginTop: 0
+    marginBottom: 1.2
+  definition-desc:
+    paddingLeft: 14
+    marginTop: 0
+    marginBottom: 5.4
+  table-cell:
+    paddingTop: 4
+    paddingBottom: 4
+    paddingLeft: 5
+    paddingRight: 5
+    borderWidth: 0.6
+    borderColor: "#111111"
+`;
+function transmute(markdown, options) {
+  return (0, import_markdown_core.transmuteMarkdown)(markdown, {
+    theme: options?.theme ?? DEFAULT_LITERATURE_THEME_YAML,
+    config: options?.config,
+    baseConfig: DEFAULT_LITERATURE_CONFIG_YAML,
+    resolveImage: options?.resolveImage
+  });
+}
+var transmuter = {
+  transmute,
+  getBoilerplate() {
+    return [
+      "# Literature Settings",
+      "# literature:",
+      "#   dropCap:",
+      "#     enabled: true",
+      "#     lines: 3",
+      "#",
+      "# typography:",
+      "#   smartQuotes: true"
+    ].join("\n");
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_LITERATURE_CONFIG_YAML,
+  DEFAULT_LITERATURE_THEME_YAML,
+  transmute,
+  transmuter
+});

package/dist/index.mjs

@@ -0,0 +1,339 @@
+// src/index.ts
+import {
+  transmuteMarkdown
+} from "@vmprint/markdown-core";
+var DEFAULT_LITERATURE_CONFIG_YAML = `
+list:
+  textIndentPerLevel: 15
+  markerGap: 5
+  itemSpacingAfter: 3.6
+  tightItemSpacingAfter: 1.2
+  continuationIndentLevels: 0
+  unorderedMarkers:
+    - "\u2014"
+    - "\u2014"
+    - "\u2014"
+  orderedMarkers:
+    - upper-roman
+    - decimal
+    - lower-alpha
+  taskMarkers:
+    checked: "[done]"
+    unchecked: "[ ]"
+
+links:
+  mode: citation
+  dedupe: true
+  citationStyle: bracket
+
+references:
+  enabled: true
+  heading: Notes
+  numberingStyle: lower-roman
+  includeLinkTitle: true
+
+blockquote:
+  attribution:
+    enabled: true
+    markerPattern: '^[-\u2014\u2013]{1,2}s+'
+
+title:
+  subheading:
+    enabled: false
+    markerPattern: '^::s+'
+    requireMarker: true
+    stripMarker: true
+    applyToFirstH1Only: true
+    keepWithNext: true
+
+images:
+  blockStyle:
+    width: 286
+    marginTop: 5.4
+    marginBottom: 5
+    borderWidth: 0
+    borderRadius: 0
+    paddingTop: 0
+    paddingBottom: 0
+    paddingLeft: 0
+    paddingRight: 0
+  frame:
+    mode: "off"
+    markerPattern: '\b(frame|framed)\b'
+    style: {}
+
+captions:
+  pattern: '^(Plate|Figure|Fig.|Source)s+([0-9]+|[IVXLC]+)\b'
+  blockquoteUnderImageAsFigureCaption: false
+  style:
+    textAlign: left
+    hyphenation: "off"
+    fontStyle: italic
+    fontSize: 9.8
+    lineHeight: 1.3
+    color: "#47443f"
+    marginTop: 0
+    marginBottom: 9
+
+tables:
+  zebra: false
+  headerColor: "#f3f4f6"
+
+codeBlocks:
+  defaultMode: extract
+  languageModes:
+    verse: verse
+    poetry: verse
+    poem: verse
+    extract: extract
+    archive: extract
+    epigraph: epigraph
+    letter: letter
+    marginalia: marginalia
+  modes:
+    verse:
+      style:
+        fontFamily: Caladea
+        fontStyle: italic
+        fontSize: 11.6
+        lineHeight: 1.58
+        textAlign: left
+        color: "#252422"
+        backgroundColor: "#ffffff"
+        borderWidth: 0
+        borderLeftWidth: 0
+        borderLeftColor: "#96928a"
+        paddingTop: 6
+        paddingBottom: 6
+        paddingLeft: 18
+        paddingRight: 8
+        marginTop: 0.4
+        marginBottom: 10
+    extract:
+      style:
+        fontFamily: Caladea
+        fontStyle: italic
+        fontSize: 11.2
+        lineHeight: 1.5
+        textAlign: left
+        color: "#2a2a2a"
+        backgroundColor: "#ffffff"
+        borderWidth: 0
+        borderLeftWidth: 0
+        borderLeftColor: "#8d8a84"
+        paddingTop: 6
+        paddingBottom: 6
+        paddingLeft: 14
+        paddingRight: 8
+        marginTop: 0
+        marginBottom: 10
+    epigraph:
+      style:
+        fontFamily: Caladea
+        fontStyle: italic
+        fontSize: 11
+        lineHeight: 1.5
+        textAlign: center
+        color: "#2f2c28"
+        backgroundColor: "#ffffff"
+        borderWidth: 0
+        paddingTop: 5
+        paddingBottom: 5
+        paddingLeft: 20
+        paddingRight: 20
+        marginTop: 1.4
+        marginBottom: 10
+    letter:
+      style:
+        fontFamily: Caladea
+        fontStyle: normal
+        fontSize: 11.2
+        lineHeight: 1.5
+        textAlign: left
+        color: "#252525"
+        backgroundColor: "#ffffff"
+        borderWidth: 0
+        borderColor: "#cfcbc2"
+        paddingTop: 7
+        paddingBottom: 7
+        paddingLeft: 10
+        paddingRight: 10
+        marginTop: 0
+        marginBottom: 10
+    marginalia:
+      style:
+        fontFamily: Caladea
+        fontStyle: italic
+        fontSize: 10.6
+        lineHeight: 1.45
+        textAlign: left
+        color: "#3a3732"
+        backgroundColor: "#ffffff"
+        borderWidth: 0
+        borderLeftWidth: 0
+        borderLeftColor: "#b1a795"
+        paddingTop: 5
+        paddingBottom: 5
+        paddingLeft: 10
+        paddingRight: 6
+        marginTop: 0
+        marginBottom: 8
+`;
+var DEFAULT_LITERATURE_THEME_YAML = `
+layout:
+  fontFamily: Caladea
+  fontSize: 10.6
+  lineHeight: 1.52
+  pageSize:
+    width: 396
+    height: 612
+  margins:
+    top: 64
+    right: 54
+    bottom: 62
+    left: 54
+  hyphenation: soft
+  justifyEngine: advanced
+  justifyStrategy: auto
+
+footer:
+  default:
+    elements:
+      - type: paragraph
+        content: "{pageNumber}"
+        properties:
+          style:
+            textAlign: center
+            fontSize: 9
+            color: "#666666"
+            fontFamily: Caladea
+            marginTop: 31
+
+styles:
+  paragraph:
+    textAlign: left
+    marginBottom: 8.6
+    hyphenation: "off"
+    justifyEngine: legacy
+  heading-1:
+    fontSize: 20.8
+    marginTop: 9.4
+    marginBottom: 9
+    hyphenation: "off"
+    textAlign: left
+  heading-2:
+    fontSize: 16.2
+    marginTop: 5.4
+    marginBottom: 7
+    hyphenation: "off"
+    textAlign: left
+  heading-3:
+    fontSize: 13.9
+    marginTop: 5.4
+    marginBottom: 6
+    hyphenation: "off"
+    textAlign: left
+  inline-code:
+    fontFamily: Caladea
+    fontStyle: italic
+    fontSize: 11
+    backgroundColor: "#ffffff"
+  blockquote:
+    textAlign: left
+    fontStyle: italic
+    fontSize: 10.4
+    lineHeight: 1.45
+    color: "#2b2a28"
+    paddingLeft: 18
+    paddingRight: 8
+    borderLeftWidth: 0
+    marginTop: 0
+    marginBottom: 9
+  blockquote-attribution:
+    textAlign: right
+    fontStyle: normal
+    fontSize: 9.8
+    color: "#47443f"
+    marginTop: 2
+    marginBottom: 7
+  references-heading:
+    hyphenation: "off"
+    textAlign: left
+    fontSize: 12.4
+    marginTop: 3.4
+    marginBottom: 5
+  references-item:
+    textAlign: left
+    hyphenation: "off"
+    lineHeight: 1.3
+    fontSize: 9.8
+    marginBottom: 3
+    paddingLeft: 12
+    textIndent: -12
+  list-item-ordered-0:
+    textAlign: left
+    hyphenation: "off"
+    justifyEngine: legacy
+    marginBottom: 3.6
+  list-item-ordered-1:
+    textAlign: left
+    hyphenation: "off"
+    justifyEngine: legacy
+    marginBottom: 3.2
+  list-item-unordered-0:
+    textAlign: left
+    hyphenation: "off"
+    justifyEngine: legacy
+    marginBottom: 3.6
+  list-item-unordered-1:
+    textAlign: left
+    hyphenation: "off"
+    justifyEngine: legacy
+    marginBottom: 3.2
+  definition-term:
+    fontStyle: italic
+    fontWeight: 700
+    keepWithNext: true
+    marginTop: 0
+    marginBottom: 1.2
+  definition-desc:
+    paddingLeft: 14
+    marginTop: 0
+    marginBottom: 5.4
+  table-cell:
+    paddingTop: 4
+    paddingBottom: 4
+    paddingLeft: 5
+    paddingRight: 5
+    borderWidth: 0.6
+    borderColor: "#111111"
+`;
+function transmute(markdown, options) {
+  return transmuteMarkdown(markdown, {
+    theme: options?.theme ?? DEFAULT_LITERATURE_THEME_YAML,
+    config: options?.config,
+    baseConfig: DEFAULT_LITERATURE_CONFIG_YAML,
+    resolveImage: options?.resolveImage
+  });
+}
+var transmuter = {
+  transmute,
+  getBoilerplate() {
+    return [
+      "# Literature Settings",
+      "# literature:",
+      "#   dropCap:",
+      "#     enabled: true",
+      "#     lines: 3",
+      "#",
+      "# typography:",
+      "#   smartQuotes: true"
+    ].join("\n");
+  }
+};
+export {
+  DEFAULT_LITERATURE_CONFIG_YAML,
+  DEFAULT_LITERATURE_THEME_YAML,
+  transmute,
+  transmuter
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@vmprint/mkd-literature",
+  "version": "1.0.0",
+  "description": "Markdown → VMPrint DocumentInput transmuter with literature defaults.",
+  "author": "cosmiciron",
+  "license": "Apache-2.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "source": "src/index.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build:js": "esbuild src/index.ts --bundle --platform=node --target=node18 --external:@vmprint/contracts --external:@vmprint/markdown-core --outfile=dist/index.js",
+    "build:mjs": "esbuild src/index.ts --bundle --platform=node --target=node18 --format=esm --external:@vmprint/contracts --external:@vmprint/markdown-core --outfile=dist/index.mjs",
+    "build:dts": "dts-bundle-generator --no-check src/index.ts -o dist/index.d.ts",
+    "build": "rimraf dist && npm run build:js && npm run build:mjs && npm run build:dts",
+    "dev": "tsx src/index.ts",
+    "clean": "rimraf dist"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@vmprint/markdown-core": "^1.0.0",
+    "@vmprint/contracts": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.25.0",
+    "rimraf": "^6.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.3"
+  }
+}