@tyndall/webcomponents 0.0.1

package/README.md

@@ -0,0 +1,26 @@
+# @tyndall/webcomponents
+
+## Overview
+Web Components adapter package implementing framework UIAdapter contracts without React dependencies.
+
+## Responsibilities
+- Provide Web Components adapter, factory, and registry
+- Keep renderer behavior deterministic and contract-compliant
+
+## Public API Highlights
+- createWebComponentsAdapter
+- createWebComponentsAdapterRegistry
+
+## Development
+- Build: bun run --filter @tyndall/webcomponents build
+- Test (from workspace root): bun test
+
+## Documentation
+- Package specification: [spec.md](./spec.md)
+- Package architecture: [architecture.md](./architecture.md)
+- Package changes: [CHANGELOG.md](./CHANGELOG.md)
+
+## Maintenance Rules
+- Keep this document aligned with implemented package behavior.
+- Update spec.md and architecture.md whenever package contracts or design boundaries change.
+- Record user-visible package changes in CHANGELOG.md.

package/dist/adapter.d.ts

@@ -0,0 +1,12 @@
+import type { HeadDescriptor, HmrIntegration, UIAdapter, UIAdapterEntryContext, UIAdapterRenderContext, UIAdapterRenderResult } from "@tyndall/core";
+export interface WebComponentsAdapterOptions {
+    name?: string;
+    createClientEntry?: (ctx: UIAdapterEntryContext) => string;
+    createServerEntry?: (ctx: UIAdapterEntryContext) => string;
+    renderToHtml?: (ctx: UIAdapterRenderContext) => Promise<UIAdapterRenderResult> | UIAdapterRenderResult;
+    render?: (ctx: UIAdapterRenderContext) => Promise<unknown> | unknown;
+    getHead?: (ctx: UIAdapterRenderContext) => HeadDescriptor;
+    hmrIntegration?: HmrIntegration;
+}
+export declare const createWebComponentsAdapter: (options?: WebComponentsAdapterOptions) => UIAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,SAAS,EACT,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;IAC3D,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;IAC3D,YAAY,CAAC,EAAE,CACb,GAAG,EAAE,sBAAsB,KACxB,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;IAC5D,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,cAAc,CAAC;IAC1D,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAyED,eAAO,MAAM,0BAA0B,GACrC,UAAS,2BAAgC,KACxC,SAQD,CAAC"}

package/dist/adapter.js

@@ -0,0 +1,69 @@
+import { mergeHeadDescriptors, serializeProps } from "@tyndall/core";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const resolvePageImport = (ctx) => {
+    const options = ctx.uiOptions ?? ctx.adapterOptions;
+    const pageModule = options?.pageModule;
+    const specifier = typeof pageModule === "string" ? pageModule : "./page";
+    return JSON.stringify(specifier);
+};
+const normalizeRenderResult = (value) => {
+    if (typeof value === "string") {
+        return { html: value };
+    }
+    if (isRecord(value) && typeof value.html === "string") {
+        return {
+            html: value.html,
+            head: isRecord(value.head) ? value.head : undefined,
+            status: typeof value.status === "number" ? value.status : undefined,
+            headers: isRecord(value.headers)
+                ? Object.fromEntries(Object.entries(value.headers).map(([key, header]) => [key, String(header)]))
+                : undefined,
+        };
+    }
+    return { html: String(value ?? "") };
+};
+const defaultClientEntry = (ctx) => {
+    const pageImport = resolvePageImport(ctx);
+    return [
+        `import Page from ${pageImport};`,
+        "if (Page && typeof Page.register === \"function\") {",
+        "  Page.register();",
+        "}",
+    ].join("\n");
+};
+const defaultServerEntry = (ctx) => {
+    const pageImport = resolvePageImport(ctx);
+    return [
+        `import Page from ${pageImport};`,
+        "export const renderToHtml = async (ctx) => {",
+        "  if (Page && typeof Page.render === \"function\") {",
+        "    const html = await Page.render(ctx.props ?? {});",
+        "    return { html: typeof html === \"string\" ? html : String(html ?? \"\") };",
+        "  }",
+        "  return { html: `<div data-hyper-webcomponents=\\\"true\\\">${ctx.routeId}</div>` };",
+        "};",
+    ].join("\n");
+};
+const defaultRenderToHtml = async (ctx, options) => {
+    if (!options.render) {
+        return { html: `<div data-hyper-webcomponents=\"true\">${ctx.routeId}</div>` };
+    }
+    const rendered = await options.render(ctx);
+    const normalized = normalizeRenderResult(rendered);
+    const providedHead = options.getHead?.(ctx);
+    // Adapter-level getHead should be able to override route-level defaults.
+    const head = mergeHeadDescriptors(normalized.head ?? {}, providedHead ?? {});
+    return {
+        ...normalized,
+        head,
+    };
+};
+export const createWebComponentsAdapter = (options = {}) => ({
+    name: options.name ?? "webcomponents",
+    createClientEntry: options.createClientEntry ?? defaultClientEntry,
+    createServerEntry: options.createServerEntry ?? defaultServerEntry,
+    renderToHtml: options.renderToHtml ?? ((ctx) => defaultRenderToHtml(ctx, options)),
+    serializeProps,
+    getHead: options.getHead,
+    hmrIntegration: options.hmrIntegration,
+});

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createWebComponentsAdapter } from "./adapter.js";
+export type { WebComponentsAdapterOptions } from "./adapter.js";
+export { createWebComponentsAdapterRegistry, createWebComponentsUiAdapterFactory, } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EACL,kCAAkC,EAClC,mCAAmC,GACpC,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createWebComponentsAdapter } from "./adapter.js";
+export { createWebComponentsAdapterRegistry, createWebComponentsUiAdapterFactory, } from "./registry.js";

package/dist/registry.d.ts

@@ -0,0 +1,4 @@
+import type { UIAdapterFactory, UIAdapterRegistry } from "@tyndall/core";
+export declare const createWebComponentsUiAdapterFactory: () => UIAdapterFactory;
+export declare const createWebComponentsAdapterRegistry: () => UIAdapterRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAWzF,eAAO,MAAM,mCAAmC,QAAO,gBAiBtD,CAAC;AAEF,eAAO,MAAM,kCAAkC,QAAO,iBAEpD,CAAC"}

package/dist/registry.js

@@ -0,0 +1,18 @@
+import { createWebComponentsAdapter } from "./adapter.js";
+const isFunction = (value) => typeof value === "function";
+export const createWebComponentsUiAdapterFactory = () => (options) => {
+    const normalized = options;
+    const routeRender = isFunction(normalized.routeRender)
+        ? normalized.routeRender
+        : undefined;
+    const routeHead = isFunction(normalized.routeHead)
+        ? normalized.routeHead
+        : undefined;
+    return createWebComponentsAdapter({
+        render: routeRender ? ({ props }) => routeRender(props) : undefined,
+        getHead: routeHead ? ({ props }) => routeHead(props) : undefined,
+    });
+};
+export const createWebComponentsAdapterRegistry = () => ({
+    webcomponents: createWebComponentsUiAdapterFactory(),
+});

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@tyndall/webcomponents",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "@tyndall/core": "workspace:*",
+    "@tyndall/shared": "workspace:*"
+  }
+}