@ecopages/kitajs 0.2.1-beta.0 → 0.3.0

package/README.md

@@ -15,15 +15,10 @@ bun add @ecopages/kitajs @kitajs/html @kitajs/ts-html-plugin
 Import and register the `kitajsPlugin` in your `eco.config.ts`.
 
 ```ts
-import { ConfigBuilder } from '@ecopages/core/config-builder';
+import { defineConfig } from '@ecopages/core/config';
 import { kitajsPlugin } from '@ecopages/kitajs';
 
-const config = await new ConfigBuilder()
-	.setBaseUrl(import.meta.env.ECOPAGES_BASE_URL)
-	.setIntegrations([kitajsPlugin()])
-	.build();
-
-export default config;
+export default defineConfig({ integrations: [kitajsPlugin()] });
 ```
 
 ## What This Integration Owns
@@ -32,6 +27,8 @@ export default config;
 - Page, layout, and document shells rendered by `@kitajs/html`.
 - HTML-first outer shells that host nested foreign subtrees from other integrations.
 
+The default renderer uses core's `createIntegrationRenderer()` factory. Core owns the common route and document-shell pipeline; add hooks for Kita-specific behavior, and subclass only when the hook API cannot express a needed capability.
+
 ## Mixed Rendering
 
 Kita works well as the outer renderer in mixed apps. When a Kita-owned page encounters a nested foreign child from another integration, Ecopages resolves that foreign subtree with its owning renderer and inserts the resulting HTML back into the Kita shell.
@@ -40,4 +37,5 @@ Important:
 
 - Components that may render foreign children must declare those children in `config.dependencies.components`.
 - Ecopages validates mixed-renderer ownership from declared dependencies during render preparation instead of inferring every foreign child from rendered HTML.
+- Route-level dependency resolvers can supply Components at request time; Kita includes those resolved roots through the shared string renderer when deciding whether a Foreign Subtree needs handoff.
 - Kita remains an HTML-first outer shell. Same-integration Kita children do not go through a separate universal child serialization contract.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/kitajs",
-  "version": "0.2.1-beta.0",
+  "version": "0.3.0",
   "description": "Kitajs plugin for Ecopages",
   "keywords": [
     "ecopages",
@@ -11,6 +11,9 @@
   "main": "./src/kitajs.plugin.js",
   "types": "./src/kitajs.plugin.d.ts",
   "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
     ".": {
       "default": "./src/kitajs.plugin.js",
@@ -27,12 +30,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/ecopages/ecopages.git",
+    "url": "git+https://github.com/ecopages/ecopages.git",
     "directory": "packages/integrations/kitajs"
   },
   "peerDependencies": {
-    "@ecopages/core": "0.2.1-beta.0",
+    "@ecopages/core": "0.3.0",
     "@kitajs/html": "^4.1.0",
     "@kitajs/ts-html-plugin": "^4.0.1"
   }
-}
+}

package/src/eco-embed.js

