@arcmantle/lit-jsx 1.0.0

package/src/shared/jsx-utils.ts

@@ -0,0 +1,85 @@
+import type { AttributePart, BooleanAttributePart, ChildPart, ElementPart, EventPart, PropertyPart } from 'lit-html';
+import { html, render } from 'lit-html';
+import type { PartInfo } from 'lit-html/directive.js';
+import { Directive, directive, PartType } from 'lit-html/directive.js';
+
+
+export interface LitPartConstructors {
+	AttributePart: typeof AttributePart;
+	PropertyPart:  typeof PropertyPart;
+	BooleanPart:   typeof BooleanAttributePart;
+	EventPart:     typeof EventPart;
+	ChildPart:     typeof ChildPart;
+	ElementPart:   typeof ElementPart;
+}
+
+
+/**
+ * Template tag function marker for jsx-lit React compatibility mode.
+ *
+ * This function serves the same purpose as __$t but for React JSX transform mode.
+ * It's an identity function that marks template literals for jsx-lit processing.
+ *
+ * @param strings - Template strings array from template literal
+ * @returns The same template strings array unchanged
+ */
+export const __ttl: (strings: TemplateStringsArray) => TemplateStringsArray = s => s;
+
+
+/**
+ * Lazy-initialized function that extracts lit-html part constructors.
+ *
+ * This function uses a clever technique to extract the internal part constructors
+ * from lit-html by creating temporary directives and examining their part types.
+ * This is necessary for jsx-lit's compile-time optimizations.
+ *
+ * @returns Object containing all lit-html part constructors
+ */
+export const getLitParts: () => LitPartConstructors = (() => {
+	let hasRun = false;
+
+	const constructors = {
+		AttributePart: undefined,
+		PropertyPart:  undefined,
+		BooleanPart:   undefined,
+		EventPart:     undefined,
+		ChildPart:     undefined,
+		ElementPart:   undefined,
+	} satisfies Record<keyof LitPartConstructors, undefined> as
+		any as LitPartConstructors;
+
+	const partCtorGrabber: any = directive(class PartCtorGrabber extends Directive {
+
+		constructor(part: PartInfo) {
+			super(part);
+
+			if (part.type === PartType.BOOLEAN_ATTRIBUTE)
+				constructors.BooleanPart = part.constructor as typeof BooleanAttributePart;
+			else if (part.type === PartType.ATTRIBUTE)
+				constructors.AttributePart = part.constructor as typeof AttributePart;
+			else if (part.type === PartType.PROPERTY)
+				constructors.PropertyPart = part.constructor as typeof PropertyPart;
+			else if (part.type === PartType.ELEMENT)
+				constructors.ElementPart = part.constructor as typeof ElementPart;
+			else if (part.type === PartType.EVENT)
+				constructors.EventPart = part.constructor as typeof EventPart;
+			else if (part.type === PartType.CHILD)
+				constructors.ChildPart = part.constructor as typeof ChildPart;
+		}
+
+		override render(): void {}
+
+	});
+
+	return () => {
+		if (!hasRun) {
+			const g = partCtorGrabber;
+			hasRun = !!render(
+				html`<div ${ g() } prop=${ g() } .prop=${ g() } ?prop=${ g() } @prop=${ g() }>${ g() }</div>`,
+				document.createElement('div'),
+			);
+		}
+
+		return constructors;
+	};
+})();

package/src/shared/mathml-tags.ts

