tsx-sql 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GuXianWN
+
+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/README.md

@@ -0,0 +1,169 @@
+# tsx-sql
+
+Compile TSX SQL fragments into parameterized SQL.
+
+`tsx-sql` is a small SQL generation library. It lets you write dynamic SQL with TSX tags, then compile it into SQL text and parameter values.
+
+It does not execute SQL, manage database connections, model schemas, or replace your ORM. Use the generated SQL with your database client or ORM of choice.
+
+## Install
+
+```sh
+npm install tsx-sql
+```
+
+## TypeScript Setup
+
+Configure TypeScript to use the `tsx-sql` JSX runtime:
+
+```json
+{
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "jsxImportSource": "tsx-sql"
+  }
+}
+```
+
+Use `.tsx` files for SQL fragments written with JSX syntax.
+
+## Basic Usage
+
+```tsx
+import { $, compile, If, Where } from "tsx-sql";
+
+const name: string | undefined = "Tom";
+const age: number | undefined = undefined;
+
+const query = compile(
+  <>
+    SELECT * FROM users
+    <Where>
+      <If test={name !== undefined}> AND name = { $(name) }</If>
+      <If test={age !== undefined}> AND age = { $(age) }</If>
+    </Where>
+  </>
+);
+
+console.log(query);
+```
+
+Output:
+
+```ts
+{
+  sql: "SELECT * FROM users WHERE name = ?",
+  values: ["Tom"],
+  text: "SELECT * FROM users WHERE name = 'Tom'"
+}
+```
+
+## Dynamic Conditions
+
+Use `If` to include SQL only when a condition is true.
+
+```tsx
+import { $, compile, If } from "tsx-sql";
+
+const name: string | undefined = "Tom";
+
+const query = compile(
+  <>
+    SELECT * FROM users
+    <If test={name !== undefined}> WHERE name = { $(name) }</If>
+  </>
+);
+```
+
+## Where
+
+`Where` follows the MyBatis-style behavior:
+
+- emits `WHERE` only when its children produce SQL
+- removes a leading `AND` or `OR`
+
+```tsx
+import { $, compile, If, Where } from "tsx-sql";
+
+const name: string | undefined = "Tom";
+const age: number | undefined = undefined;
+
+const query = compile(
+  <>
+    SELECT * FROM users
+    <Where>
+      <If test={name !== undefined}> AND name = { $(name) }</If>
+      <If test={age !== undefined}> AND age = { $(age) }</If>
+    </Where>
+  </>
+);
+```
+
+Output:
+
+```ts
+{
+  sql: "SELECT * FROM users WHERE name = ?",
+  values: ["Tom"],
+  text: "SELECT * FROM users WHERE name = 'Tom'"
+}
+```
+
+## Execute With Your Database Library
+
+`compile` returns a plain object:
+
+```ts
+interface CompileResult {
+  sql: string;
+  values: unknown[];
+  text: string;
+}
+```
+
+Use `sql` and `values` with a mature database client that accepts `?` placeholders.
+
+```ts
+await connection.query(query.sql, query.values);
+```
+
+`text` is intended for debugging and logging. Do not use it as executable SQL.
+
+## API
+
+### `compile(node)`
+
+Compiles a TSX SQL node into:
+
+- `sql`: SQL with `?` placeholders
+- `values`: parameter values in order
+- `text`: debug SQL with escaped values
+
+### `$(value)`
+
+Marks a value as a SQL parameter. Raw `{value}` expressions are not treated as SQL parameters; wrap values with `$()`.
+
+```tsx
+WHERE id = { $(id) }
+```
+
+### `<If test={boolean}>`
+
+Includes its children when `test` is true.
+
+### `<Where>`
+
+Adds `WHERE` when children are not empty, and removes a leading `AND` or `OR`.
+
+## Scope
+
+This project only generates SQL.
+
+It intentionally does not provide:
+
+- database drivers
+- connection pooling
+- query execution
+- schema modeling
+- migrations
+- ORM behavior

package/dist/index.cjs

