@componentonce/dom 0.1.0-beta.0

package/LICENSE

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

@@ -0,0 +1,7 @@
+# @componentonce/dom
+
+Trusted ordinary DOM adapter for ComponentOnce.
+
+A DOM component receives three independent typed channels: persisted props, host-owned context, and per-render payload. Its implementation mounts into a host-owned Element and returns explicit update and destroy lifecycle methods.
+
+Typed mounts do not revalidate values unless explicitly requested. Use mountDomComponentBoundary when loading raw props or payload from storage or transport.

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+import { type ComponentOnceCapability, type ComponentOnceCapabilityCompatibility, type ComponentOnceDefinition, type ComponentOnceManifest, type ComponentOnceValidator } from "@componentonce/core";
+/** Typed values passed to a DOM component instance. */
+export interface ComponentOnceDomRenderInput<TProps, THostContext, TPayload> {
+    readonly props: TProps;
+    readonly context: THostContext;
+    readonly payload: TPayload;
+}
+/** Live DOM instance returned by one component mount. */
+export interface ComponentOnceDomMountHandle<TProps, THostContext, TPayload> {
+    /** Replace the application values shown by this mounted instance. */
+    update(input: ComponentOnceDomRenderInput<TProps, THostContext, TPayload>): void;
+    /** Release listeners/resources and stop owning the target contents. */
+    destroy(): void;
+}
+/** Trusted DOM implementation registered with ComponentOnce. */
+export interface ComponentOnceDomImplementation<TProps, THostContext, TPayload> {
+    /** Mount into one host-owned target and return its explicit lifecycle handle. */
+    mount(target: Element, input: ComponentOnceDomRenderInput<TProps, THostContext, TPayload>): ComponentOnceDomMountHandle<TProps, THostContext, TPayload>;
+}
+/** Core definition specialized to an ordinary DOM implementation. */
+export type ComponentOnceDomDefinition<TProps, THostContext, TPayload> = ComponentOnceDefinition<ComponentOnceDomImplementation<TProps, THostContext, TPayload>, TProps, THostContext, TPayload>;
+/** Input used to define one typed DOM component. */
+export interface DefineDomComponentInput<TProps, THostContext, TPayload> {
+    readonly manifest: ComponentOnceManifest;
+    readonly implementation: ComponentOnceDomImplementation<TProps, THostContext, TPayload>;
+    readonly validateProps?: ComponentOnceValidator<TProps>;
+    readonly validatePayload?: ComponentOnceValidator<TPayload>;
+}
+/** Selects typed values that a host explicitly wants to revalidate before mount. */
+export interface ComponentOnceDomValidationRequest {
+    readonly props?: boolean;
+    readonly payload?: boolean;
+}
+/** Input for mounting an already typed DOM definition. */
+export interface ComponentOnceDomMountInput<TProps, THostContext, TPayload> extends ComponentOnceDomRenderInput<TProps, THostContext, TPayload> {
+    readonly definition: ComponentOnceDomDefinition<TProps, THostContext, TPayload>;
+    readonly target: Element;
+    readonly validation?: boolean | ComponentOnceDomValidationRequest;
+    readonly hostCapabilities?: readonly ComponentOnceCapability[];
+    readonly capabilityCompatibility?: ComponentOnceCapabilityCompatibility;
+}
+/** Unknown values received from an untyped host/storage boundary. */
+export interface ComponentOnceDomBoundaryInput<THostContext> {
+    readonly props: unknown;
+    readonly context: THostContext;
+    readonly payload: unknown;
+}
+/** Raw values plus target/definition needed for one validated mount. */
+export interface ComponentOnceDomBoundaryMountInput<TProps, THostContext, TPayload> extends ComponentOnceDomBoundaryInput<THostContext> {
+    readonly definition: ComponentOnceDomDefinition<TProps, THostContext, TPayload>;
+    readonly target: Element;
+    readonly hostCapabilities?: readonly ComponentOnceCapability[];
+    readonly capabilityCompatibility?: ComponentOnceCapabilityCompatibility;
+}
+/** DOM definition field that may provide a boundary validator. */
+export type ComponentOnceDomValidationField = "props" | "payload";
+/** Thrown when a raw boundary needs a validator that the definition did not provide. */
+export declare class ComponentOnceDomValidatorMissingError extends Error {
+    readonly field: ComponentOnceDomValidationField;
+    readonly manifest: ComponentOnceManifest;
+    constructor(field: ComponentOnceDomValidationField, manifest: ComponentOnceManifest);
+}
+/** Define one trusted typed DOM implementation. */
+export declare function defineDomComponent<TProps, THostContext, TPayload>(input: DefineDomComponentInput<TProps, THostContext, TPayload>): ComponentOnceDomDefinition<TProps, THostContext, TPayload>;
+/** Mount one typed DOM definition after compatibility and optional validation checks. */
+export declare function mountDomComponent<TProps, THostContext, TPayload>(input: ComponentOnceDomMountInput<TProps, THostContext, TPayload>): ComponentOnceDomMountHandle<TProps, THostContext, TPayload>;
+/** Validate unknown persisted props and payload once at a DOM host boundary. */
+export declare function validateDomComponentBoundary<TProps, THostContext, TPayload>(definition: ComponentOnceDomDefinition<TProps, THostContext, TPayload>, input: ComponentOnceDomBoundaryInput<THostContext>): ComponentOnceDomRenderInput<TProps, THostContext, TPayload>;
+/** Validate one raw boundary then mount without a second validation pass. */
+export declare function mountDomComponentBoundary<TProps, THostContext, TPayload>(input: ComponentOnceDomBoundaryMountInput<TProps, THostContext, TPayload>): ComponentOnceDomMountHandle<TProps, THostContext, TPayload>;
+//# 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,EAEL,KAAK,uBAAuB,EAC5B,KAAK,oCAAoC,EACzC,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAE7B,uDAAuD;AACvD,MAAM,WAAW,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;CAC5B;AAED,yDAAyD;AACzD,MAAM,WAAW,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ;IACzE,qEAAqE;IACrE,MAAM,CAAC,KAAK,EAAE,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC;IACjF,uEAAuE;IACvE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,gEAAgE;AAChE,MAAM,WAAW,8BAA8B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ;IAC5E,iFAAiF;IACjF,KAAK,CACH,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,GACjE,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;CAChE;AAED,qEAAqE;AACrE,MAAM,MAAM,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,IACnE,uBAAuB,CACrB,8BAA8B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,EAC9D,MAAM,EACN,YAAY,EACZ,QAAQ,CACT,CAAC;AAEJ,oDAAoD;AACpD,MAAM,WAAW,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ;IACrE,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IACxF,QAAQ,CAAC,aAAa,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;CAC7D;AAED,oFAAoF;AACpF,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,0DAA0D;AAC1D,MAAM,WAAW,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CACxE,SAAQ,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC;IACnE,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAChF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,iCAAiC,CAAC;IAClE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC/D,QAAQ,CAAC,uBAAuB,CAAC,EAAE,oCAAoC,CAAC;CACzE;AAED,qEAAqE;AACrE,MAAM,WAAW,6BAA6B,CAAC,YAAY;IACzD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wEAAwE;AACxE,MAAM,WAAW,kCAAkC,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAChF,SAAQ,6BAA6B,CAAC,YAAY,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAChF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC/D,QAAQ,CAAC,uBAAuB,CAAC,EAAE,oCAAoC,CAAC;CACzE;AAED,kEAAkE;AAClE,MAAM,MAAM,+BAA+B,GAAG,OAAO,GAAG,SAAS,CAAC;AAElE,wFAAwF;AACxF,qBAAa,qCAAsC,SAAQ,KAAK;IAC9D,SAAgB,KAAK,EAAE,+BAA+B,CAAC;IACvD,SAAgB,QAAQ,EAAE,qBAAqB,CAAC;gBAE7B,KAAK,EAAE,+BAA+B,EAAE,QAAQ,EAAE,qBAAqB;CAS3F;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAC/D,KAAK,EAAE,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,GAC7D,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAO5D;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAC9D,KAAK,EAAE,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,GAChE,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAkB7D;AAED,gFAAgF;AAChF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EACzE,UAAU,EAAE,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,EACtE,KAAK,EAAE,6BAA6B,CAAC,YAAY,CAAC,GACjD,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAM7D;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EACtE,KAAK,EAAE,kCAAkC,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,GACxE,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAa7D"}

