@primeui-devkit/lit-markdown 0.1.0-beta.1

package/LICENSE.md

@@ -0,0 +1,45 @@
+# PrimeUI License
+
+This package is part of **PrimeUI**, a family of commercial UI libraries by PrimeTek Informatics.
+
+## How PrimeUI May Be Used
+
+PrimeUI may be used under one of two licenses. You choose the one that applies to you based on eligibility.
+
+### Community License (Free)
+
+Free for organizations that meet all of the following criteria:
+
+- Less than $1,000,000 USD in annual gross revenue
+- Fewer than 5 developers
+- Fewer than 10 employees
+- Less than $3,000,000 USD in venture capital or outside funding
+
+Individuals, students, non-profits, and non-commercial open source projects also qualify.
+
+The Community License provides full access to the core libraries and supports up to 4 developers. It requires annual renewal by confirming continued eligibility.
+
+### Commercial License (Paid)
+
+For organizations that do not qualify for the Community License.
+
+Licensed per developer, perpetual, with one year of updates included. Renewal is optional and extends access to new versions. The Commercial Suite also includes PrimeBlocks, Theme Designer, all PrimeUI Pro components, and Premium Support.
+
+## License Key
+
+A valid license key is required to use this software. License verification is performed offline, with no telemetry and no remote connection. A missing, invalid, or expired key may cause the software to display a license notice.
+
+## Full Terms
+
+The complete license terms, eligibility details, and renewal information are available at:
+
+- Community License: <https://primeui.dev/licenses/community>
+- Commercial License: <https://primeui.dev/licenses/commercial>
+
+## Restrictions
+
+This software is distributed as a compiled package. You may not reverse-engineer, decompile, or extract its source code, redistribute it as a component library or development tool, or remove its license mechanisms. Redistributing the software so that third parties can develop with it requires a separate OEM License. See the full terms for details.
+
+---
+
+© 2026 PrimeTek Informatics. All rights reserved.

package/README.md

@@ -0,0 +1,19 @@
+# @primeui-devkit/lit-markdown
+
+Lit renderer for the markdown AST. Renders into light DOM so shared prose
+styles apply; heading anchors, code copy button and table scroll wrapper are
+built in.
+
+```ts
+import { defineLitMarkdown } from '@primeui-devkit/lit-markdown';
+
+defineLitMarkdown(); // registers <lit-markdown>
+
+const el = document.createElement('lit-markdown');
+el.tree = tree; // pre-parsed MarkdownTree (or set el.markdown for runtime parse)
+el.components = { 'demo-viewer': (props, children) => myDemoNode(props) };
+document.body.append(el);
+```
+
+The DOM rebuilds only when `tree`/`markdown`/`components` references change,
+so stateful custom-rendered children survive unrelated updates.

package/THIRD-PARTY-NOTICES.txt