@@ -0,0 +1,160 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  $: () => $,
+  If: () => If,
+  Where: () => Where,
+  compile: () => compile
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/internal/escape.ts
+function escapeSqlTextValue(value) {
+  if (value === null || value === void 0) {
+    return "NULL";
+  }
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? String(value) : "NULL";
+  }
+  if (typeof value === "bigint") {
+    return value.toString();
+  }
+  if (typeof value === "boolean") {
+    return value ? "TRUE" : "FALSE";
+  }
+  if (value instanceof Date) {
+    return quoteString(value.toISOString());
+  }
+  return quoteString(String(value));
+}
+function quoteString(value) {
+  return `'${value.replaceAll("'", "''")}'`;
+}
+
+// src/node.ts
+var FRAGMENT_SYMBOL = "tsx-sql.fragment";
+var SqlFragment = Symbol.for(FRAGMENT_SYMBOL);
+
+// src/internal/resolve.ts
+function resolveNode(input) {
+  if (Array.isArray(input)) {
+    return input.flatMap(resolveNode);
+  }
+  if (typeof input === "string") {
+    return [input];
+  }
+  if (input.kind === "param") {
+    return [input];
+  }
+  if (input.kind === "element") {
+    if (input.type === SqlFragment) {
+      return resolveNode(input.children ?? "");
+    }
+    return resolveNode(input.type(componentProps(input)));
+  }
+  return assertNever(input);
+}
+function componentProps(element) {
+  return {
+    ...element.props,
+    children: element.children
+  };
+}
+function assertNever(value) {
+  throw new TypeError(`Unsupported SQL node: ${String(value)}`);
+}
+
+// src/compile.ts
+function compile(input) {
+  const sqlParts = [];
+  const values = [];
+  const textParts = [];
+  for (const node of resolveNode(input)) {
+    if (typeof node === "string") {
+      sqlParts.push(node);
+      textParts.push(node);
+      continue;
+    }
+    sqlParts.push("?");
+    values.push(node.value);
+    textParts.push(escapeSqlTextValue(node.value));
+  }
+  return {
+    sql: compactWhitespace(sqlParts.join("")),
+    values,
+    text: textParts.join("")
+  };
+}
+function compactWhitespace(source) {
+  return source.replace(/\s+/g, " ").trim();
+}
+
+// src/param.ts
+function $(value) {
+  return {
+    kind: "param",
+    value
+  };
+}
+
+// src/tags/if.ts
+function If(props) {
+  return props.test ? props.children ?? "" : "";
+}
+
+// src/tags/where.ts
+function Where(props) {
+  const children = removeLeadingAndOr(resolveNode(props.children ?? ""));
+  if (isBlank(children)) {
+    return "";
+  }
+  return [" WHERE ", children];
+}
+function removeLeadingAndOr(nodes) {
+  const firstConditionIndex = nodes.findIndex((node) => typeof node !== "string" || node.trim().length > 0);
+  if (firstConditionIndex === -1) {
+    return [];
+  }
+  const firstCondition = nodes[firstConditionIndex];
+  if (typeof firstCondition !== "string") {
+    return nodes;
+  }
+  return [
+    ...nodes.slice(0, firstConditionIndex),
+    removeLeadingAndOrText(firstCondition),
+    ...nodes.slice(firstConditionIndex + 1)
+  ];
+}
+function removeLeadingAndOrText(text) {
+  return text.replace(/^\s*(AND|OR)\b\s*/i, "");
+}
+function isBlank(nodes) {
+  return nodes.every((node) => typeof node === "string" && node.trim().length === 0);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  $,
+  If,
+  Where,
+  compile
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/internal/escape.ts","../src/node.ts","../src/internal/resolve.ts","../src/compile.ts","../src/param.ts","../src/tags/if.ts","../src/tags/where.ts"],"sourcesContent":["export { compile } from \"./compile\";\nexport { $ } from \"./param\";\nexport { If } from \"./tags/if\";\nexport { Where } from \"./tags/where\";\nexport type { CompileResult } from \"./compile\";\nexport type { IfProps } from \"./tags/if\";\nexport type { SqlParam } from \"./param\";\n","export function escapeSqlTextValue(value: unknown): string {\r\n  if (value === null || value === undefined) {\r\n    return \"NULL\";\r\n  }\r\n\r\n  if (typeof value === \"number\") {\r\n    return Number.isFinite(value) ? String(value) : \"NULL\";\r\n  }\r\n\r\n  if (typeof value === \"bigint\") {\r\n    return value.toString();\r\n  }\r\n\r\n  if (typeof value === \"boolean\") {\r\n    return value ? \"TRUE\" : \"FALSE\";\r\n  }\r\n\r\n  if (value instanceof Date) {\r\n    return quoteString(value.toISOString());\r\n  }\r\n\r\n  return quoteString(String(value));\r\n}\r\n\r\nfunction quoteString(value: string): string {\r\n  return `'${value.replaceAll(\"'\", \"''\")}'`;\r\n}\r\n","import type { SqlParam } from \"./param\";\n\nconst FRAGMENT_SYMBOL = \"tsx-sql.fragment\";\n\n// SQL fragments are transparent wrappers for <>...</>.\nexport const SqlFragment = Symbol.for(FRAGMENT_SYMBOL);\n\r\n// Any piece of SQL content that compile(...) knows how to read.\n// You can write:\n//   <>WHERE name = { $(\"Tom\") }</>\n// TSX stores those children as:\r\n//   [\"WHERE name = \", SqlParam]\r\n// Nested tags are also SqlNode values, so children can contain more elements.\nexport type SqlNode = string | SqlParam | SqlElement | SqlNode[];\n\ntype SqlProps = Record<string, unknown>;\n\nexport type SqlComponentProps = SqlProps & { children?: SqlNode };\n\n// A function that can be used as a TSX SQL tag.\n// You can write:\n//   <If test={name}>...</If>\n// The element stores the If function in its type field, and compile(...)\n// calls that function to decide which SqlNode should be compiled next.\nexport type SqlComponent = (props: SqlComponentProps) => SqlNode;\n\r\n// The object created by createNode(...) after TypeScript compiles TSX.\r\n// You can write:\r\n//   <If test={name}>AND name = { $(\"Tom\") }</If>\r\n// Runtime stores:\r\n//   { type: If, props: { test: name, children: [\"AND name = \", SqlParam] } }\r\n// Fragment elements use SqlFragment as their type and only wrap children.\r\nexport interface SqlElement {\n  kind: \"element\";\n  type: typeof SqlFragment | SqlComponent;\n  props: SqlProps;\n  children?: SqlNode;\n}\n\n// TypeScript calls this through jsx/jsxs/jsxDEV after compiling TSX.\n// We keep the node shape tiny: just the tag/component type and its props.\nexport function createNode(type: SqlElement[\"type\"], props: (SqlProps & { children?: SqlNode }) | null): SqlElement {\n  const { children, ...restProps } = props ?? {};\n\n  return {\n    kind: \"element\",\n    type,\n    props: restProps,\n    children\n  };\n}\n","import { SqlFragment, type SqlComponentProps, type SqlElement, type SqlNode } from \"../node\";\nimport type { SqlParam } from \"tsx-sql\";\n\nexport type ResolvedSqlNode = string | SqlParam;\n\nexport function resolveNode(input: SqlNode): ResolvedSqlNode[] {\n  if (Array.isArray(input)) {\n    return input.flatMap(resolveNode);\n  }\n\n  if (typeof input === \"string\") {\n    return [input];\n  }\n\n  if (input.kind === \"param\") {\n    return [input];\n  }\n\n  if (input.kind === \"element\") {\n    if (input.type === SqlFragment) {\n      return resolveNode(input.children ?? \"\");\n    }\n\n    return resolveNode(input.type(componentProps(input)));\n  }\n\n  return assertNever(input);\n}\n\nfunction componentProps(element: SqlElement): SqlComponentProps {\n  return {\n    ...element.props,\n    children: element.children\n  };\n}\n\nfunction assertNever(value: never): never {\n  throw new TypeError(`Unsupported SQL node: ${String(value)}`);\n}\n","import { escapeSqlTextValue } from \"./internal/escape\";\nimport { resolveNode } from \"./internal/resolve\";\nimport type { SqlNode } from \"./node\";\n\nexport interface CompileResult {\n  sql: string;\n  values: unknown[];\n  text: string;\n}\n\nexport function compile(input: SqlNode): CompileResult {\n  const sqlParts: string[] = [];\n  const values: unknown[] = [];\n  const textParts: string[] = [];\n\n  for (const node of resolveNode(input)) {\n    // Raw strings are SQL text, not parameters.\n    if (typeof node === \"string\") {\n      sqlParts.push(node);\n      textParts.push(node);\n      continue;\n    }\n\n    // Parameters become placeholders in executable SQL and values in order.\n    sqlParts.push(\"?\");\n    values.push(node.value);\n    textParts.push(escapeSqlTextValue(node.value));\n  }\n\n  return {\n    sql: compactWhitespace(sqlParts.join(\"\")),\n    values,\n    text: textParts.join(\"\")\n  };\n}\n\nfunction compactWhitespace(source: string): string {\n  return source.replace(/\\s+/g, \" \").trim();\n}\n","export interface SqlParam {\n  kind: \"param\";\n  value: unknown;\n}\n\nexport function $(value: unknown): SqlParam {\n  return {\n    kind: \"param\",\n    value\n  };\n}\n","import type { SqlComponentProps, SqlNode } from \"../node\";\n\nexport interface IfProps extends SqlComponentProps {\n  test: boolean;\n}\n\r\nexport function If(props: IfProps): SqlNode {\r\n  return props.test ? props.children ?? \"\" : \"\";\r\n}\r\n","import { resolveNode, type ResolvedSqlNode } from \"../internal/resolve\";\nimport type { SqlComponentProps, SqlNode } from \"../node\";\n\nexport function Where(props: SqlComponentProps): SqlNode {\n  const children = removeLeadingAndOr(resolveNode(props.children ?? \"\"));\n\n  if (isBlank(children)) {\n    return \"\";\n  }\n\n  return [\" WHERE \", children];\n}\n\nfunction removeLeadingAndOr(nodes: ResolvedSqlNode[]): ResolvedSqlNode[] {\n  // MyBatis where ignores leading whitespace, then removes a leading AND/OR.\n  const firstConditionIndex = nodes.findIndex((node) => typeof node !== \"string\" || node.trim().length > 0);\n  if (firstConditionIndex === -1) {\n    return [];\n  }\n\n  const firstCondition = nodes[firstConditionIndex];\n  if (typeof firstCondition !== \"string\") {\n    return nodes;\n  }\n\n  return [\n    ...nodes.slice(0, firstConditionIndex),\n    removeLeadingAndOrText(firstCondition),\n    ...nodes.slice(firstConditionIndex + 1)\n  ];\n}\n\nfunction removeLeadingAndOrText(text: string): string {\n  return text.replace(/^\\s*(AND|OR)\\b\\s*/i, \"\");\n}\n\nfunction isBlank(nodes: ResolvedSqlNode[]): boolean {\n  return nodes.every((node) => typeof node === \"string\" && node.trim().length === 0);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,18 @@
+import { S as SqlNode, a as SqlComponentProps } from './node-DV0niL4A.cjs';
+export { $, b as SqlParam } from './node-DV0niL4A.cjs';
+
+interface CompileResult {
+    sql: string;
+    values: unknown[];
+    text: string;
+}
+declare function compile(input: SqlNode): CompileResult;
+
+interface IfProps extends SqlComponentProps {
+    test: boolean;
+}
+declare function If(props: IfProps): SqlNode;
+
+declare function Where(props: SqlComponentProps): SqlNode;
+
+export { type CompileResult, If, type IfProps, Where, compile };

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { S as SqlNode, a as SqlComponentProps } from './node-DV0niL4A.js';
+export { $, b as SqlParam } from './node-DV0niL4A.js';
+
+interface CompileResult {
+    sql: string;
+    values: unknown[];
+    text: string;
+}
+declare function compile(input: SqlNode): CompileResult;
+
+interface IfProps extends SqlComponentProps {
+    test: boolean;
+}
+declare function If(props: IfProps): SqlNode;
+
+declare function Where(props: SqlComponentProps): SqlNode;
+
+export { type CompileResult, If, type IfProps, Where, compile };

package/dist/index.js

@@ -0,0 +1,130 @@
+// src/internal/escape.ts
+function escapeSqlTextValue(value) {
+  if (value === null || value === void 0) {
+    return "NULL";
+  }
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? String(value) : "NULL";
+  }
+  if (typeof value === "bigint") {
+    return value.toString();
+  }
+  if (typeof value === "boolean") {
+    return value ? "TRUE" : "FALSE";
+  }
+  if (value instanceof Date) {
+    return quoteString(value.toISOString());
+  }
+  return quoteString(String(value));
+}
+function quoteString(value) {
+  return `'${value.replaceAll("'", "''")}'`;
+}
+
+// src/node.ts
+var FRAGMENT_SYMBOL = "tsx-sql.fragment";
+var SqlFragment = Symbol.for(FRAGMENT_SYMBOL);
+
+// src/internal/resolve.ts
+function resolveNode(input) {
+  if (Array.isArray(input)) {
+    return input.flatMap(resolveNode);
+  }
+  if (typeof input === "string") {
+    return [input];
+  }
+  if (input.kind === "param") {
+    return [input];
+  }
+  if (input.kind === "element") {
+    if (input.type === SqlFragment) {
+      return resolveNode(input.children ?? "");
+    }
+    return resolveNode(input.type(componentProps(input)));
+  }
+  return assertNever(input);
+}
+function componentProps(element) {
+  return {
+    ...element.props,
+    children: element.children
+  };
+}
+function assertNever(value) {
+  throw new TypeError(`Unsupported SQL node: ${String(value)}`);
+}
+
+// src/compile.ts
+function compile(input) {
+  const sqlParts = [];
+  const values = [];
+  const textParts = [];
+  for (const node of resolveNode(input)) {
+    if (typeof node === "string") {
+      sqlParts.push(node);
+      textParts.push(node);
+      continue;
+    }
+    sqlParts.push("?");
+    values.push(node.value);
+    textParts.push(escapeSqlTextValue(node.value));
+  }
+  return {
+    sql: compactWhitespace(sqlParts.join("")),
+    values,
+    text: textParts.join("")
+  };
+}
+function compactWhitespace(source) {
+  return source.replace(/\s+/g, " ").trim();
+}
+
+// src/param.ts
+function $(value) {
+  return {
+    kind: "param",
+    value
+  };
+}
+
+// src/tags/if.ts
+function If(props) {
+  return props.test ? props.children ?? "" : "";
+}
+
+// src/tags/where.ts
+function Where(props) {
+  const children = removeLeadingAndOr(resolveNode(props.children ?? ""));
+  if (isBlank(children)) {
+    return "";
+  }
+  return [" WHERE ", children];
+}
+function removeLeadingAndOr(nodes) {
+  const firstConditionIndex = nodes.findIndex((node) => typeof node !== "string" || node.trim().length > 0);
+  if (firstConditionIndex === -1) {
+    return [];
+  }
+  const firstCondition = nodes[firstConditionIndex];
+  if (typeof firstCondition !== "string") {
+    return nodes;
+  }
+  return [
+    ...nodes.slice(0, firstConditionIndex),
+    removeLeadingAndOrText(firstCondition),
+    ...nodes.slice(firstConditionIndex + 1)
+  ];
+}
+function removeLeadingAndOrText(text) {
+  return text.replace(/^\s*(AND|OR)\b\s*/i, "");
+}
+function isBlank(nodes) {
+  return nodes.every((node) => typeof node === "string" && node.trim().length === 0);
+}
+export {
+  $,
+  If,
+  Where,
+  compile
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/escape.ts","../src/node.ts","../src/internal/resolve.ts","../src/compile.ts","../src/param.ts","../src/tags/if.ts","../src/tags/where.ts"],"sourcesContent":["export function escapeSqlTextValue(value: unknown): string {\r\n  if (value === null || value === undefined) {\r\n    return \"NULL\";\r\n  }\r\n\r\n  if (typeof value === \"number\") {\r\n    return Number.isFinite(value) ? String(value) : \"NULL\";\r\n  }\r\n\r\n  if (typeof value === \"bigint\") {\r\n    return value.toString();\r\n  }\r\n\r\n  if (typeof value === \"boolean\") {\r\n    return value ? \"TRUE\" : \"FALSE\";\r\n  }\r\n\r\n  if (value instanceof Date) {\r\n    return quoteString(value.toISOString());\r\n  }\r\n\r\n  return quoteString(String(value));\r\n}\r\n\r\nfunction quoteString(value: string): string {\r\n  return `'${value.replaceAll(\"'\", \"''\")}'`;\r\n}\r\n","import type { SqlParam } from \"./param\";\n\nconst FRAGMENT_SYMBOL = \"tsx-sql.fragment\";\n\n// SQL fragments are transparent wrappers for <>...</>.\nexport const SqlFragment = Symbol.for(FRAGMENT_SYMBOL);\n\r\n// Any piece of SQL content that compile(...) knows how to read.\n// You can write:\n//   <>WHERE name = { $(\"Tom\") }</>\n// TSX stores those children as:\r\n//   [\"WHERE name = \", SqlParam]\r\n// Nested tags are also SqlNode values, so children can contain more elements.\nexport type SqlNode = string | SqlParam | SqlElement | SqlNode[];\n\ntype SqlProps = Record<string, unknown>;\n\nexport type SqlComponentProps = SqlProps & { children?: SqlNode };\n\n// A function that can be used as a TSX SQL tag.\n// You can write:\n//   <If test={name}>...</If>\n// The element stores the If function in its type field, and compile(...)\n// calls that function to decide which SqlNode should be compiled next.\nexport type SqlComponent = (props: SqlComponentProps) => SqlNode;\n\r\n// The object created by createNode(...) after TypeScript compiles TSX.\r\n// You can write:\r\n//   <If test={name}>AND name = { $(\"Tom\") }</If>\r\n// Runtime stores:\r\n//   { type: If, props: { test: name, children: [\"AND name = \", SqlParam] } }\r\n// Fragment elements use SqlFragment as their type and only wrap children.\r\nexport interface SqlElement {\n  kind: \"element\";\n  type: typeof SqlFragment | SqlComponent;\n  props: SqlProps;\n  children?: SqlNode;\n}\n\n// TypeScript calls this through jsx/jsxs/jsxDEV after compiling TSX.\n// We keep the node shape tiny: just the tag/component type and its props.\nexport function createNode(type: SqlElement[\"type\"], props: (SqlProps & { children?: SqlNode }) | null): SqlElement {\n  const { children, ...restProps } = props ?? {};\n\n  return {\n    kind: \"element\",\n    type,\n    props: restProps,\n    children\n  };\n}\n","import { SqlFragment, type SqlComponentProps, type SqlElement, type SqlNode } from \"../node\";\nimport type { SqlParam } from \"tsx-sql\";\n\nexport type ResolvedSqlNode = string | SqlParam;\n\nexport function resolveNode(input: SqlNode): ResolvedSqlNode[] {\n  if (Array.isArray(input)) {\n    return input.flatMap(resolveNode);\n  }\n\n  if (typeof input === \"string\") {\n    return [input];\n  }\n\n  if (input.kind === \"param\") {\n    return [input];\n  }\n\n  if (input.kind === \"element\") {\n    if (input.type === SqlFragment) {\n      return resolveNode(input.children ?? \"\");\n    }\n\n    return resolveNode(input.type(componentProps(input)));\n  }\n\n  return assertNever(input);\n}\n\nfunction componentProps(element: SqlElement): SqlComponentProps {\n  return {\n    ...element.props,\n    children: element.children\n  };\n}\n\nfunction assertNever(value: never): never {\n  throw new TypeError(`Unsupported SQL node: ${String(value)}`);\n}\n","import { escapeSqlTextValue } from \"./internal/escape\";\nimport { resolveNode } from \"./internal/resolve\";\nimport type { SqlNode } from \"./node\";\n\nexport interface CompileResult {\n  sql: string;\n  values: unknown[];\n  text: string;\n}\n\nexport function compile(input: SqlNode): CompileResult {\n  const sqlParts: string[] = [];\n  const values: unknown[] = [];\n  const textParts: string[] = [];\n\n  for (const node of resolveNode(input)) {\n    // Raw strings are SQL text, not parameters.\n    if (typeof node === \"string\") {\n      sqlParts.push(node);\n      textParts.push(node);\n      continue;\n    }\n\n    // Parameters become placeholders in executable SQL and values in order.\n    sqlParts.push(\"?\");\n    values.push(node.value);\n    textParts.push(escapeSqlTextValue(node.value));\n  }\n\n  return {\n    sql: compactWhitespace(sqlParts.join(\"\")),\n    values,\n    text: textParts.join(\"\")\n  };\n}\n\nfunction compactWhitespace(source: string): string {\n  return source.replace(/\\s+/g, \" \").trim();\n}\n","export interface SqlParam {\n  kind: \"param\";\n  value: unknown;\n}\n\nexport function $(value: unknown): SqlParam {\n  return {\n    kind: \"param\",\n    value\n  };\n}\n","import type { SqlComponentProps, SqlNode } from \"../node\";\n\nexport interface IfProps extends SqlComponentProps {\n  test: boolean;\n}\n\r\nexport function If(props: IfProps): SqlNode {\r\n  return props.test ? props.children ?? \"\" : \"\";\r\n}\r\n","import { resolveNode, type ResolvedSqlNode } from \"../internal/resolve\";\nimport type { SqlComponentProps, SqlNode } from \"../node\";\n\nexport function Where(props: SqlComponentProps): SqlNode {\n  const children = removeLeadingAndOr(resolveNode(props.children ?? \"\"));\n\n  if (isBlank(children)) {\n    return \"\";\n  }\n\n  return [\" WHERE \", children];\n}\n\nfunction removeLeadingAndOr(nodes: ResolvedSqlNode[]): ResolvedSqlNode[] {\n  // MyBatis where ignores leading whitespace, then removes a leading AND/OR.\n  const firstConditionIndex = nodes.findIndex((node) => typeof node !== \"string\" || node.trim().length > 0);\n  if (firstConditionIndex === -1) {\n    return [];\n  }\n\n  const firstCondition = nodes[firstConditionIndex];\n  if (typeof firstCondition !== \"string\") {\n    return nodes;\n  }\n\n  return [\n    ...nodes.slice(0, firstConditionIndex),\n    removeLeadingAndOrText(firstCondition),\n    ...nodes.slice(firstConditionIndex + 1)\n  ];\n}\n\nfunction removeLeadingAndOrText(text: string): string {\n  return text.replace(/^\\s*(AND|OR)\\b\\s*/i, \"\");\n}\n\nfunction isBlank(nodes: ResolvedSqlNode[]): boolean {\n  return nodes.every((node) => typeof node === \"string\" && node.trim().length === 0);\n}\n"],"mappings":"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","names":[]}

package/dist/jsx-dev-runtime.cjs

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/jsx-dev-runtime.ts
+var jsx_dev_runtime_exports = {};
+__export(jsx_dev_runtime_exports, {
+  Fragment: () => SqlFragment,
+  jsx: () => jsx,
+  jsxDEV: () => createNode,
+  jsxs: () => jsxs
+});
+module.exports = __toCommonJS(jsx_dev_runtime_exports);
+
+// src/node.ts
+var FRAGMENT_SYMBOL = "tsx-sql.fragment";
+var SqlFragment = Symbol.for(FRAGMENT_SYMBOL);
+function createNode(type, props) {
+  const { children, ...restProps } = props ?? {};
+  return {
+    kind: "element",
+    type,
+    props: restProps,
+    children
+  };
+}
+
+// src/jsx-runtime.ts
+var jsx = createNode;
+var jsxs = createNode;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Fragment,
+  jsx,
+  jsxDEV,
+  jsxs
+});
+//# sourceMappingURL=jsx-dev-runtime.cjs.map

