sinwan-compiler 0.2.2 → 0.2.4

package/dist/auto-cc.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SinwanJS Compiler — Auto `cc` wrapping
+ *
+ * Detects top-level exported functions that look like components (uppercase
+ * name, 0–1 params, return JSX) and wraps them with `cc(...)` so the reactive
+ * analyzer treats them as components and the runtime gives them a component
+ * instance + displayName.
+ *
+ * This lets plain `export function App()` / `export const App = () => <div/>`
+ * work as Sinwan components without an explicit `cc(...)` call, matching the
+ * ergonomics of React function components while preserving Sinwan's explicit
+ * reactivity model (the compiler still only auto-wraps JSX expressions that
+ * read tracked reactive sources).
+ *
+ * Detection is conservative on purpose:
+ *   - Only exported bindings are considered (named or default export).
+ *   - The binding name must start with an uppercase letter (component naming
+ *     convention). Anonymous default-exported function declarations are also
+ *     accepted since they are conventionally components.
+ *   - The function must have 0 or 1 parameters and must lexically return JSX
+ *     (a JSXElement/JSXFragment in a return statement or arrow body).
+ *   - Functions already wrapped in `cc(...)` (or an alias) are skipped to keep
+ *     the transform idempotent.
+ *
+ * If any wrapping is performed and `cc` is not already imported from
+ * `sinwan` / `sinwan/component`, an `import { cc } from "sinwan/component"` is
+ * prepended so the subsequent reactive-wrap pass detects the components.
+ */
+import * as t from "@babel/types";
+/**
+ * Mutates the AST, wrapping exported component-like functions with `cc(...)`.
+ * Returns `true` if any wrapping was performed.
+ */
+export declare function autoWrapComponents(ast: t.Node, filename?: string): boolean;