@@ -0,0 +1,235 @@
+/* cspell:disable */
+
+/**
+ * A comprehensive set of all MathML tag names.
+ * This includes current and deprecated MathML elements from the MathML specification.
+ */
+export const mathmlTags: Set<string> = new Set([
+	// Token Elements
+	'mi', // identifier
+	'mn', // number
+	'mo', // operator
+	'mtext', // text
+	'mspace', // space
+	'ms', // string literal
+
+	// General Layout Elements
+	'mrow', // horizontal group of sub-expressions
+	'mfrac', // fraction
+	'msqrt', // square root
+	'mroot', // nth root
+	'mstyle', // style change
+	'merror', // error message
+	'mpadded', // adjust spacing
+	'mphantom', // make content invisible but preserve spacing
+	'mfenced', // surround content with fences
+	'menclose', // enclose content with stretching symbols
+
+	// Script and Limit Elements
+	'msub', // subscript
+	'msup', // superscript
+	'msubsup', // subscript-superscript pair
+	'munder', // underscript
+	'mover', // overscript
+	'munderover', // underscript-overscript pair
+	'mmultiscripts', // prescripts and tensor indices
+
+	// Tabular Math Elements
+	'mtable', // table
+	'mtr', // table row
+	'mtd', // table cell
+	'maligngroup', // alignment group
+	'malignmark', // alignment point
+
+	// Elementary Math Elements (MathML 3)
+	'mstack', // stacked notation
+	'mlongdiv', // long division notation
+	'msgroup', // group of rows in mstack
+	'msrow', // row of digits
+	'mscarries', // carries row
+	'mscarry', // carry digit
+	'msline', // horizontal line
+
+	// Action Elements
+	'maction', // bind actions to sub-expressions
+
+	// Annotation Elements
+	'semantics', // semantic annotation
+	'annotation', // annotation
+	'annotation-xml', // XML annotation
+
+	// Content Elements (Content MathML)
+	'apply', // function application
+	'bind', // binding constructor
+	'bvar', // bound variable
+	'condition', // condition
+	'declare', // declaration
+	'lambda', // lambda expression
+	'piecewise', // piecewise function
+	'piece', // piece of piecewise function
+	'otherwise', // default case
+
+	// Arithmetic, Algebra, and Logic Operators
+	'plus',
+	'minus',
+	'times',
+	'divide',
+	'power',
+	'rem',
+	'quotient',
+	'factorial',
+	'abs',
+	'conjugate',
+	'arg',
+	'real',
+	'imaginary',
+	'floor',
+	'ceiling',
+	'exp',
+	'ln',
+	'log',
+	'sin',
+	'cos',
+	'tan',
+	'sec',
+	'csc',
+	'cot',
+	'sinh',
+	'cosh',
+	'tanh',
+	'sech',
+	'csch',
+	'coth',
+	'arcsin',
+	'arccos',
+	'arctan',
+	'arcsec',
+	'arccsc',
+	'arccot',
+	'arcsinh',
+	'arccosh',
+	'arctanh',
+	'arcsech',
+	'arccsch',
+	'arccoth',
+	'root',
+	'gcd',
+	'lcm',
+	'max',
+	'min',
+	'sum',
+	'product',
+	'limit',
+	'mean',
+	'sdev',
+	'variance',
+	'median',
+	'mode',
+	'moment',
+	'momentabout',
+	'and',
+	'or',
+	'xor',
+	'not',
+	'implies',
+	'forall',
+	'exists',
+
+	// Relations
+	'eq',
+	'neq',
+	'gt',
+	'lt',
+	'geq',
+	'leq',
+	'equivalent',
+	'approx',
+	'factorof',
+	'tendsto',
+
+	// Calculus and Vector Calculus
+	'int',
+	'diff',
+	'partialdiff',
+	'grad',
+	'curl',
+	'divergence',
+	'laplacian',
+
+	// Theory of Sets
+	'set',
+	'list',
+	'union',
+	'intersect',
+	'in',
+	'notin',
+	'subset',
+	'prsubset',
+	'notsubset',
+	'notprsubset',
+	'setdiff',
+	'card',
+	'cartesianproduct',
+
+	// Sequences and Series
+	'lowlimit',
+	'uplimit',
+	'interval',
+
+	// Trigonometry
+	'inverse',
+
+	// Statistics
+	'vector',
+	'matrix',
+	'matrixrow',
+	'determinant',
+	'transpose',
+	'selector',
+	'vectorproduct',
+	'scalarproduct',
+	'outerproduct',
+
+	// Constants
+	'integers',
+	'reals',
+	'rationals',
+	'naturalnumbers',
+	'complexes',
+	'primes',
+	'exponentiale',
+	'imaginaryi',
+	'notanumber',
+	'true',
+	'false',
+	'emptyset',
+	'pi',
+	'eulergamma',
+	'infinity',
+
+	// Linear Algebra
+	'ident',
+
+	// Semantic Mapping Elements
+	'csymbol',
+	'cn', // content number
+	'ci', // content identifier
+	'cs', // content string
+
+	// Deprecated Elements
+	'reln', // deprecated
+	'fn', // deprecated
+	'domainofapplication', // deprecated
+	'sep', // deprecated
+
+	// Experimental/Less Common Elements
+	'mlabeledtr', // labeled table row
+	'mglyph', // glyph
+]);
+
+/**
+ * Check if a given tag name is a MathML tag.
+ * @param tagName - The tag name to check
+ * @returns true if the tag is a MathML tag, false otherwise
+ */
+export const isMathmlTag = (tagName: string): boolean => mathmlTags.has(tagName);

