@difizen/libro-markdown 0.0.2-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023-present Difizen Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# libro shared model

package/es/anchor.d.ts

@@ -0,0 +1,42 @@
+import type { PluginWithOptions } from 'markdown-it';
+import type State from 'markdown-it/lib/rules_core/state_core.js';
+import type Token from 'markdown-it/lib/token.js';
+export type RenderHref = (slug: string, state: State) => string;
+export type RenderAttrs = (slug: string, state: State) => Record<string, string | number>;
+export interface PermalinkOptions {
+    class: string;
+    symbol: string;
+    renderHref: RenderHref;
+    renderAttrs: RenderAttrs;
+    space: boolean;
+    placement: keyof typeof position;
+    ariaHidden: boolean;
+}
+export declare function renderHref(slug: string): string;
+export declare function renderAttrs(_slug: string): {};
+declare const position: {
+    readonly false: "push";
+    readonly true: "unshift";
+    readonly after: "push";
+    readonly before: "unshift";
+};
+export type PermalinkGenerator = (slug: string, opts: Partial<PermalinkOptions>, state: State, index: number) => void;
+export declare const linkInsideHeader: PermalinkGenerator;
+interface AnchorOptions {
+    level: number;
+    slugify: (val: string) => string;
+    getTokensText(tokens: Token[]): string;
+    uniqueSlugStartIndex: number;
+    tabIndex: string | false;
+    permalink: PermalinkGenerator;
+    permalinkOptions: Partial<PermalinkOptions>;
+}
+export declare const slugify: (s: string) => string;
+/**
+ * fork from markdown-it-anchor
+ * @param md
+ * @param options
+ */
+export declare const libroAnchor: PluginWithOptions<Partial<AnchorOptions>>;
+export {};
+//# sourceMappingURL=anchor.d.ts.map

package/es/anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../src/anchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,KAAK,MAAM,0CAA0C,CAAC;AAClE,OAAO,KAAK,KAAK,MAAM,0BAA0B,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,KACT,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,OAAO,QAAQ,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,UAEtC;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,MAExC;AAgBD,QAAA,MAAM,QAAQ;;;;;CAKJ,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAC/B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,MAAM,KACV,IAAI,CAAC;AAEV,eAAO,MAAM,gBAAgB,EAAE,kBA2B9B,CAAC;AAIF,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACvC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;IACzB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC7C;AAED,eAAO,MAAM,OAAO,MAAO,MAAM,WACwC,CAAC;AAiD1E;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,iBAAiB,CAAC,OAAO,CAAC,aAAa,CAAC,CAoDjE,CAAC"}

package/es/anchor.js