@@ -1,11 +1,9 @@
-import { eco } from "@ecopages/core";
-function EcoEmbed({
-  component,
-  props,
-  children
-}) {
-  return eco.embed(component, props, children);
+/** @jsxImportSource @kitajs/html */
+import { eco } from '@ecopages/core';
+/**
+ * Renders a foreign or same-integration eco component from a Kita JSX file
+ * without forcing inline mixed-JSX authoring.
+ */
+export function EcoEmbed({ component, props, children, }) {
+    return eco.embed(component, props, children);
 }
-export {
-  EcoEmbed
-};

package/src/kitajs-renderer.d.ts

@@ -2,21 +2,9 @@
  * This module contains the Kita.js renderer
  * @module
  */
-import type { ComponentRenderInput, ComponentRenderResult, EcoComponent, EcoPagesElement, IntegrationRendererRenderOptions, RouteRendererBody } from '@ecopages/core';
-import { IntegrationRenderer, type RenderToResponseContext } from '@ecopages/core/route-renderer/integration-renderer';
 /**
- * A renderer for the Kita.js integration.
- * It renders a page using the HtmlTemplate and Page components.
+ * A renderer for the Kita.js integration, backed by core's shared route pipeline.
  */
-export declare class KitaRenderer extends IntegrationRenderer<EcoPagesElement> {
+export declare const KitaRenderer: new (options: import("@ecopages/core/integration").IntegrationRendererOptions) => import("@ecopages/core/integration").IntegrationRenderer<import("@ecopages/core").EcoPagesElement> & {
     name: string;
-    private isFunctionComponent;
-    /**
-     * Renders a Kita-owned foreign subtree for component-level orchestration.
-     *
-     * Includes component-scoped dependency assets when declared.
-     */
-    renderComponent(input: ComponentRenderInput): Promise<ComponentRenderResult>;
-    render({ params, query, props, locals, pageLocals, metadata, Page, Layout, HtmlTemplate, }: IntegrationRendererRenderOptions): Promise<RouteRendererBody>;
-    renderToResponse<P = Record<string, unknown>>(view: EcoComponent<P>, props: P, ctx: RenderToResponseContext): Promise<Response>;
-}
+};

package/src/kitajs-renderer.js

@@ -1,63 +1,10 @@
-import { IntegrationRenderer } from "@ecopages/core/route-renderer/integration-renderer";
-import { KITAJS_PLUGIN_NAME } from "./kitajs.constants.js";
-class KitaRenderer extends IntegrationRenderer {
-  name = KITAJS_PLUGIN_NAME;
-  isFunctionComponent(component) {
-    return typeof component === "function";
-  }
-  /**
-   * Renders a Kita-owned foreign subtree for component-level orchestration.
-   *
-   * Includes component-scoped dependency assets when declared.
-   */
-  async renderComponent(input) {
-    if (!this.isFunctionComponent(input.component)) {
-      throw new TypeError("Kita renderer expected a callable component.");
-    }
-    return this.renderStringComponentWithQueuedForeignSubtrees(input, input.component);
-  }
-  async render({
-    params,
-    query,
-    props,
-    locals,
-    pageLocals,
-    metadata,
-    Page,
-    Layout,
-    HtmlTemplate
-  }) {
-    try {
-      return await this.renderPageWithDocumentShell({
-        page: {
-          component: Page,
-          props: { params, query, ...props, locals: pageLocals }
-        },
-        layout: Layout ? {
-          component: Layout,
-          props: locals ? { locals } : {}
-        } : void 0,
-        htmlTemplate: HtmlTemplate,
-        metadata,
-        pageProps: props ?? {}
-      });
-    } catch (error) {
-      throw this.createRenderError("Error rendering page", error);
-    }
-  }
-  async renderToResponse(view, props, ctx) {
-    try {
-      return await this.renderViewWithDocumentShell({
-        view,
-        props,
-        ctx,
-        layout: view.config?.layout
-      });
-    } catch (error) {
-      throw this.createRenderError("Error rendering view", error);
-    }
-  }
-}
-export {
-  KitaRenderer
-};
+/**
+ * This module contains the Kita.js renderer
+ * @module
+ */
+import { createIntegrationRenderer } from '@ecopages/core/integration';
+import { KITAJS_PLUGIN_NAME } from './kitajs.constants.js';
+/**
+ * A renderer for the Kita.js integration, backed by core's shared route pipeline.
+ */
+export const KitaRenderer = createIntegrationRenderer(KITAJS_PLUGIN_NAME);

package/src/kitajs.constants.js

@@ -1,4 +1 @@
-const KITAJS_PLUGIN_NAME = "kitajs";
-export {
-  KITAJS_PLUGIN_NAME
-};
+export const KITAJS_PLUGIN_NAME = 'kitajs';

package/src/kitajs.plugin.d.ts

@@ -1,20 +1,8 @@
-import { IntegrationPlugin, type IntegrationPluginConfig } from '@ecopages/core/plugins/integration-plugin';
-import { KitaRenderer } from './kitajs-renderer.js';
+import { type DefinedIntegration } from '@ecopages/core/integration';
 /**
  * The name of the Kita.js plugin
  */
 export declare const PLUGIN_NAME = "kitajs";
-/**
- * The Kita.js plugin class
- * This plugin provides support for Kita.js components in Ecopages
- */
-export declare class KitaHtmlPlugin extends IntegrationPlugin {
-    renderer: typeof KitaRenderer;
-    constructor(options?: Omit<IntegrationPluginConfig, 'name'>);
-}
-/**
- * Factory function to create a Kita.js plugin instance.
- * @param options Configuration options for the Kita.js plugin
- * @returns A new KitaHtmlPlugin instance
- */
-export declare function kitajsPlugin(options?: Omit<IntegrationPluginConfig, 'name'>): KitaHtmlPlugin;
+export declare const kitajsPlugin: DefinedIntegration;
+/** @deprecated Use {@link kitajsPlugin.Plugin} or {@link kitajsPlugin} instead. */
+export declare const KitaHtmlPlugin: new (options?: Omit<import("@ecopages/core/integration").IntegrationPluginConfig, "name">) => import("@ecopages/core/integration").IntegrationPlugin<import("@ecopages/core").EcoPagesElement>;

package/src/kitajs.plugin.js

@@ -1,23 +1,15 @@
-import { IntegrationPlugin } from "@ecopages/core/plugins/integration-plugin";
-import { KitaRenderer } from "./kitajs-renderer.js";
-import { KITAJS_PLUGIN_NAME } from "./kitajs.constants.js";
-const PLUGIN_NAME = KITAJS_PLUGIN_NAME;
-class KitaHtmlPlugin extends IntegrationPlugin {
-  renderer = KitaRenderer;
-  constructor(options) {
-    super({
-      name: PLUGIN_NAME,
-      extensions: [".kita.tsx"],
-      jsxImportSource: "@kitajs/html",
-      ...options
-    });
-  }
-}
-function kitajsPlugin(options) {
-  return new KitaHtmlPlugin(options);
-}
-export {
-  KitaHtmlPlugin,
-  PLUGIN_NAME,
-  kitajsPlugin
-};
+import { defineIntegration } from '@ecopages/core/integration';
+import { KitaRenderer } from './kitajs-renderer.js';
+import { KITAJS_PLUGIN_NAME } from './kitajs.constants.js';
+/**
+ * The name of the Kita.js plugin
+ */
+export const PLUGIN_NAME = KITAJS_PLUGIN_NAME;
+export const kitajsPlugin = defineIntegration({
+    name: PLUGIN_NAME,
+    extensions: ['.kita.tsx'],
+    jsxImportSource: '@kitajs/html',
+    renderer: KitaRenderer,
+});
+/** @deprecated Use {@link kitajsPlugin.Plugin} or {@link kitajsPlugin} instead. */
+export const KitaHtmlPlugin = kitajsPlugin.Plugin;