@barefootjs/hono 0.1.0

package/dist/adapter/hono-adapter.d.ts

@@ -0,0 +1,141 @@
+/**
+ * BarefootJS Hono Adapter
+ *
+ * Generates Hono JSX from Pure IR.
+ */
+import { type ComponentIR, type IRNode, type IRElement, type IRText, type IRExpression, type IRConditional, type IRLoop, type IRComponent, type IRFragment, type IRIfStatement, type IRProvider, type IRAsync, type IRSlot, type AdapterGenerateOptions, type AdapterOutput, type JsxAdapterConfig, type IRNodeEmitter, type EmitIRNode, JsxAdapter } from '@barefootjs/jsx';
+/**
+ * Hono adapter's IRNode render context: which surrounding render
+ * state matters when lowering a node. The `IRNodeEmitter` dispatcher
+ * threads this `Ctx` unchanged into per-kind methods; per-method
+ * documentation below records which flags each kind consults.
+ */
+type HonoRenderCtx = {
+    isRootOfClientComponent?: boolean;
+    isInsideLoop?: boolean;
+    isLoopItemRoot?: boolean;
+};
+export interface HonoAdapterOptions {
+    /**
+     * Base path for client JS files (e.g., '/static/components/')
+     * Used to generate script src attributes.
+     */
+    clientJsBasePath?: string;
+    /**
+     * Path to barefoot.js runtime (e.g., '/static/components/barefoot.js')
+     */
+    barefootJsPath?: string;
+    /**
+     * Client JS filename (without path). When set, all components use this filename.
+     * When not set, uses `{componentName}.client.js`.
+     * Useful for files with multiple components that share a single client JS file.
+     */
+    clientJsFilename?: string;
+    /**
+     * Display name surfaced through `JsxAdapter.name` — read by `bf build`
+     * for its `Adapter: …` banner. Defaults to `'hono'`. CSR-mode callers
+     * (`@barefootjs/client/build`) pass `'csr'` so the banner reflects the
+     * mode the user picked at scaffold time instead of leaking the
+     * fact that CSR currently reuses HonoAdapter under the hood.
+     */
+    name?: string;
+}
+export declare class HonoAdapter extends JsxAdapter implements IRNodeEmitter<HonoRenderCtx> {
+    name: string;
+    extension: string;
+    clientShimSource: string;
+    acceptsTemplateCall: () => boolean;
+    protected jsxConfig: JsxAdapterConfig;
+    private options;
+    private isClientComponent;
+    private hasClientInteractivity;
+    private currentComponentHasProps;
+    /**
+     * Per-call relative-import rewriter supplied by the build pipeline so
+     * source-authored relative paths resolve correctly from the emitted
+     * file's on-disk position (#1453). Stashed for the duration of one
+     * `generate()` call so `generateImports` can apply it; cleared on exit
+     * so a singleton adapter instance does not leak state between
+     * components.
+     */
+    private rewriteRelativeImport?;
+    /** Stack of loop keys for generating data-key / data-key-1 attributes on loop items */
+    private loopKeyStack;
+    constructor(options?: HonoAdapterOptions);
+    generate(ir: ComponentIR, options?: AdapterGenerateOptions): AdapterOutput;
+    private generateModuleLevelContextBindings;
+    private generateImports;
+    generateTypes(ir: ComponentIR, componentBody?: string): string | null;
+    private getPropsTypeName;
+    private generateComponent;
+    /**
+     * Public entry point for node rendering. Delegates to the shared
+     * `IRNodeEmitter` dispatcher (#1290 step 1); per-kind logic lives in
+     * the `IRNodeEmitter` methods below.
+     */
+    renderNode(node: IRNode, ctx?: HonoRenderCtx): string;
+    emitElement(node: IRElement, ctx: HonoRenderCtx, _emit: EmitIRNode<HonoRenderCtx>): string;
+    emitText(node: IRText): string;
+    emitExpression(node: IRExpression): string;
+    emitConditional(node: IRConditional, _ctx: HonoRenderCtx, _emit: EmitIRNode<HonoRenderCtx>): string;
+    emitLoop(node: IRLoop, _ctx: HonoRenderCtx, _emit: EmitIRNode<HonoRenderCtx>): string;
+    emitComponent(node: IRComponent, ctx: HonoRenderCtx, _emit: EmitIRNode<HonoRenderCtx>): string;
+    emitFragment(node: IRFragment, _ctx: HonoRenderCtx, _emit: EmitIRNode<HonoRenderCtx>): string;
+    emitSlot(_node: IRSlot): string;
+    emitIfStatement(_node: IRIfStatement, _ctx: HonoRenderCtx, _emit: EmitIRNode<HonoRenderCtx>): string;
+    emitProvider(node: IRProvider, _ctx: HonoRenderCtx, _emit: EmitIRNode<HonoRenderCtx>): string;
+    emitAsync(node: IRAsync, _ctx: HonoRenderCtx, _emit: EmitIRNode<HonoRenderCtx>): string;
+    renderElement(element: IRElement, ctx?: {
+        isLoopItemRoot?: boolean;
+    }): string;
+    private renderText;
+    renderExpression(expr: IRExpression): string;
+    renderConditional(cond: IRConditional): string;
+    private wrapWithCondMarker;
+    renderLoop(loop: IRLoop): string;
+    private renderChildrenInLoop;
+    /**
+     * Render an if-statement chain as function-level code.
+     * This is used for components with early return patterns.
+     */
+    renderIfStatement(ifStmt: IRIfStatement, ctx?: {
+        isRootOfClientComponent?: boolean;
+    }): string;
+    renderAsync(node: IRAsync): string;
+    renderComponent(comp: IRComponent, ctx?: {
+        isRootOfClientComponent?: boolean;
+        isInsideLoop?: boolean;
+        isLoopItemRoot?: boolean;
+    }): string;
+    private renderFragment;
+    /**
+     * Wrap `body` in a fragment-rooted scope comment.
+     * Shape (matches `hydrate.ts::hydrateCommentScope`):
+     *   root:  <!--bf-scope:<scopeId>|<propsJson>-->
+     *   child: <!--bf-scope:<scopeId>|h=<host>|m=<slot>|<propsJson>-->
+     * `<scopeId>` stays at the front so child detection can anchor on `|h=`.
+     */
+    private wrapWithScopeComment;
+    /**
+     * AttrValue lowering for intrinsic-element attributes (Hono JSX).
+     * Per-kind logic that used to live in a `switch (v.kind)` inside
+     * `renderAttributes`; routed through the shared dispatcher so a new
+     * AttrValue kind becomes a TS compile error here (#1290 step 2).
+     */
+    private readonly elementAttrEmitter;
+    /**
+     * AttrValue lowering for component-invocation props (Hono JSX).
+     * Component props differ from intrinsic attrs in several places —
+     * `jsx-children` is rendered as `<>…</>`, `expression` skips the
+     * boolean-attr fold, etc. Kept as a separate emitter so each method
+     * does one thing.
+     */
+    private readonly componentPropEmitter;
+    private renderAttributes;
+    private renderComponentProps;
+    private attrValueToJsExpr;
+    private renderTemplateLiteralParts;
+}
+export declare const honoAdapter: HonoAdapter;
+export {};
+//# sourceMappingURL=hono-adapter.d.ts.map

package/dist/adapter/hono-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/hono-adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapter/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * BarefootJS Hono Adapter
+ */
+export { HonoAdapter, honoAdapter } from './hono-adapter';
+export type { HonoAdapterOptions } from './hono-adapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapter/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA"}