@colletdev/core 0.1.3

package/src/markdown.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Render GFM markdown to sanitized HTML.
+ *
+ * Returns a `<div class="cx-prose">...</div>` wrapper.
+ * XSS-safe by construction — raw HTML in the source is escaped.
+ *
+ * Requires `init()` to have been called. If WASM is not yet loaded,
+ * waits for it automatically.
+ *
+ * @param input - GFM markdown string
+ * @returns Sanitized HTML string
+ */
+export declare function renderMarkdown(input: string): Promise<string>;
+
+/**
+ * Synchronous markdown rendering.
+ *
+ * Returns empty string if WASM is not loaded yet.
+ * Use after `await init()` has completed.
+ *
+ * @param input - GFM markdown string
+ * @returns Sanitized HTML string, or empty string if WASM not ready
+ */
+export declare function renderMarkdownSync(input: string): string;

package/src/markdown.js

@@ -0,0 +1,66 @@
+// Collet Markdown Utility — render GFM markdown to XSS-safe HTML via WASM.
+//
+// Static rendering: call renderMarkdown(input) to convert markdown to HTML.
+// The WASM module handles parsing (pulldown-cmark) and XSS safety (compile-time
+// event filtering — no runtime HTML sanitizer needed).
+
+import { getWasmExports, isWasmReady } from './runtime.js';
+
+let _wasmPromise = null;
+
+/**
+ * Render GFM markdown to sanitized HTML.
+ *
+ * Returns a `<div class="cx-prose">...</div>` wrapper containing the
+ * rendered HTML. Raw HTML in the markdown source is escaped (not passed
+ * through), making the output XSS-safe by construction.
+ *
+ * Requires `init()` to have been called first (WASM must be loaded).
+ * If WASM is not yet loaded, waits for it automatically.
+ *
+ * @param {string} input - GFM markdown string
+ * @returns {Promise<string>} Sanitized HTML string
+ *
+ * @example
+ * import { renderMarkdown } from '@colletdev/core/markdown';
+ *
+ * const html = await renderMarkdown('**Hello** world');
+ * // → '<div class="cx-prose"><p><strong>Hello</strong> world</p>\n</div>'
+ */
+export async function renderMarkdown(input) {
+  if (isWasmReady()) {
+    return getWasmExports().cx_render_markdown(input);
+  }
+
+  // WASM not loaded yet — wait for it.
+  // This covers the case where renderMarkdown is called before or
+  // concurrently with init().
+  if (!_wasmPromise) {
+    _wasmPromise = new Promise((resolve) => {
+      const check = () => {
+        if (isWasmReady()) {
+          resolve(getWasmExports());
+        } else {
+          setTimeout(check, 10);
+        }
+      };
+      check();
+    });
+  }
+  const wasm = await _wasmPromise;
+  return wasm.cx_render_markdown(input);
+}
+
+/**
+ * Synchronous markdown rendering. Returns empty string if WASM is not loaded.
+ *
+ * Use this when you need immediate rendering and are certain WASM is ready
+ * (e.g., after `await init()` has completed).
+ *
+ * @param {string} input - GFM markdown string
+ * @returns {string} Sanitized HTML string, or empty string if WASM not ready
+ */
+export function renderMarkdownSync(input) {
+  if (!isWasmReady()) return '';
+  return getWasmExports().cx_render_markdown(input);
+}

package/src/runtime.d.ts

@@ -0,0 +1,35 @@
+// TypeScript declarations for runtime.js base classes.
+
+export function initWasm(initFn: () => Promise<any>): Promise<any>;
+export function getWasmExports(): any;
+export function isWasmReady(): boolean;
+export function preWarmWasm(wasmFunctions: Array<(config: any) => any>): void;
+
+export function loadSharedStyles(urls: string[]): Promise<CSSStyleSheet[]>;
+export function loadMotionStyles(url: string): Promise<void>;
+export function getSharedSheets(): CSSStyleSheet[];
+
+export class CxElement extends HTMLElement {
+  protected _shadow: ShadowRoot;
+  protected _props: Record<string, any>;
+  _scheduleRender(): void;
+  _doRender(): void;
+  _injectHtml(result: { html: string; sprites: string; a11y?: { role?: string; aria?: Record<string, string> } }): void;
+  _emit(name: string, detail?: any): void;
+  _setProp(key: string, value: any): void;
+  _lockScroll(): void;
+  _unlockScroll(): void;
+}
+
+export class CxFormElement extends CxElement {
+  protected _internals: ElementInternals;
+  _setFormValue(value: string | FormData | null): void;
+  _setValidity(flags?: ValidityStateFlags, message?: string, anchor?: HTMLElement): void;
+  get form(): HTMLFormElement | null;
+  get name(): string | null;
+  get validity(): ValidityState;
+  get validationMessage(): string;
+  get willValidate(): boolean;
+  checkValidity(): boolean;
+  reportValidity(): boolean;
+}