package/dist/jsx-dev-runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/jsx-dev-runtime.ts","../src/node.ts","../src/jsx-runtime.ts"],"sourcesContent":["export { Fragment, jsx, jsxs } from \"./jsx-runtime\";\nexport { createNode as jsxDEV } from \"./node\";\n","import type { SqlParam } from \"./param\";\n\nconst FRAGMENT_SYMBOL = \"tsx-sql.fragment\";\n\n// SQL fragments are transparent wrappers for <>...</>.\nexport const SqlFragment = Symbol.for(FRAGMENT_SYMBOL);\n\r\n// Any piece of SQL content that compile(...) knows how to read.\n// You can write:\n//   <>WHERE name = { $(\"Tom\") }</>\n// TSX stores those children as:\r\n//   [\"WHERE name = \", SqlParam]\r\n// Nested tags are also SqlNode values, so children can contain more elements.\nexport type SqlNode = string | SqlParam | SqlElement | SqlNode[];\n\ntype SqlProps = Record<string, unknown>;\n\nexport type SqlComponentProps = SqlProps & { children?: SqlNode };\n\n// A function that can be used as a TSX SQL tag.\n// You can write:\n//   <If test={name}>...</If>\n// The element stores the If function in its type field, and compile(...)\n// calls that function to decide which SqlNode should be compiled next.\nexport type SqlComponent = (props: SqlComponentProps) => SqlNode;\n\r\n// The object created by createNode(...) after TypeScript compiles TSX.\r\n// You can write:\r\n//   <If test={name}>AND name = { $(\"Tom\") }</If>\r\n// Runtime stores:\r\n//   { type: If, props: { test: name, children: [\"AND name = \", SqlParam] } }\r\n// Fragment elements use SqlFragment as their type and only wrap children.\r\nexport interface SqlElement {\n  kind: \"element\";\n  type: typeof SqlFragment | SqlComponent;\n  props: SqlProps;\n  children?: SqlNode;\n}\n\n// TypeScript calls this through jsx/jsxs/jsxDEV after compiling TSX.\n// We keep the node shape tiny: just the tag/component type and its props.\nexport function createNode(type: SqlElement[\"type\"], props: (SqlProps & { children?: SqlNode }) | null): SqlElement {\n  const { children, ...restProps } = props ?? {};\n\n  return {\n    kind: \"element\",\n    type,\n    props: restProps,\n    children\n  };\n}\n","import { createNode, SqlFragment } from \"./node\";\nimport type { SqlNode } from \"./node\";\n\ndeclare global {\n  namespace JSX {\n    type Element = SqlNode;\n\n    interface ElementChildrenAttribute {\n      children: {};\n    }\n  }\n}\n\nexport { SqlFragment as Fragment };\n\nexport const jsx = createNode;\nexport const jsxs = createNode;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,IAAM,kBAAkB;AAGjB,IAAM,cAAc,OAAO,IAAI,eAAe;AAoC9C,SAAS,WAAW,MAA0B,OAA+D;AAClH,QAAM,EAAE,UAAU,GAAG,UAAU,IAAI,SAAS,CAAC;AAE7C,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,OAAO;AAAA,IACP;AAAA,EACF;AACF;;;ACnCO,IAAM,MAAM;AACZ,IAAM,OAAO;","names":[]}

