@tsrx/core 0.0.19 → 0.0.21

package/src/utils/builders.js

@@ -1100,6 +1100,74 @@ export function jsx_attribute(name, value = null, shorthand = false, loc_info) {
 	return set_location(node, loc_info);
 }
 
+/**
+ * Build a fresh `JSXOpeningElement`. For elements derived from an existing
+ * Element node, prefer `jsx_element` which spreads from the source.
+ *
+ * @param {ESTreeJSX.JSXOpeningElement['name']} name
+ * @param {ESTreeJSX.JSXOpeningElement['attributes']} [attributes]
+ * @param {boolean} [self_closing]
+ * @param {AST.NodeWithLocation} [loc_info]
+ * @returns {ESTreeJSX.JSXOpeningElement}
+ */
+export function jsx_opening_element(name, attributes = [], self_closing = false, loc_info) {
+	const node = /** @type {ESTreeJSX.JSXOpeningElement} */ ({
+		type: 'JSXOpeningElement',
+		name,
+		attributes,
+		selfClosing: self_closing,
+		metadata: { path: [] },
+	});
+
+	return set_location(node, loc_info);
+}
+
+/**
+ * Build a fresh `JSXClosingElement`.
+ *
+ * @param {ESTreeJSX.JSXClosingElement['name']} name
+ * @param {AST.NodeWithLocation} [loc_info]
+ * @returns {ESTreeJSX.JSXClosingElement}
+ */
+export function jsx_closing_element(name, loc_info) {
+	const node = /** @type {ESTreeJSX.JSXClosingElement} */ ({
+		type: 'JSXClosingElement',
+		name,
+		metadata: { path: [] },
+	});
+
+	return set_location(node, loc_info);
+}
+
+/**
+ * Build a fresh `JSXElement` from explicit opening / closing / children.
+ * Companion to `jsx_opening_element` / `jsx_closing_element`. For elements
+ * derived from an existing source node, use `jsx_element` (which spreads
+ * the source's name and metadata).
+ *
+ * @param {ESTreeJSX.JSXOpeningElement} opening_element
+ * @param {ESTreeJSX.JSXClosingElement | null} [closing_element]
+ * @param {ESTreeJSX.JSXElement['children']} [children]
+ * @param {AST.NodeWithLocation} [loc_info]
+ * @returns {ESTreeJSX.JSXElement}
+ */
+export function jsx_element_fresh(
+	opening_element,
+	closing_element = null,
+	children = [],
+	loc_info,
+) {
+	const node = /** @type {ESTreeJSX.JSXElement} */ ({
+		type: 'JSXElement',
+		openingElement: opening_element,
+		closingElement: closing_element,
+		children,
+		metadata: { path: [] },
+	});
+
+	return set_location(node, loc_info);
+}
+
 /**
  * @param {AST.Element} node
  * @param {ESTreeJSX.JSXOpeningElement['attributes']} attributes

package/types/index.d.ts

@@ -29,6 +29,7 @@ export { createJsxTransform, componentToFunctionDeclaration };
  * Compile error interface
  */
 export interface CompileError extends Error {
+	code: string | undefined;
 	pos: number | undefined;
 	raisedAt: number | undefined;
 	end: number | undefined;
@@ -50,6 +51,11 @@ export interface CompileOptions {
 	 * When true, non-fatal errors are collected on the result's `errors`
 	 * array instead of being thrown. Defaults to false (strict mode: throws).
 	 */
+	collect?: boolean;
+	/**
+	 * Enables editor-oriented parser recovery such as incomplete markup.
+	 * Also collects non-fatal errors as `collect`.
+	 */
 	loose?: boolean;
 }
 
@@ -1149,6 +1155,7 @@ export interface ParseError {
  * Parse options
  */
 export interface ParseOptions {
+	collect?: boolean;
 	loose?: boolean;
 	errors?: CompileError[];
 	comments?: AST.CommentWithLocation[];
@@ -1278,7 +1285,7 @@ export interface ScopeConstructorInterface {
 	parent: ScopeInterface | null;
 	porous: boolean;
 	error_options: {
-		loose: boolean;
+		collect: boolean;
 		errors: CompileError[];
 		filename: string;
 		comments?: AST.CommentWithLocation[];
@@ -1371,7 +1378,7 @@ export interface AnalysisState extends BaseState {
 	};
 	elements?: AST.Element[];
 	function_depth?: number;
-	loose?: boolean;
+	collect?: boolean;
 	configured_compat_kinds?: Set<string>;
 	metadata: BaseStateMetaData & {
 		styleClasses?: StyleClasses;
@@ -1582,7 +1589,7 @@ export interface CompileResult {
 	css: string;
 	/**
 	 * Non-fatal errors collected during compilation. Populated only when the
-	 * caller passes `loose: true`; empty otherwise.
+	 * caller passes `collect: true` or `loose: true`; empty otherwise.
 	 */
 	errors: CompileError[];
 }

package/types/jsx-platform.d.ts

@@ -42,8 +42,8 @@ export interface JsxTransformContext {
 	/** Source filename for diagnostics; null when the caller did not supply one. */
 	filename: string | null;
 	/** True when recoverable errors should be collected onto `errors` instead of thrown. */
-	loose: boolean;
-	/** Collected non-fatal errors. Undefined when `loose` is false. */
+	collect: boolean;
+	/** Collected non-fatal errors. Undefined when `collect` is false. */
 	errors: CompileError[] | undefined;
 	/** Module-level comments used to honor `@tsrx-ignore` / `@tsrx-expect-error`. */
 	comments: AST.CommentWithLocation[] | undefined;
@@ -64,10 +64,14 @@ export interface JsxTransformOptions {
 	 * of thrown so editor tooling can surface them as diagnostics. Errors that
 	 * leave the transform in an unrecoverable state are still thrown.
 	 */
+	collect?: boolean;
+	/**
+	 * Don't collect allowable errors such as unclosed tags
+	 */
 	loose?: boolean;
 	/**
 	 * Collected non-fatal errors. The transform appends to this array when
-	 * `loose` is true; callers read it after the transform returns.
+	 * `collect` or `loose` is true; callers read it after the transform returns.
 	 */
 	errors?: CompileError[];
 	/**

package/types/parse.d.ts

@@ -183,13 +183,15 @@ export namespace Parse {
 
 	export interface Options extends Omit<acorn.Options, 'onComment' | 'ecmaVersion'> {
 		tsrxOptions?: {
+			collect: boolean;
 			loose: boolean;
-			errors: CoreCompiler.CompileError[];
+			errors: CoreCompiler.CompileError[] | undefined;
 			filename: string | undefined;
 		};
 		rippleOptions?: {
+			collect: boolean;
 			loose: boolean;
-			errors: CoreCompiler.CompileError[];
+			errors: CoreCompiler.CompileError[] | undefined;
 			filename: string | undefined;
 		};
 		// The type has "latest" but it's converted to 1e8 at runtime