@ktjs/babel-plugin-ktjsx 0.1.0 → 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kasukabe tsumugi
+
+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

@@ -1,25 +1,52 @@
-# babel-plugin-ktjsx
+# @ktjs/babel-plugin-ktjsx
 
-`@ktjs/babel-plugin-ktjsx` is a Babel plugin that enhances compiled JSX output to better support SVG and namespace-aware element creation.
+`@ktjs/babel-plugin-ktjsx` is the Babel entry for KT.js JSX transforms, re-exported from `@ktjs/transformer`.
 
-Basic usage (Babel):
+Current behavior:
+
+- add KT.js internal SVG / MathML flags on JSX elements in SVG / MathML context
+- validate directive combinations (`k-if` + `k-else`, and `k-for` mixed with conditional directives)
+- transform `k-for` into `source.map(...)` and remove `k-for` / `k-key` attributes
+- normalize sibling `k-if` / `k-else-if` / `k-else` chains into explicit `k-if` conditions
+
+## Install
+
+```bash
+pnpm add -D @ktjs/babel-plugin-ktjsx @babel/core
+```
+
+## Usage (ESM Babel config)
 
 ```js
-// babel.config.js
+// babel.config.mjs
+import ktjsx from '@ktjs/babel-plugin-ktjsx';
+
+export default {
+  plugins: [ktjsx],
+};
+```
+
+## Usage (CommonJS Babel config)
+
+```js
+// babel.config.cjs
+const { default: ktjsx } = require('@ktjs/babel-plugin-ktjsx');
+
 module.exports = {
-  plugins: [['@ktjs/babel-plugin-ktjsx', { svgTags: ['svg', 'g', 'path'] }]],
+  plugins: [ktjsx],
 };
 ```
 
-This plugin will transform calls like `createElement('svg', ...)` (or `h('svg', ...)`) into `createElementNS('http://www.w3.org/2000/svg', 'svg', ...)` so that SVG elements are created in the correct namespace.
+## Named exports
 
-Options:
+```ts
+import { transformerKTjsx, transformWithKTjsx } from '@ktjs/babel-plugin-ktjsx';
+```
 
-- `svgTags` - array of tag names to treat as SVG (default includes common SVG tags)
-- `namespaceURI` - SVG namespace (default `http://www.w3.org/2000/svg`)
-- `createElementNames` - functions to consider as element factories (default `['createElement','h']`)
+- `transformerKTjsx`: Babel plugin factory (same as default export)
+- `transformWithKTjsx`: programmatic transform helper
 
-Notes:
+## Notes
 
-- The plugin is intended to run after JSX has been transformed to `createElement`/`h` calls. If you use a custom JSX pragma, include that name in `createElementNames`.
-- A Rollup wrapper can be created to run this plugin during bundling; prefer using Babel for precise AST-level transforms.
+- This plugin works on JSX AST directly (not on `createElement(...)` output).
+- There are no custom plugin options yet.

package/dist/index.d.ts

@@ -1,6 +1 @@
-import { PluginObj } from '@babel/core';
-
-declare function babelKTjsx(): PluginObj;
-export default babelKTjsx;
-
-export { }
+export { KTjsxTransformOptions, default, transformWithKTjsx, transformerKTjsx } from '@ktjs/transformer';