package/dist/jsx-dev-runtime.d.cts

@@ -0,0 +1,2 @@
+export { jsx, jsxs } from './jsx-runtime.cjs';
+export { d as Fragment, c as jsxDEV } from './node-DV0niL4A.cjs';

package/dist/jsx-dev-runtime.d.ts

@@ -0,0 +1,2 @@
+export { jsx, jsxs } from './jsx-runtime.js';
+export { d as Fragment, c as jsxDEV } from './node-DV0niL4A.js';

package/dist/jsx-dev-runtime.js

@@ -0,0 +1,23 @@
+// src/node.ts
+var FRAGMENT_SYMBOL = "tsx-sql.fragment";
+var SqlFragment = Symbol.for(FRAGMENT_SYMBOL);
+function createNode(type, props) {
+  const { children, ...restProps } = props ?? {};
+  return {
+    kind: "element",
+    type,
+    props: restProps,
+    children
+  };
+}
+
+// src/jsx-runtime.ts
+var jsx = createNode;
+var jsxs = createNode;
+export {
+  SqlFragment as Fragment,
+  jsx,
+  createNode as jsxDEV,
+  jsxs
+};
+//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/jsx-dev-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node.ts","../src/jsx-runtime.ts"],"sourcesContent":["import type { SqlParam } from \"./param\";\n\nconst FRAGMENT_SYMBOL = \"tsx-sql.fragment\";\n\n// SQL fragments are transparent wrappers for <>...</>.\nexport const SqlFragment = Symbol.for(FRAGMENT_SYMBOL);\n\r\n// Any piece of SQL content that compile(...) knows how to read.\n// You can write:\n//   <>WHERE name = { $(\"Tom\") }</>\n// TSX stores those children as:\r\n//   [\"WHERE name = \", SqlParam]\r\n// Nested tags are also SqlNode values, so children can contain more elements.\nexport type SqlNode = string | SqlParam | SqlElement | SqlNode[];\n\ntype SqlProps = Record<string, unknown>;\n\nexport type SqlComponentProps = SqlProps & { children?: SqlNode };\n\n// A function that can be used as a TSX SQL tag.\n// You can write:\n//   <If test={name}>...</If>\n// The element stores the If function in its type field, and compile(...)\n// calls that function to decide which SqlNode should be compiled next.\nexport type SqlComponent = (props: SqlComponentProps) => SqlNode;\n\r\n// The object created by createNode(...) after TypeScript compiles TSX.\r\n// You can write:\r\n//   <If test={name}>AND name = { $(\"Tom\") }</If>\r\n// Runtime stores:\r\n//   { type: If, props: { test: name, children: [\"AND name = \", SqlParam] } }\r\n// Fragment elements use SqlFragment as their type and only wrap children.\r\nexport interface SqlElement {\n  kind: \"element\";\n  type: typeof SqlFragment | SqlComponent;\n  props: SqlProps;\n  children?: SqlNode;\n}\n\n// TypeScript calls this through jsx/jsxs/jsxDEV after compiling TSX.\n// We keep the node shape tiny: just the tag/component type and its props.\nexport function createNode(type: SqlElement[\"type\"], props: (SqlProps & { children?: SqlNode }) | null): SqlElement {\n  const { children, ...restProps } = props ?? {};\n\n  return {\n    kind: \"element\",\n    type,\n    props: restProps,\n    children\n  };\n}\n","import { createNode, SqlFragment } from \"./node\";\nimport type { SqlNode } from \"./node\";\n\ndeclare global {\n  namespace JSX {\n    type Element = SqlNode;\n\n    interface ElementChildrenAttribute {\n      children: {};\n    }\n  }\n}\n\nexport { SqlFragment as Fragment };\n\nexport const jsx = createNode;\nexport const jsxs = createNode;\n"],"mappings":";AAEA,IAAM,kBAAkB;AAGjB,IAAM,cAAc,OAAO,IAAI,eAAe;AAoC9C,SAAS,WAAW,MAA0B,OAA+D;AAClH,QAAM,EAAE,UAAU,GAAG,UAAU,IAAI,SAAS,CAAC;AAE7C,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,OAAO;AAAA,IACP;AAAA,EACF;AACF;;;ACnCO,IAAM,MAAM;AACZ,IAAM,OAAO;","names":[]}