@@ -0,0 +1,153 @@
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+export function renderHref(slug) {
+  return "#".concat(slug);
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function renderAttrs(_slug) {
+  return {};
+}
+var commonDefaults = {
+  class: 'header-anchor',
+  symbol: '#',
+  renderHref: renderHref,
+  renderAttrs: renderAttrs,
+  space: true,
+  placement: 'after',
+  ariaHidden: false
+};
+var permalinkSymbolMeta = {
+  isPermalinkSymbol: true
+};
+var position = {
+  false: 'push',
+  true: 'unshift',
+  after: 'push',
+  before: 'unshift'
+};
+export var linkInsideHeader = function linkInsideHeader(slug, options, state, idx) {
+  var _state$tokens$childre2;
+  var opts = _objectSpread(_objectSpread({}, commonDefaults), options);
+  var linkTokens = [Object.assign(new state.Token('link_open', 'a', 1), {
+    attrs: [].concat(_toConsumableArray(opts.class ? [['class', opts.class]] : []), [['href', opts.renderHref(slug, state)]], _toConsumableArray(opts.ariaHidden ? [['aria-hidden', 'true']] : []), _toConsumableArray(Object.entries(opts.renderAttrs(slug, state))))
+  }), Object.assign(new state.Token('html_inline', '', 0), {
+    content: opts.symbol,
+    meta: permalinkSymbolMeta
+  }), new state.Token('link_close', 'a', -1)];
+  if (opts.space) {
+    var _state$tokens$childre;
+    var space = typeof opts.space === 'string' ? opts.space : ' ';
+    var type = typeof opts.space === 'string' ? 'html_inline' : 'text';
+    (_state$tokens$childre = state.tokens[idx + 1].children) === null || _state$tokens$childre === void 0 ? void 0 : _state$tokens$childre[position[opts.placement]](Object.assign(new state.Token(type, '', 0), {
+      content: space
+    }));
+  }
+  (_state$tokens$childre2 = state.tokens[idx + 1].children) === null || _state$tokens$childre2 === void 0 ? void 0 : _state$tokens$childre2[position[opts.placement]].apply(_state$tokens$childre2, linkTokens);
+};
+
+//// anchor
+
+export var slugify = function slugify(s) {
+  return encodeURIComponent(String(s).trim().toLowerCase().replace(/\s+/g, '-'));
+};
+function getTokensText(tokens) {
+  return tokens.filter(function (t) {
+    return ['text', 'code_inline'].includes(t.type);
+  }).map(function (t) {
+    return t.content;
+  }).join('');
+}
+function uniqueSlug(slug, slugs, failOnNonUnique, startIndex) {
+  var uniq = slug;
+  var i = startIndex;
+  if (failOnNonUnique && Object.prototype.hasOwnProperty.call(slugs, uniq)) {
+    throw new Error("User defined `id` attribute `".concat(slug, "` is not unique. Please fix it in your Markdown to continue."));
+  } else {
+    while (Object.prototype.hasOwnProperty.call(slugs, uniq)) {
+      uniq = "".concat(slug, "-").concat(i);
+      i += 1;
+    }
+  }
+  slugs[uniq] = true;
+  return uniq;
+}
+var isLevelSelectedNumber = function isLevelSelectedNumber(selection) {
+  return function (level) {
+    return level >= selection;
+  };
+};
+var isLevelSelectedArray = function isLevelSelectedArray(selection) {
+  return function (level) {
+    return selection.includes(level);
+  };
+};
+var defaultOptions = {
+  level: 1,
+  slugify: slugify,
+  uniqueSlugStartIndex: 1,
+  tabIndex: '-1',
+  getTokensText: getTokensText,
+  permalink: linkInsideHeader,
+  permalinkOptions: {}
+};
+
+/**
+ * fork from markdown-it-anchor
+ * @param md
+ * @param options
+ */
+export var libroAnchor = function libroAnchor(md, options) {
+  var opts = _objectSpread(_objectSpread({}, defaultOptions), options);
+  md.core.ruler.push('anchor', function (state) {
+    var _state$env;
+    var slugs = {};
+    var tokens = state.tokens;
+    var cellId = (_state$env = state.env) === null || _state$env === void 0 ? void 0 : _state$env.cellId;
+    var isLevelSelected = Array.isArray(opts.level) ? isLevelSelectedArray(opts.level) : isLevelSelectedNumber(opts.level);
+    for (var idx = 0; idx < tokens.length; idx++) {
+      var _tokens$children;
+      var token = tokens[idx];
+      if (token.type !== 'heading_open') {
+        continue;
+      }
+      if (!isLevelSelected(Number(token.tag.substr(1)))) {
+        continue;
+      }
+
+      // Aggregate the next token children text.
+      var title = opts.getTokensText((_tokens$children = tokens[idx + 1].children) !== null && _tokens$children !== void 0 ? _tokens$children : []);
+      var _slug2 = token.attrGet('id');
+      if (_slug2 === null) {
+        _slug2 = uniqueSlug(opts.slugify(title), slugs, false, opts.uniqueSlugStartIndex);
+      } else {
+        _slug2 = uniqueSlug(_slug2, slugs, true, opts.uniqueSlugStartIndex);
+      }
+      if (cellId) {
+        token.attrSet('id', "".concat(cellId, "-").concat(_slug2));
+      } else {
+        token.attrSet('id', _slug2);
+      }
+      if (opts.tabIndex !== false) {
+        token.attrSet('tabindex', "".concat(opts.tabIndex));
+      }
+      if (typeof opts.permalink === 'function') {
+        opts.permalink(_slug2, opts.permalinkOptions, state, idx);
+      }
+
+      // A permalink renderer could modify the `tokens` array so
+      // make sure to get the up-to-date index on each iteration.
+      idx = tokens.indexOf(token);
+    }
+  });
+};

package/es/index.d.ts

@@ -0,0 +1,5 @@
+export * from './anchor.js';
+export * from './markdown-protocol.js';
+export * from './markdown-render.js';
+export * from './module.js';
+//# sourceMappingURL=index.d.ts.map

package/es/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC"}

package/es/index.js

@@ -0,0 +1,4 @@
+export * from "./anchor.js";
+export * from "./markdown-protocol.js";
+export * from "./markdown-render.js";
+export * from "./module.js";

package/es/markdown-protocol.d.ts

@@ -0,0 +1,18 @@
+export declare const MarkdownParser: unique symbol;
+export interface MarkdownRenderOption {
+    cellId?: string;
+}
+/**
+ * The interface for a Markdown parser.
+ */
+export interface MarkdownParser {
+    /**
+     * Render a markdown source.
+     *
+     * @param source - The string to render.
+     * @returns - string.
+     */
+    render(source: string, options?: MarkdownRenderOption): string;
+    slugify: (val: string) => string;
+}
+//# sourceMappingURL=markdown-protocol.d.ts.map

package/es/markdown-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-protocol.d.ts","sourceRoot":"","sources":["../src/markdown-protocol.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAAC;IAE/D,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAClC"}

package/es/markdown-protocol.js

@@ -0,0 +1,5 @@
+export var MarkdownParser = Symbol('MarkdownParser');
+
+/**
+ * The interface for a Markdown parser.
+ */

package/es/markdown-render.d.ts

@@ -0,0 +1,11 @@
+import MarkdownIt from 'markdown-it';
+import type { MarkdownRenderOption } from './markdown-protocol.js';
+import { MarkdownParser } from './markdown-protocol.js';
+export declare class MarkdownRender implements MarkdownParser {
+    protected mkt: MarkdownIt;
+    slugify: (s: string) => string;
+    enablePermalink: boolean;
+    init(): void;
+    render(markdownText: string, options?: MarkdownRenderOption): string;
+}
+//# sourceMappingURL=markdown-render.d.ts.map

package/es/markdown-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-render.d.ts","sourceRoot":"","sources":["../src/markdown-render.ts"],"names":[],"mappings":"AACA,OAAO,UAAU,MAAM,aAAa,CAAC;AAGrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,qBACa,cAAe,YAAW,cAAc;IACnD,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC;IAC1B,OAAO,wBAAW;IAClB,eAAe,UAAS;IAGxB,IAAI;IAaJ,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;CAIrE"}

package/es/markdown-render.js

@@ -0,0 +1,48 @@
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+var _dec, _dec2, _class, _class2;
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _applyDecoratedDescriptor(target, property, decorators, descriptor, context) { var desc = {}; Object.keys(descriptor).forEach(function (key) { desc[key] = descriptor[key]; }); desc.enumerable = !!desc.enumerable; desc.configurable = !!desc.configurable; if ('value' in desc || desc.initializer) { desc.writable = true; } desc = decorators.slice().reverse().reduce(function (desc, decorator) { return decorator(target, property, desc) || desc; }, desc); if (context && desc.initializer !== void 0) { desc.value = desc.initializer ? desc.initializer.call(context) : void 0; desc.initializer = undefined; } if (desc.initializer === void 0) { Object.defineProperty(target, property, desc); desc = null; } return desc; }
+import { postConstruct, singleton } from '@difizen/mana-app';
+import MarkdownIt from 'markdown-it';
+import { libroAnchor, linkInsideHeader, slugify } from "./anchor.js";
+import { MarkdownParser } from "./markdown-protocol.js";
+export var MarkdownRender = (_dec = singleton({
+  token: MarkdownParser
+}), _dec2 = postConstruct(), _dec(_class = (_class2 = /*#__PURE__*/function () {
+  function MarkdownRender() {
+    _classCallCheck(this, MarkdownRender);
+    this.slugify = slugify;
+    this.enablePermalink = false;
+  }
+  _createClass(MarkdownRender, [{
+    key: "init",
+    value: function init() {
+      this.mkt = new MarkdownIt({
+        html: true,
+        linkify: true
+      });
+      this.mkt.linkify.set({
+        fuzzyLink: false
+      });
+      this.mkt.use(libroAnchor, {
+        permalinkOptions: {
+          class: 'libro-InternalAnchorLink',
+          space: false
+        },
+        permalink: this.enablePermalink ? linkInsideHeader : false,
+        slugify: this.slugify
+      });
+    }
+  }, {
+    key: "render",
+    value: function render(markdownText, options) {
+      var unsanitizedRenderedMarkdown = this.mkt.render(markdownText, options);
+      return unsanitizedRenderedMarkdown;
+    }
+  }]);
+  return MarkdownRender;
+}(), (_applyDecoratedDescriptor(_class2.prototype, "init", [_dec2], Object.getOwnPropertyDescriptor(_class2.prototype, "init"), _class2.prototype)), _class2)) || _class);

package/es/module.d.ts

@@ -0,0 +1,3 @@
+import { ManaModule } from '@difizen/mana-app';
+export declare const MarkdownModule: ManaModule;
+//# sourceMappingURL=module.d.ts.map

package/es/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/C,eAAO,MAAM,cAAc,YAG1B,CAAC"}

package/es/module.js

@@ -0,0 +1,4 @@
+import { ManaModule } from '@difizen/mana-app';
+import { MarkdownParser } from "./markdown-protocol.js";
+import { MarkdownRender } from "./markdown-render.js";
+export var MarkdownModule = ManaModule.create().register(MarkdownParser, MarkdownRender);

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@difizen/libro-markdown",
+  "version": "0.0.2-alpha.0",
+  "description": "",
+  "keywords": [
+    "libro",
+    "notebook",
+    "toc"
+  ],
+  "repository": "git@github.com:difizen/libro.git",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "typings": "./es/index.d.ts",
+      "default": "./es/index.js"
+    },
+    "./mock": {
+      "typings": "./es/mock/index.d.ts",
+      "default": "./es/mock/index.js"
+    },
+    "./es/mock": {
+      "typings": "./es/mock/index.d.ts",
+      "default": "./es/mock/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "es/index.js",
+  "module": "es/index.js",
+  "typings": "es/index.d.ts",
+  "files": [
+    "es",
+    "src"
+  ],
+  "dependencies": {
+    "@difizen/mana-app": "alpha",
+    "@types/markdown-it": "^12.2.3",
+    "markdown-it": "^13.0.1",
+    "markdown-it-anchor": "^8.6.5"
+  },
+  "scripts": {
+    "setup": "father build",
+    "build": "father build",
+    "test": ": Note: lint task is delegated to test:* scripts",
+    "test:vitest": "vitest run",
+    "test:jest": "jest",
+    "coverage": ": Note: lint task is delegated to coverage:* scripts",
+    "coverage:vitest": "vitest run --coverage",
+    "coverage:jest": "jest --coverage",
+    "lint": ": Note: lint task is delegated to lint:* scripts",
+    "lint:eslint": "eslint src",
+    "lint:tsc": "tsc --noEmit"
+  }
+}

