@hymarkx/compiler 0.0.2

package/dist/styles.js

@@ -0,0 +1,370 @@
+import { createDiagnostic, visit } from '@hymarkx/ast';
+import postcss from 'postcss';
+import selectorParser from 'postcss-selector-parser';
+import { builtinComponents } from './components/builtins.js';
+import { builtinStylesFor } from './components/styles.js';
+import { setDiagnosticOrigin } from './diagnostic-origin.js';
+const EMPTY_STYLES = {
+    css: '',
+    diagnostics: [],
+    omittedNodes: new Map(),
+    rootScopeAttributes: [],
+    componentScopeAttributes: new Map(),
+    scopedBlocks: [],
+};
+function parseStyleBlock(node, index) {
+    const opening = /^<style(?<scoped>[ \t]+scoped)?[ \t]*>/i.exec(node.value);
+    if (opening === null) {
+        return undefined;
+    }
+    const closing = node.value.toLowerCase().lastIndexOf('</style>');
+    if (closing < opening[0].length || node.value.slice(closing + 8).trim() !== '') {
+        return undefined;
+    }
+    const css = node.value.slice(opening[0].length, closing);
+    const scoped = opening.groups?.scoped !== undefined;
+    // CommonMark example 176 uses a same-line raw `<style>…</style>` block. Requiring
+    // non-empty plain author styles to start on the next line preserves that baseline while
+    // scoped blocks and the explicitly supported empty `<style></style>` remain unambiguous.
+    if (!scoped && css !== '' && !css.startsWith('\n')) {
+        return undefined;
+    }
+    return {
+        node,
+        css,
+        cssOffset: node.position.start.offset + opening[0].length,
+        scoped,
+        index,
+    };
+}
+function collectStyleBlocks(document) {
+    const blocks = [];
+    visit(document.root, (node) => {
+        if (node.type === 'html') {
+            const block = parseStyleBlock(node, blocks.length);
+            if (block !== undefined) {
+                blocks.push(block);
+            }
+        }
+    });
+    return blocks;
+}
+function hashScope(identity) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < identity.length; index += 1) {
+        hash ^= identity.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+function authoredScopeAttribute(identity, used) {
+    const base = `data-hmx-s-${hashScope(identity)}-${hashScope(`authored\0${identity}`)}`;
+    let attribute = base;
+    let collision = 1;
+    while (used.has(attribute)) {
+        collision += 1;
+        attribute = `${base}-${collision}`;
+    }
+    used.add(attribute);
+    return attribute;
+}
+function isInsideKeyframes(rule) {
+    let parent = rule.parent;
+    while (parent !== undefined) {
+        if (parent.type === 'atrule' && /(?:^|-)keyframes$/i.test(parent.name)) {
+            return true;
+        }
+        parent = parent.parent;
+    }
+    return false;
+}
+function markGlobal(node, globals) {
+    globals.add(node);
+    if ('nodes' in node) {
+        for (const child of node.nodes) {
+            markGlobal(child, globals);
+        }
+    }
+}
+function unwrapGlobals(selector, globals) {
+    const pseudos = [];
+    selector.walkPseudos((pseudo) => {
+        if (pseudo.value.toLowerCase() === ':global') {
+            pseudos.push(pseudo);
+        }
+    });
+    for (const pseudo of pseudos.reverse()) {
+        const nested = pseudo.nodes[0];
+        if (nested === undefined || pseudo.nodes.length !== 1) {
+            throw new Error(':global() requires exactly one selector');
+        }
+        const replacements = nested.nodes.map((node) => node.clone());
+        for (const replacement of replacements) {
+            markGlobal(replacement, globals);
+        }
+        pseudo.replaceWith(...replacements);
+    }
+}
+function addScopeAttribute(selector, attributeName, globals) {
+    let selectedStart = -1;
+    let selectedEnd = -1;
+    let compoundStart = 0;
+    let compoundHasLocal = false;
+    for (let index = 0; index <= selector.nodes.length; index += 1) {
+        const node = selector.nodes[index];
+        if (node !== undefined && node.type !== 'combinator') {
+            if (node.type !== 'comment' && !globals.has(node)) {
+                compoundHasLocal = true;
+            }
+            continue;
+        }
+        if (compoundHasLocal) {
+            selectedStart = compoundStart;
+            selectedEnd = index;
+        }
+        compoundStart = index + 1;
+        compoundHasLocal = false;
+    }
+    if (selectedStart === -1) {
+        return;
+    }
+    const attribute = selectorParser.attribute({
+        attribute: attributeName,
+        value: undefined,
+        raws: {},
+    });
+    const pseudo = selector.nodes
+        .slice(selectedStart, selectedEnd)
+        .find((node) => node.type === 'pseudo');
+    if (pseudo !== undefined) {
+        selector.insertBefore(pseudo, attribute);
+        return;
+    }
+    const last = selector.nodes[selectedEnd - 1];
+    if (last !== undefined) {
+        selector.insertAfter(last, attribute);
+    }
+}
+function scopeRule(rule, attributeName) {
+    if (isInsideKeyframes(rule)) {
+        return;
+    }
+    try {
+        rule.selector = selectorParser((root) => {
+            root.each((selector) => {
+                const globals = new WeakSet();
+                unwrapGlobals(selector, globals);
+                addScopeAttribute(selector, attributeName, globals);
+            });
+        }).processSync(rule.selector);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw rule.error(message, { word: rule.selector });
+    }
+}
+function pointAt(source, offset) {
+    let line = 1;
+    let column = 1;
+    for (let index = 0; index < offset; index += 1) {
+        if (source.charCodeAt(index) === 10) {
+            line += 1;
+            column = 1;
+        }
+        else {
+            column += 1;
+        }
+    }
+    return { line, column, offset };
+}
+function relativeOffset(value, line, column) {
+    if (line === undefined || column === undefined) {
+        return 0;
+    }
+    let offset = 0;
+    for (let currentLine = 1; currentLine < line; currentLine += 1) {
+        const newline = value.indexOf('\n', offset);
+        if (newline === -1) {
+            return value.length;
+        }
+        offset = newline + 1;
+    }
+    return Math.min(offset + Math.max(column - 1, 0), value.length);
+}
+function syntaxErrorDiagnostic(error, source, block) {
+    const located = error;
+    const startOffset = Math.min(block.cssOffset + relativeOffset(block.css, located.line, located.column), source.length);
+    const reportedEnd = relativeOffset(block.css, located.endLine, located.endColumn);
+    const endOffset = Math.min(Math.max(startOffset + 1, block.cssOffset + reportedEnd), source.length);
+    return createDiagnostic({
+        code: 'HMX2030',
+        severity: 'error',
+        message: `CSS syntax error: ${located.reason ?? located.message ?? 'invalid CSS'}`,
+        span: { start: pointAt(source, startOffset), end: pointAt(source, endOffset) },
+    });
+}
+function compileStyleBlock(block, attributeName, source, from) {
+    try {
+        const root = postcss.parse(block.css, from === undefined ? {} : { from });
+        if (attributeName !== undefined) {
+            root.walkRules((rule) => scopeRule(rule, attributeName));
+            return { css: root.toString() };
+        }
+        return { css: block.css };
+    }
+    catch (error) {
+        return { css: '', diagnostic: syntaxErrorDiagnostic(error, source, block) };
+    }
+}
+function analyzedDocuments(root) {
+    const documents = [];
+    const seen = new Set();
+    const stack = [root];
+    while (stack.length > 0) {
+        const document = stack.pop();
+        if (document === undefined || seen.has(document)) {
+            continue;
+        }
+        seen.add(document);
+        documents.push(document);
+        const nested = [...document.expansions.values()].map((expansion) => expansion.document);
+        for (let index = nested.length - 1; index >= 0; index -= 1) {
+            const child = nested[index];
+            if (child !== undefined) {
+                stack.push(child);
+            }
+        }
+    }
+    return documents;
+}
+function usedBuiltinComponents(documents) {
+    const used = new Set();
+    for (const document of documents) {
+        for (const [node, component] of document.components) {
+            if (component.kindAllowed &&
+                component.schema === builtinComponents.schemas[node.name] &&
+                component.renderer === builtinComponents.renderers[node.name]) {
+                used.add(node.name);
+            }
+        }
+    }
+    return used;
+}
+/** Collects app-mode author CSS and proportional built-in component CSS. */
+export function prepareStyles(document, source, options) {
+    const documents = analyzedDocuments(document);
+    const builtins = builtinStylesFor(usedBuiltinComponents(documents));
+    const omittedNodes = new Map();
+    const rootScopeAttributes = [];
+    const componentScopeAttributes = new Map();
+    const scopedBlocks = [];
+    const diagnostics = [];
+    const authorCss = [];
+    const usedComponentScopeAttributes = new Set();
+    if (options.collectAuthorStyles) {
+        const blocks = collectStyleBlocks(document);
+        omittedNodes.set(document, new Set(blocks.map((block) => block.node)));
+        for (const block of blocks) {
+            const attributeName = block.scoped
+                ? `data-hmx-s-${hashScope(`${options.from ?? ''}\0${source}\0${block.index}`)}`
+                : undefined;
+            const compiled = compileStyleBlock(block, attributeName, source, options.from);
+            if (compiled.diagnostic !== undefined) {
+                diagnostics.push(compiled.diagnostic);
+                continue;
+            }
+            if (compiled.css !== '') {
+                authorCss.push(compiled.css);
+            }
+            if (attributeName !== undefined) {
+                rootScopeAttributes.push(attributeName);
+                scopedBlocks.push({
+                    block,
+                    attribute: attributeName,
+                    source,
+                    ...(options.from === undefined ? {} : { from: options.from }),
+                });
+            }
+        }
+    }
+    const componentDocuments = new Map();
+    for (const owner of documents) {
+        if (owner.authored === undefined) {
+            continue;
+        }
+        const instances = componentDocuments.get(owner.authored) ?? [];
+        instances.push(owner);
+        componentDocuments.set(owner.authored, instances);
+    }
+    for (const [definition, instances] of componentDocuments) {
+        const representative = instances[0];
+        if (representative === undefined) {
+            continue;
+        }
+        const blocks = collectStyleBlocks(representative);
+        const omitted = new Set(blocks.map((block) => block.node));
+        for (const instance of instances) {
+            omittedNodes.set(instance, omitted);
+        }
+        const attributes = [];
+        for (const block of blocks) {
+            if (!block.scoped || /<\s*script\b/i.test(block.css)) {
+                continue;
+            }
+            const identity = `${definition.name}\0${definition.from ?? ''}\0${definition.source}\0${block.index}`;
+            const attributeName = authoredScopeAttribute(identity, usedComponentScopeAttributes);
+            const compiled = compileStyleBlock(block, attributeName, definition.source, definition.from);
+            if (compiled.diagnostic !== undefined) {
+                setDiagnosticOrigin(compiled.diagnostic, definition.source, definition.from);
+                diagnostics.push(compiled.diagnostic);
+                continue;
+            }
+            if (compiled.css !== '') {
+                authorCss.push(compiled.css);
+            }
+            attributes.push(attributeName);
+            scopedBlocks.push({
+                block,
+                attribute: attributeName,
+                source: definition.source,
+                ...(definition.from === undefined ? {} : { from: definition.from }),
+            });
+        }
+        for (const instance of instances) {
+            componentScopeAttributes.set(instance, attributes);
+        }
+    }
+    if (builtins === '' &&
+        authorCss.length === 0 &&
+        diagnostics.length === 0 &&
+        omittedNodes.size === 0) {
+        return EMPTY_STYLES;
+    }
+    return {
+        css: [builtins, ...authorCss].filter((value) => value !== '').join('\n'),
+        diagnostics,
+        omittedNodes,
+        rootScopeAttributes,
+        componentScopeAttributes,
+        scopedBlocks,
+    };
+}
+/** Warns for valid scoped blocks when no generated element received their scope attribute. */
+export function emptyScopeDiagnostics(styles, html) {
+    const diagnostics = [];
+    for (const { block, attribute, source, from } of styles.scopedBlocks) {
+        if (html.includes(` ${attribute}`)) {
+            continue;
+        }
+        const diagnostic = createDiagnostic({
+            code: 'HMX2031',
+            severity: 'warning',
+            message: 'Scoped style has no emitted elements to scope.',
+            span: block.node.position,
+        });
+        setDiagnosticOrigin(diagnostic, source, from);
+        diagnostics.push(diagnostic);
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=styles.js.map

package/dist/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"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"}

package/dist/suggestions.d.ts

@@ -0,0 +1,3 @@
+/** Returns the single closest case-insensitive candidate within edit distance two. */
+export declare function nearestSuggestion(value: string, candidates: readonly string[]): string | undefined;
+//# sourceMappingURL=suggestions.d.ts.map

package/dist/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":"AAmBA,sFAAsF;AACtF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,GAAG,SAAS,CAYpB"}

package/dist/suggestions.js

@@ -0,0 +1,29 @@
+function levenshtein(left, right) {
+    const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
+    for (let leftIndex = 1; leftIndex <= left.length; leftIndex += 1) {
+        let diagonal = previous[0] ?? 0;
+        previous[0] = leftIndex;
+        for (let rightIndex = 1; rightIndex <= right.length; rightIndex += 1) {
+            const above = previous[rightIndex] ?? 0;
+            const next = Math.min(above + 1, (previous[rightIndex - 1] ?? 0) + 1, diagonal + (left[leftIndex - 1] === right[rightIndex - 1] ? 0 : 1));
+            diagonal = above;
+            previous[rightIndex] = next;
+        }
+    }
+    return previous[right.length] ?? 0;
+}
+/** Returns the single closest case-insensitive candidate within edit distance two. */
+export function nearestSuggestion(value, candidates) {
+    let closest;
+    let closestDistance = 3;
+    const normalized = value.toLowerCase();
+    for (const candidate of candidates) {
+        const distance = levenshtein(normalized, candidate.toLowerCase());
+        if (distance < closestDistance) {
+            closest = candidate;
+            closestDistance = distance;
+        }
+    }
+    return closest;
+}
+//# sourceMappingURL=suggestions.js.map

package/dist/suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.js","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":"AAAA,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAA;IAC9E,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;QACjE,IAAI,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC/B,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;QACvB,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,UAAU,IAAI,CAAC,EAAE,CAAC;YACrE,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;YACvC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CACnB,KAAK,GAAG,CAAC,EACT,CAAC,QAAQ,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EACnC,QAAQ,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACnE,CAAA;YACD,QAAQ,GAAG,KAAK,CAAA;YAChB,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAAA;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,UAA6B;IAE7B,IAAI,OAA2B,CAAA;IAC/B,IAAI,eAAe,GAAG,CAAC,CAAA;IACvB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;IACtC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,CAAA;QACjE,IAAI,QAAQ,GAAG,eAAe,EAAE,CAAC;YAC/B,OAAO,GAAG,SAAS,CAAA;YACnB,eAAe,GAAG,QAAQ,CAAA;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,59 @@
+import type { Diagnostic } from '@hymarkx/ast';
+import type { ComponentRegistry } from './components/types.js';
+/** Host-selected trust boundary used while emitting HTML. */
+export type TrustMode = 'document' | 'app';
+/** A scalar value accepted in parsed frontmatter. */
+export type FrontmatterScalar = string | number | boolean | null;
+/** A parsed frontmatter mapping exposed to compiler consumers. */
+export type FrontmatterValue = {
+    readonly [key: string]: FrontmatterScalar | readonly FrontmatterScalar[] | FrontmatterValue;
+};
+/** Options controlling parsing, analysis, and HTML emission. */
+export interface CompileOptions {
+    /** Host-selected. Never inferred from document content. Default: `document`. */
+    readonly trust?: TrustMode;
+    /** File path used when rendering diagnostics. */
+    readonly from?: string;
+    /** Enables GFM tables, task lists, strikethrough, and autolinks. Default: `true`. */
+    readonly gfm?: boolean;
+    /** Additional or replacement name-keyed component schemas and renderers. */
+    readonly components?: ComponentRegistry;
+    /** Emit CSS in a `<style>` element ahead of the HTML content. Default: `false`. */
+    readonly inlineCss?: boolean;
+    /** Emit JavaScript in a `<script>` element after the HTML content. Default: `false`. */
+    readonly inlineJs?: boolean;
+}
+/** Result of compiling source or an existing HMX syntax tree. */
+export interface CompileResult {
+    /** Deterministic HTML output. */
+    readonly html: string;
+    /** Stylesheet for this document. Empty when no styles are needed. */
+    readonly css: string;
+    /** Feature-shaped interactive runtime. Empty when the document is static. */
+    readonly js: string;
+    /** Parser, analysis, and emission diagnostics in source order. */
+    readonly diagnostics: readonly Diagnostic[];
+    /** Normalized source indexed by every diagnostic span. */
+    readonly source: string;
+    /** Parsed frontmatter, or undefined when the document has none. */
+    readonly frontmatter?: FrontmatterValue;
+    /**
+     * Foreign-component references for the host to resolve and bundle (ADR-0016).
+     *
+     * Empty for every document without an `::island`. The compiler records references and
+     * never imports, transpiles, or evaluates them, so a document using islands is **not
+     * runnable from `hmx build` output alone** — a host integration must supply the modules
+     * and their framework runtime.
+     */
+    readonly islands: readonly IslandRef[];
+}
+/** Props passed to a foreign component: the same restricted scalars expressions produce. */
+export type IslandProps = Readonly<Record<string, string | number | boolean | null>>;
+/** One foreign-component reference in the island manifest. */
+export interface IslandRef {
+    readonly id: number;
+    readonly from: string;
+    readonly export: string;
+    readonly props: IslandProps;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,6DAA6D;AAC7D,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,KAAK,CAAA;AAE1C,qDAAqD;AACrD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;AAEhE,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,iBAAiB,EAAE,GAAG,gBAAgB,CAAA;CAC5F,CAAA;AAED,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,qFAAqF;IACrF,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAA;IACvC,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAA;IAC3C,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAA;IACvC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;CACvC;AAED,4FAA4F;AAC5F,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAA;AAEpF,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAC5B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@hymarkx/compiler",
+  "version": "0.0.2",
+  "description": "Trust-aware HTML compiler and diagnostic renderer for HyMarkX (HMX).",
+  "license": "MIT OR Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NAME0x0/HyMarkX.git",
+    "directory": "packages/compiler"
+  },
+  "homepage": "https://github.com/NAME0x0/HyMarkX#readme",
+  "bugs": "https://github.com/NAME0x0/HyMarkX/issues",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "dependencies": {
+    "postcss": "^8.5.26",
+    "postcss-selector-parser": "^7.1.1",
+    "yaml": "^2.9.0",
+    "@hymarkx/parser": "0.0.2",
+    "@hymarkx/ast": "0.0.2"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}