package/dist/jsx-runtime.cjs

@@ -0,0 +1,51 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/jsx-runtime.ts
+var jsx_runtime_exports = {};
+__export(jsx_runtime_exports, {
+  Fragment: () => SqlFragment,
+  jsx: () => jsx,
+  jsxs: () => jsxs
+});
+module.exports = __toCommonJS(jsx_runtime_exports);
+
+// src/node.ts
+var FRAGMENT_SYMBOL = "tsx-sql.fragment";
+var SqlFragment = Symbol.for(FRAGMENT_SYMBOL);
+function createNode(type, props) {
+  const { children, ...restProps } = props ?? {};
+  return {
+    kind: "element",
+    type,
+    props: restProps,
+    children
+  };
+}
+
+// src/jsx-runtime.ts
+var jsx = createNode;
+var jsxs = createNode;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Fragment,
+  jsx,
+  jsxs
+});
+//# sourceMappingURL=jsx-runtime.cjs.map

package/dist/jsx-runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/jsx-runtime.ts","../src/node.ts"],"sourcesContent":["import { createNode, SqlFragment } from \"./node\";\nimport type { SqlNode } from \"./node\";\n\ndeclare global {\n  namespace JSX {\n    type Element = SqlNode;\n\n    interface ElementChildrenAttribute {\n      children: {};\n    }\n  }\n}\n\nexport { SqlFragment as Fragment };\n\nexport const jsx = createNode;\nexport const jsxs = createNode;\n","import type { SqlParam } from \"./param\";\n\nconst FRAGMENT_SYMBOL = \"tsx-sql.fragment\";\n\n// SQL fragments are transparent wrappers for <>...</>.\nexport const SqlFragment = Symbol.for(FRAGMENT_SYMBOL);\n\r\n// Any piece of SQL content that compile(...) knows how to read.\n// You can write:\n//   <>WHERE name = { $(\"Tom\") }</>\n// TSX stores those children as:\r\n//   [\"WHERE name = \", SqlParam]\r\n// Nested tags are also SqlNode values, so children can contain more elements.\nexport type SqlNode = string | SqlParam | SqlElement | SqlNode[];\n\ntype SqlProps = Record<string, unknown>;\n\nexport type SqlComponentProps = SqlProps & { children?: SqlNode };\n\n// A function that can be used as a TSX SQL tag.\n// You can write:\n//   <If test={name}>...</If>\n// The element stores the If function in its type field, and compile(...)\n// calls that function to decide which SqlNode should be compiled next.\nexport type SqlComponent = (props: SqlComponentProps) => SqlNode;\n\r\n// The object created by createNode(...) after TypeScript compiles TSX.\r\n// You can write:\r\n//   <If test={name}>AND name = { $(\"Tom\") }</If>\r\n// Runtime stores:\r\n//   { type: If, props: { test: name, children: [\"AND name = \", SqlParam] } }\r\n// Fragment elements use SqlFragment as their type and only wrap children.\r\nexport interface SqlElement {\n  kind: \"element\";\n  type: typeof SqlFragment | SqlComponent;\n  props: SqlProps;\n  children?: SqlNode;\n}\n\n// TypeScript calls this through jsx/jsxs/jsxDEV after compiling TSX.\n// We keep the node shape tiny: just the tag/component type and its props.\nexport function createNode(type: SqlElement[\"type\"], props: (SqlProps & { children?: SqlNode }) | null): SqlElement {\n  const { children, ...restProps } = props ?? {};\n\n  return {\n    kind: \"element\",\n    type,\n    props: restProps,\n    children\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,IAAM,kBAAkB;AAGjB,IAAM,cAAc,OAAO,IAAI,eAAe;AAoC9C,SAAS,WAAW,MAA0B,OAA+D;AAClH,QAAM,EAAE,UAAU,GAAG,UAAU,IAAI,SAAS,CAAC;AAE7C,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,OAAO;AAAA,IACP;AAAA,EACF;AACF;;;ADnCO,IAAM,MAAM;AACZ,IAAM,OAAO;","names":[]}