package/dist/index.js

@@ -0,0 +1,76 @@
+import { assertComponentOnceCompatible, } from "@componentonce/core";
+/** Thrown when a raw boundary needs a validator that the definition did not provide. */
+export class ComponentOnceDomValidatorMissingError extends Error {
+    field;
+    manifest;
+    constructor(field, manifest) {
+        super("Component \"" + manifest.id + "\" version \"" + manifest.version +
+            "\" has no " + field + " validator.");
+        this.name = new.target.name;
+        this.field = field;
+        this.manifest = manifest;
+    }
+}
+/** Define one trusted typed DOM implementation. */
+export function defineDomComponent(input) {
+    return {
+        manifest: input.manifest,
+        implementation: input.implementation,
+        ...(input.validateProps === undefined ? {} : { validateProps: input.validateProps }),
+        ...(input.validatePayload === undefined ? {} : { validatePayload: input.validatePayload }),
+    };
+}
+/** Mount one typed DOM definition after compatibility and optional validation checks. */
+export function mountDomComponent(input) {
+    assertComponentOnceCompatible(input.definition.manifest, input.hostCapabilities ?? [], input.capabilityCompatibility);
+    const validation = normalizeValidation(input.validation);
+    const props = validation.props
+        ? validateField(input.definition, "props", input.props)
+        : input.props;
+    const payload = validation.payload
+        ? validateField(input.definition, "payload", input.payload)
+        : input.payload;
+    return input.definition.implementation.mount(input.target, {
+        props,
+        context: input.context,
+        payload,
+    });
+}
+/** Validate unknown persisted props and payload once at a DOM host boundary. */
+export function validateDomComponentBoundary(definition, input) {
+    return {
+        props: validateField(definition, "props", input.props),
+        context: input.context,
+        payload: validateField(definition, "payload", input.payload),
+    };
+}
+/** Validate one raw boundary then mount without a second validation pass. */
+export function mountDomComponentBoundary(input) {
+    const validated = validateDomComponentBoundary(input.definition, input);
+    return mountDomComponent({
+        definition: input.definition,
+        target: input.target,
+        ...validated,
+        ...(input.hostCapabilities === undefined
+            ? {}
+            : { hostCapabilities: input.hostCapabilities }),
+        ...(input.capabilityCompatibility === undefined
+            ? {}
+            : { capabilityCompatibility: input.capabilityCompatibility }),
+    });
+}
+function normalizeValidation(validation) {
+    if (validation === true)
+        return { props: true, payload: true };
+    if (validation === false || validation === undefined)
+        return { props: false, payload: false };
+    return { props: validation.props ?? false, payload: validation.payload ?? false };
+}
+function validateField(definition, field, value) {
+    const validator = field === "props" ? definition.validateProps : definition.validatePayload;
+    if (validator === undefined) {
+        throw new ComponentOnceDomValidatorMissingError(field, definition.manifest);
+    }
+    return validator(value);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/examples/plain-card.ts

@@ -0,0 +1,25 @@
+import { defineDomComponent } from "@componentonce/dom";
+
+export const plainCard = defineDomComponent<
+  { readonly title: string },
+  { readonly format: (value: string) => string },
+  { readonly count: number }
+>({
+  manifest: {
+    id: "example/plain-card",
+    version: "1.0.0",
+    requirements: [{ name: "browser-dom", version: "1" }],
+  },
+  implementation: {
+    mount(target, input) {
+      const render = (next: typeof input) => {
+        target.textContent = next.context.format(next.props.title) + " (" + next.payload.count + ")";
+      };
+      render(input);
+      return {
+        update(next) { render(next); },
+        destroy() { target.replaceChildren(); },
+      };
+    },
+  },
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@componentonce/dom",
+  "version": "0.1.0-beta.0",
+  "type": "module",
+  "files": [
+    "dist",
+    "examples",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@componentonce/core": "0.1.0-beta.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.5"
+  },
+  "description": "DOM adapter for trusted ComponentOnce components with explicit mount, update, and destroy lifecycle.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "precheck": "pnpm --filter @componentonce/core build",
+    "check": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.test.json",
+    "pretest": "pnpm --filter @componentonce/core build",
+    "test": "vitest run",
+    "prebuild": "pnpm --filter @componentonce/core build",
+    "build": "tsc -p tsconfig.json"
+  }
+}