package/src/anchor.ts

@@ -0,0 +1,206 @@
+import type { PluginWithOptions } from 'markdown-it';
+import type State from 'markdown-it/lib/rules_core/state_core.js';
+import type Token from 'markdown-it/lib/token.js';
+
+export type RenderHref = (slug: string, state: State) => string;
+export type RenderAttrs = (
+  slug: string,
+  state: State,
+) => Record<string, string | number>;
+
+export interface PermalinkOptions {
+  class: string;
+  symbol: string;
+  renderHref: RenderHref;
+  renderAttrs: RenderAttrs;
+  space: boolean;
+  placement: keyof typeof position;
+  ariaHidden: boolean;
+}
+
+export function renderHref(slug: string) {
+  return `#${slug}`;
+}
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function renderAttrs(_slug: string) {
+  return {};
+}
+
+const commonDefaults: PermalinkOptions = {
+  class: 'header-anchor',
+  symbol: '#',
+  renderHref,
+  renderAttrs,
+  space: true,
+  placement: 'after',
+  ariaHidden: false,
+};
+
+const permalinkSymbolMeta = {
+  isPermalinkSymbol: true,
+};
+
+const position = {
+  false: 'push',
+  true: 'unshift',
+  after: 'push',
+  before: 'unshift',
+} as const;
+
+export type PermalinkGenerator = (
+  slug: string,
+  opts: Partial<PermalinkOptions>,
+  state: State,
+  index: number,
+) => void;
+
+export const linkInsideHeader: PermalinkGenerator = (slug, options, state, idx) => {
+  const opts = { ...commonDefaults, ...options };
+  const linkTokens = [
+    Object.assign(new state.Token('link_open', 'a', 1), {
+      attrs: [
+        ...(opts.class ? [['class', opts.class]] : []),
+        ['href', opts.renderHref(slug, state)],
+        ...(opts.ariaHidden ? [['aria-hidden', 'true']] : []),
+        ...Object.entries(opts.renderAttrs(slug, state)),
+      ],
+    }),
+    Object.assign(new state.Token('html_inline', '', 0), {
+      content: opts.symbol,
+      meta: permalinkSymbolMeta,
+    }),
+    new state.Token('link_close', 'a', -1),
+  ];
+
+  if (opts.space) {
+    const space = typeof opts.space === 'string' ? opts.space : ' ';
+    const type = typeof opts.space === 'string' ? 'html_inline' : 'text';
+    state.tokens[idx + 1].children?.[position[opts.placement]](
+      Object.assign(new state.Token(type, '', 0), { content: space }),
+    );
+  }
+
+  state.tokens[idx + 1].children?.[position[opts.placement]](...linkTokens);
+};
+
+//// anchor
+
+interface AnchorOptions {
+  level: number;
+  slugify: (val: string) => string;
+  getTokensText(tokens: Token[]): string;
+  uniqueSlugStartIndex: number;
+  tabIndex: string | false;
+  permalink: PermalinkGenerator;
+  permalinkOptions: Partial<PermalinkOptions>;
+}
+
+export const slugify = (s: string) =>
+  encodeURIComponent(String(s).trim().toLowerCase().replace(/\s+/g, '-'));
+
+function getTokensText(tokens: Token[]) {
+  return tokens
+    .filter((t) => ['text', 'code_inline'].includes(t.type))
+    .map((t) => t.content)
+    .join('');
+}
+
+function uniqueSlug(
+  slug: string,
+  slugs: Record<string, boolean>,
+  failOnNonUnique: boolean,
+  startIndex: number,
+) {
+  let uniq = slug;
+  let i = startIndex;
+
+  if (failOnNonUnique && Object.prototype.hasOwnProperty.call(slugs, uniq)) {
+    throw new Error(
+      `User defined \`id\` attribute \`${slug}\` is not unique. Please fix it in your Markdown to continue.`,
+    );
+  } else {
+    while (Object.prototype.hasOwnProperty.call(slugs, uniq)) {
+      uniq = `${slug}-${i}`;
+      i += 1;
+    }
+  }
+
+  slugs[uniq] = true;
+
+  return uniq;
+}
+
+const isLevelSelectedNumber = (selection: number) => (level: number) =>
+  level >= selection;
+const isLevelSelectedArray = (selection: number[]) => (level: number) =>
+  selection.includes(level);
+
+const defaultOptions: AnchorOptions = {
+  level: 1,
+  slugify,
+  uniqueSlugStartIndex: 1,
+  tabIndex: '-1',
+  getTokensText,
+  permalink: linkInsideHeader,
+  permalinkOptions: {},
+};
+
+/**
+ * fork from markdown-it-anchor
+ * @param md
+ * @param options
+ */
+export const libroAnchor: PluginWithOptions<Partial<AnchorOptions>> = (md, options) => {
+  const opts = { ...defaultOptions, ...options };
+  md.core.ruler.push('anchor', (state) => {
+    const slugs: Record<string, boolean> = {};
+    const tokens = state.tokens;
+    const cellId = state.env?.cellId as string | undefined;
+
+    const isLevelSelected = Array.isArray(opts.level)
+      ? isLevelSelectedArray(opts.level)
+      : isLevelSelectedNumber(opts.level);
+
+    for (let idx = 0; idx < tokens.length; idx++) {
+      const token = tokens[idx];
+
+      if (token.type !== 'heading_open') {
+        continue;
+      }
+
+      if (!isLevelSelected(Number(token.tag.substr(1)))) {
+        continue;
+      }
+
+      // Aggregate the next token children text.
+      const title = opts.getTokensText(tokens[idx + 1].children ?? []);
+
+      let slug = token.attrGet('id');
+
+      if (slug === null) {
+        slug = uniqueSlug(opts.slugify(title), slugs, false, opts.uniqueSlugStartIndex);
+      } else {
+        slug = uniqueSlug(slug, slugs, true, opts.uniqueSlugStartIndex);
+      }
+
+      if (cellId) {
+        token.attrSet('id', `${cellId}-${slug}`);
+      } else {
+        token.attrSet('id', slug);
+      }
+
+      if (opts.tabIndex !== false) {
+        token.attrSet('tabindex', `${opts.tabIndex}`);
+      }
+
+      if (typeof opts.permalink === 'function') {
+        opts.permalink(slug, opts.permalinkOptions, state, idx);
+      }
+
+      // A permalink renderer could modify the `tokens` array so
+      // make sure to get the up-to-date index on each iteration.
+      idx = tokens.indexOf(token);
+    }
+  });
+};

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from './anchor.js';
+export * from './markdown-protocol.js';
+export * from './markdown-render.js';
+export * from './module.js';