package/dist/jsx-runtime.d.cts

@@ -0,0 +1,16 @@
+import { S as SqlNode, c as createNode } from './node-DV0niL4A.cjs';
+export { d as Fragment } from './node-DV0niL4A.cjs';
+
+declare global {
+    namespace JSX {
+        type Element = SqlNode;
+        interface ElementChildrenAttribute {
+            children: {};
+        }
+    }
+}
+
+declare const jsx: typeof createNode;
+declare const jsxs: typeof createNode;
+
+export { jsx, jsxs };

package/dist/jsx-runtime.d.ts

@@ -0,0 +1,16 @@
+import { S as SqlNode, c as createNode } from './node-DV0niL4A.js';
+export { d as Fragment } from './node-DV0niL4A.js';
+
+declare global {
+    namespace JSX {
+        type Element = SqlNode;
+        interface ElementChildrenAttribute {
+            children: {};
+        }
+    }
+}
+
+declare const jsx: typeof createNode;
+declare const jsxs: typeof createNode;
+
+export { jsx, jsxs };

package/dist/jsx-runtime.js

@@ -0,0 +1,22 @@
+// src/node.ts
+var FRAGMENT_SYMBOL = "tsx-sql.fragment";
+var SqlFragment = Symbol.for(FRAGMENT_SYMBOL);
+function createNode(type, props) {
+  const { children, ...restProps } = props ?? {};
+  return {
+    kind: "element",
+    type,
+    props: restProps,
+    children
+  };
+}
+
+// src/jsx-runtime.ts
+var jsx = createNode;
+var jsxs = createNode;
+export {
+  SqlFragment as Fragment,
+  jsx,
+  jsxs
+};
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node.ts","../src/jsx-runtime.ts"],"sourcesContent":["import type { SqlParam } from \"./param\";\n\nconst FRAGMENT_SYMBOL = \"tsx-sql.fragment\";\n\n// SQL fragments are transparent wrappers for <>...</>.\nexport const SqlFragment = Symbol.for(FRAGMENT_SYMBOL);\n\r\n// Any piece of SQL content that compile(...) knows how to read.\n// You can write:\n//   <>WHERE name = { $(\"Tom\") }</>\n// TSX stores those children as:\r\n//   [\"WHERE name = \", SqlParam]\r\n// Nested tags are also SqlNode values, so children can contain more elements.\nexport type SqlNode = string | SqlParam | SqlElement | SqlNode[];\n\ntype SqlProps = Record<string, unknown>;\n\nexport type SqlComponentProps = SqlProps & { children?: SqlNode };\n\n// A function that can be used as a TSX SQL tag.\n// You can write:\n//   <If test={name}>...</If>\n// The element stores the If function in its type field, and compile(...)\n// calls that function to decide which SqlNode should be compiled next.\nexport type SqlComponent = (props: SqlComponentProps) => SqlNode;\n\r\n// The object created by createNode(...) after TypeScript compiles TSX.\r\n// You can write:\r\n//   <If test={name}>AND name = { $(\"Tom\") }</If>\r\n// Runtime stores:\r\n//   { type: If, props: { test: name, children: [\"AND name = \", SqlParam] } }\r\n// Fragment elements use SqlFragment as their type and only wrap children.\r\nexport interface SqlElement {\n  kind: \"element\";\n  type: typeof SqlFragment | SqlComponent;\n  props: SqlProps;\n  children?: SqlNode;\n}\n\n// TypeScript calls this through jsx/jsxs/jsxDEV after compiling TSX.\n// We keep the node shape tiny: just the tag/component type and its props.\nexport function createNode(type: SqlElement[\"type\"], props: (SqlProps & { children?: SqlNode }) | null): SqlElement {\n  const { children, ...restProps } = props ?? {};\n\n  return {\n    kind: \"element\",\n    type,\n    props: restProps,\n    children\n  };\n}\n","import { createNode, SqlFragment } from \"./node\";\nimport type { SqlNode } from \"./node\";\n\ndeclare global {\n  namespace JSX {\n    type Element = SqlNode;\n\n    interface ElementChildrenAttribute {\n      children: {};\n    }\n  }\n}\n\nexport { SqlFragment as Fragment };\n\nexport const jsx = createNode;\nexport const jsxs = createNode;\n"],"mappings":";AAEA,IAAM,kBAAkB;AAGjB,IAAM,cAAc,OAAO,IAAI,eAAe;AAoC9C,SAAS,WAAW,MAA0B,OAA+D;AAClH,QAAM,EAAE,UAAU,GAAG,UAAU,IAAI,SAAS,CAAC;AAE7C,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,OAAO;AAAA,IACP;AAAA,EACF;AACF;;;ACnCO,IAAM,MAAM;AACZ,IAAM,OAAO;","names":[]}