@@ -0,0 +1,36 @@
+# Third-Party Notices
+
+This package uses the following third-party open source software.
+Each is provided under its own license, reproduced below.
+
+---
+
+## comark
+
+Copyright (c) 2026 Comark team and contributors
+
+The markdown parsing engine used (via @primeui-devkit/markdown-core) by this package (https://github.com/comarkdown/comark).
+
+Licensed under the MIT License.
+
+MIT License
+
+Copyright (c) 2026 Comark team and contributors
+
+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/dist/index.d.ts

@@ -0,0 +1,38 @@
+import { MarkdownTree } from '@primeui-devkit/markdown-core';
+import { ReactiveElement } from 'lit';
+
+type MdNode = string | MdElementNode;
+type MdElementNode = [string, Record<string, unknown>, ...MdNode[]];
+/** A custom renderer receives the node's props and already-rendered children and returns a DOM node it owns. */
+type LitComponentRenderer = (props: Record<string, unknown>, children: DocumentFragment, node: MdElementNode) => Node;
+declare function renderNode(node: MdNode, components: Record<string, LitComponentRenderer>): Node;
+declare function renderTree(tree: MarkdownTree, components?: Record<string, LitComponentRenderer>): DocumentFragment;
+/**
+ * <lit-markdown> — renders a pre-parsed tree (or parses `markdown` at runtime).
+ * Light DOM on purpose: the shared prose.css and host styles apply directly.
+ * The DOM is rebuilt ONLY when tree/markdown/components references change, so
+ * stateful custom-rendered children survive unrelated re-renders.
+ */
+declare class LitMarkdown extends ReactiveElement {
+    #private;
+    static properties: {
+        tree: {
+            attribute: boolean;
+        };
+        markdown: {
+            type: StringConstructor;
+        };
+        components: {
+            attribute: boolean;
+        };
+    };
+    tree: MarkdownTree | null;
+    markdown: string;
+    components: Record<string, LitComponentRenderer>;
+    constructor();
+    protected createRenderRoot(): this;
+    protected update(changed: Map<string, unknown>): void;
+}
+declare function defineLitMarkdown(tagName?: string): void;
+
+export { type LitComponentRenderer, LitMarkdown, defineLitMarkdown, renderNode, renderTree };

package/dist/index.js

@@ -0,0 +1 @@
+import {ReactiveElement}from'lit';var u=new Set(["h1","h2","h3","h4","h5","h6"]),f=new Set(["p","a","blockquote","code","em","strong","hr","img","li","ol","ul","table","thead","tbody","tr","th","td"]),p='<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>',h='<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M20 6 9 17l-5-5"/></svg>';function g(n,r){for(let[e,t]of Object.entries(r))t==null||typeof t=="function"||typeof t=="object"||(typeof t=="boolean"?t&&n.setAttribute(e,""):n.setAttribute(e,String(t)));}function w(n,r,e){let t=document.createElement(n);t.className=`prose-${n}`;let c=typeof r.id=="string"?r.id:null;if(c){t.id=c;let s=document.createElement("a");s.href=`#${c}`,s.className="prose-heading-link";let o=document.createElement("span");o.className="prose-heading-anchor",o.textContent="#",s.append(o,e),t.append(s);}else t.append(e);return t}function k(n,r){let e=document.createElement("div");e.className="prose-pre";let t=typeof n.filename=="string"?n.filename:"",c=t.replace(":line-numbers","");if(c){let i=document.createElement("div");i.className="prose-pre-filename",i.innerHTML="<span></span>",i.querySelector("span").textContent=c,e.append(i);}let s=document.createElement("div");s.className="prose-pre-actions";let o=document.createElement("button");o.type="button",o.className="prose-pre-copy",o.title="Copy Code",o.innerHTML=p,o.addEventListener("click",async()=>{let i=typeof n.code=="string"?n.code:"";i&&(await navigator.clipboard.writeText(i),o.innerHTML=h,o.title="Copied",setTimeout(()=>{o.innerHTML=p,o.title="Copy Code";},2e3));}),s.append(o),e.append(s);let a=document.createElement("pre");return t.includes(":line-numbers")&&(a.className="prose-pre-line-numbers"),a.append(r),e.append(a),e}function E(n){let r=document.createElement("div");r.className="prose-table-scroll";let e=document.createElement("table");return e.className="prose-table",e.append(n),r.append(e),r}function l(n,r){if(typeof n=="string")return document.createTextNode(n);let[e,t={},...c]=n,s=document.createDocumentFragment();for(let i of c)s.append(l(i,r));let o=r[e];if(o)return o(t,s,n);if(u.has(e))return w(e,t,s);if(e==="pre")return k(t,s);if(e==="table")return E(s);let a=document.createElement(e);return g(a,t),f.has(e)&&a.classList.add(`prose-${e}`),a.append(s),a}function b(n,r={}){let e=document.createDocumentFragment();for(let t of n.nodes||[])e.append(l(t,r));return e}var d=class extends ReactiveElement{static properties={tree:{attribute:false},markdown:{type:String},components:{attribute:false}};#e=0;constructor(){super(),this.tree=null,this.markdown="",this.components={};}createRenderRoot(){return this}update(r){if(super.update(r),r.has("markdown")&&this.markdown){let e=++this.#e;import('@primeui-devkit/markdown-core').then(t=>t.parseMarkdown(this.markdown)).then(t=>{e===this.#e&&(this.tree=t);});return}(r.has("tree")||r.has("components"))&&(this.replaceChildren(),this.tree&&(this.classList.add("prose"),this.append(b(this.tree,this.components))));}};function y(n="lit-markdown"){customElements.get(n)||customElements.define(n,d);}export{d as LitMarkdown,y as defineLitMarkdown,l as renderNode,b as renderTree};

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@primeui-devkit/lit-markdown",
+  "version": "0.1.0-beta.1",
+  "description": "Lit renderer for the PrimeUI DevKit markdown AST with built-in prose behaviors: heading anchors, code copy button and table scroll wrapper. Renders into light DOM so shared prose styles apply.",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE.md",
+    "THIRD-PARTY-NOTICES.txt",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@primeui-devkit/markdown-core": "0.1.0-beta.1"
+  },
+  "peerDependencies": {
+    "lit": "^3.0.0"
+  },
+  "devDependencies": {
+    "cross-env": "^10.1.0",
+    "lit": "^3.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "~6.0.0",
+    "vitest": "4.1.10",
+    "@primeui-devkit/bundler": "0.0.0",
+    "@primeui-devkit/test-config": "0.0.0",
+    "@primeui-devkit/ts-config": "0.0.0"
+  },
+  "types": "./dist/index.d.ts",
+  "module": "./dist/index.js",
+  "author": "PrimeTek Informatics",
+  "bugs": {
+    "url": "https://support.primeui.dev"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "pnpm run build:package",
+    "build:package": "pnpm run test && tsup",
+    "type:check": "tsc --noEmit",
+    "test": "cross-env NODE_ENV=test vitest run --passWithNoTests",
+    "test:watch": "vitest --watch --passWithNoTests",
+    "test:coverage": "vitest run --coverage --passWithNoTests"
+  }
+}