package/src/shared/svg-tags.ts

@@ -0,0 +1,103 @@
+/** cspell: disable */
+
+/**
+ * A comprehensive set of all SVG tag names.
+ * This includes current and deprecated SVG elements from the SVG specification.
+ */
+export const svgTags: Set<string> = new Set([
+	// Structure and Container Elements
+	'g',
+	'defs',
+	'use',
+	'symbol',
+	'marker',
+	'clipPath',
+	'mask',
+	'pattern',
+	'image',
+	'switch',
+	'foreignObject',
+
+	// Shape Elements
+	'rect',
+	'circle',
+	'ellipse',
+	'line',
+	'polyline',
+	'polygon',
+	'path',
+
+	// Text Elements
+	'text',
+	'tspan',
+	'tref', // deprecated
+	'textPath',
+	'altGlyph', // deprecated
+	'altGlyphDef', // deprecated
+	'altGlyphItem', // deprecated
+	'glyph', // deprecated
+	'glyphRef', // deprecated
+
+	// Gradient Elements
+	'linearGradient',
+	'radialGradient',
+	'meshGradient',
+	'meshPatch',
+	'meshRow',
+	'stop',
+
+	// Animation Elements
+	'animate',
+	'animateMotion',
+	'animateTransform',
+	'animateColor', // deprecated
+	'set',
+	'mpath',
+
+	// Filter Elements
+	'filter',
+	'feBlend',
+	'feColorMatrix',
+	'feComponentTransfer',
+	'feComposite',
+	'feConvolveMatrix',
+	'feDiffuseLighting',
+	'feDisplacementMap',
+	'feDistantLight',
+	'feDropShadow',
+	'feFlood',
+	'feFuncA',
+	'feFuncB',
+	'feFuncG',
+	'feFuncR',
+	'feGaussianBlur',
+	'feImage',
+	'feMerge',
+	'feMergeNode',
+	'feMorphology',
+	'feOffset',
+	'fePointLight',
+	'feSpecularLighting',
+	'feSpotLight',
+	'feTile',
+	'feTurbulence',
+
+	// Font Elements (mostly deprecated)
+	'font', // deprecated
+	'font-face', // deprecated
+	'font-face-format', // deprecated
+	'font-face-name', // deprecated
+	'font-face-src', // deprecated
+	'font-face-uri', // deprecated
+	'hkern', // deprecated
+	'vkern', // deprecated
+	'missing-glyph', // deprecated
+]);
+
+
+/**
+ * Check if a given tag name is an SVG tag.
+ * @param tagName - The tag name to check
+ * @returns true if the tag is an SVG tag, false otherwise
+ */
+export const isSvgTag = (tagName: string): boolean => svgTags.has(tagName);

package/src/tsconfig.json

@@ -0,0 +1,4 @@
+{
+	"extends": "@arcmantle/tsconfig/build",
+	"compilerOptions": {}
+}

package/src/utils.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Main entrypoint for jsx-lit runtime utilities and components.
+ *
+ * This module provides all the runtime utilities needed for jsx-lit compiled templates,
+ * including helper components for conditional rendering, iteration, and template composition.
+ *
+ * @example
+ * ```tsx
+ * import { Choose, For, Show } from "@arcmantle/lit-jsx";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <div>
+ *       <Show when={condition}>
+ *         <p>Conditionally rendered content</p>
+ *       </Show>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+
+export * from './runtime/choose-component.js';
+export * from './runtime/compiler-ctors.js';
+export * from './runtime/for-component.js';
+export * from './runtime/literal-map.js';
+export * from './runtime/rest-directive.js';
+export * from './runtime/show-component.js';
+export * from './runtime/tagged-template.js';
+export * from './runtime/type-helpers.js';