package/dist/node-DV0niL4A.d.cts

@@ -0,0 +1,24 @@
+interface SqlParam {
+    kind: "param";
+    value: unknown;
+}
+declare function $(value: unknown): SqlParam;
+
+declare const SqlFragment: unique symbol;
+type SqlNode = string | SqlParam | SqlElement | SqlNode[];
+type SqlProps = Record<string, unknown>;
+type SqlComponentProps = SqlProps & {
+    children?: SqlNode;
+};
+type SqlComponent = (props: SqlComponentProps) => SqlNode;
+interface SqlElement {
+    kind: "element";
+    type: typeof SqlFragment | SqlComponent;
+    props: SqlProps;
+    children?: SqlNode;
+}
+declare function createNode(type: SqlElement["type"], props: (SqlProps & {
+    children?: SqlNode;
+}) | null): SqlElement;
+
+export { $, type SqlNode as S, type SqlComponentProps as a, type SqlParam as b, createNode as c, SqlFragment as d };

package/dist/node-DV0niL4A.d.ts

@@ -0,0 +1,24 @@
+interface SqlParam {
+    kind: "param";
+    value: unknown;
+}
+declare function $(value: unknown): SqlParam;
+
+declare const SqlFragment: unique symbol;
+type SqlNode = string | SqlParam | SqlElement | SqlNode[];
+type SqlProps = Record<string, unknown>;
+type SqlComponentProps = SqlProps & {
+    children?: SqlNode;
+};
+type SqlComponent = (props: SqlComponentProps) => SqlNode;
+interface SqlElement {
+    kind: "element";
+    type: typeof SqlFragment | SqlComponent;
+    props: SqlProps;
+    children?: SqlNode;
+}
+declare function createNode(type: SqlElement["type"], props: (SqlProps & {
+    children?: SqlNode;
+}) | null): SqlElement;
+
+export { $, type SqlNode as S, type SqlComponentProps as a, type SqlParam as b, createNode as c, SqlFragment as d };

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "tsx-sql",
+  "version": "0.1.0",
+  "description": "Compile TSX SQL fragments into parameterized SQL.",
+  "keywords": [
+    "sql",
+    "tsx",
+    "jsx",
+    "typescript",
+    "mybatis",
+    "query-builder"
+  ],
+  "author": "GuXianWN",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GuXianWN/tsx-sql.git"
+  },
+  "bugs": {
+    "url": "https://github.com/GuXianWN/tsx-sql/issues"
+  },
+  "homepage": "https://github.com/GuXianWN/tsx-sql#readme",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "packageManager": "pnpm@9.15.0",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./jsx-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "import": "./dist/jsx-runtime.js",
+      "require": "./dist/jsx-runtime.cjs"
+    },
+    "./jsx-dev-runtime": {
+      "types": "./dist/jsx-dev-runtime.d.ts",
+      "import": "./dist/jsx-dev-runtime.js",
+      "require": "./dist/jsx-dev-runtime.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "pnpm test && pnpm typecheck && pnpm build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
+  }
+}