package/src/markdown-protocol.ts

@@ -0,0 +1,20 @@
+export const MarkdownParser = Symbol('MarkdownParser');
+
+export interface MarkdownRenderOption {
+  cellId?: string;
+}
+
+/**
+ * The interface for a Markdown parser.
+ */
+export interface MarkdownParser {
+  /**
+   * Render a markdown source.
+   *
+   * @param source - The string to render.
+   * @returns - string.
+   */
+  render(source: string, options?: MarkdownRenderOption): string;
+
+  slugify: (val: string) => string;
+}

package/src/markdown-render.ts

@@ -0,0 +1,32 @@
+import { postConstruct, singleton } from '@difizen/mana-app';
+import MarkdownIt from 'markdown-it';
+
+import { libroAnchor, linkInsideHeader, slugify } from './anchor.js';
+import type { MarkdownRenderOption } from './markdown-protocol.js';
+import { MarkdownParser } from './markdown-protocol.js';
+
+@singleton({ token: MarkdownParser })
+export class MarkdownRender implements MarkdownParser {
+  protected mkt: MarkdownIt;
+  slugify = slugify;
+  enablePermalink = false;
+
+  @postConstruct()
+  init() {
+    this.mkt = new MarkdownIt({
+      html: true,
+      linkify: true,
+    });
+    this.mkt.linkify.set({ fuzzyLink: false });
+    this.mkt.use(libroAnchor, {
+      permalinkOptions: { class: 'libro-InternalAnchorLink', space: false },
+      permalink: this.enablePermalink ? linkInsideHeader : false,
+      slugify: this.slugify,
+    });
+  }
+
+  render(markdownText: string, options?: MarkdownRenderOption): string {
+    const unsanitizedRenderedMarkdown = this.mkt.render(markdownText, options);
+    return unsanitizedRenderedMarkdown;
+  }
+}

package/src/module.ts

@@ -0,0 +1,9 @@
+import { ManaModule } from '@difizen/mana-app';
+
+import { MarkdownParser } from './markdown-protocol.js';
+import { MarkdownRender } from './markdown-render.js';
+
+export const MarkdownModule = ManaModule.create().register(
+  MarkdownParser,
+  MarkdownRender,
+);