{
  "id": "@typed/ui#Dom.mergeProps",
  "canonicalId": "@typed/ui/Dom/Props#mergeProps",
  "symbol": {
    "id": "@typed/ui#Dom.mergeProps",
    "packageName": "@typed/ui",
    "moduleName": ".",
    "exportName": "Dom.mergeProps",
    "kind": "function",
    "signatures": [
      "export declare function mergeProps<const User extends object | undefined, const Internal extends object>(user: User, internal: Internal): MergedHostProps<User, Internal>;"
    ],
    "summary": "Merges user host props with component-required internal props.",
    "sections": {
      "Why": "Internal accessibility/state props must remain authoritative, but user\nevents still run first and may cancel component behavior. Disabled hosts\nsuppress user activation handlers. Refs compose instead of overwriting one\nanother.",
      "Ownership and lifetime": "The function allocates only a merged object. Listener and ref effects are\nrun by the eventual template Scope. `composeRefs` rejects two hydration\nowners because one element can restore only one hydration protocol."
    },
    "examples": [
      {
        "language": "ts",
        "code": "import { mergeProps } from \"@typed/ui/Dom/Props\"\nimport { EventHandler } from \"@typed/template\"\nimport { Effect } from \"effect\"\n\nconst props = mergeProps(\n  {\n    class: \"external\",\n    onclick: EventHandler.make(() => Effect.log(\"user activation\"))\n  },\n  { role: \"button\", \"aria-disabled\": false }\n)"
      }
    ],
    "relations": [],
    "source": {
      "file": "packages/ui/src/Dom/Props.ts",
      "line": 152
    },
    "since": "1.0.0",
    "category": "Prop composition"
  },
  "exposure": {
    "recordKind": "declaration",
    "id": "@typed/ui#Dom.mergeProps",
    "packageName": "@typed/ui",
    "packageVersion": "1.0.0-beta.13",
    "moduleName": ".",
    "consumerSpecifier": "@typed/ui",
    "exportName": "Dom",
    "qualifiedName": "Dom.mergeProps",
    "declarationKey": "declaration:e79bb5633c97b3dc52c4c675",
    "family": "function",
    "signatures": [
      "export declare function mergeProps<const User extends object | undefined, const Internal extends object>(user: User, internal: Internal): MergedHostProps<User, Internal>;"
    ],
    "sourceSpans": [
      {
        "file": "packages/ui/src/Dom/Props.ts",
        "start": {
          "line": 152,
          "column": 1
        },
        "end": {
          "line": 179,
          "column": 2
        }
      }
    ],
    "aliases": [
      "@typed/ui/Dom#mergeProps",
      "@typed/ui/Dom/Props#mergeProps",
      "@typed/ui/Dom/index#mergeProps",
      "@typed/ui/index#Dom.mergeProps"
    ],
    "isAlias": true,
    "parentId": "@typed/ui#Dom",
    "static": false,
    "importedFrom": "declaration:e79bb5633c97b3dc52c4c675"
  },
  "declaration": {
    "declarationKey": "declaration:e79bb5633c97b3dc52c4c675",
    "name": "mergeProps",
    "family": "function",
    "facets": [
      {
        "family": "function",
        "syntaxKind": "FunctionDeclaration",
        "signatures": [
          "export declare function mergeProps<const User extends object | undefined, const Internal extends object>(user: User, internal: Internal): MergedHostProps<User, Internal>;"
        ],
        "typeParameters": [
          "const User extends object | undefined",
          "const Internal extends object"
        ],
        "sourceSpans": [
          {
            "file": "packages/ui/src/Dom/Props.ts",
            "start": {
              "line": 152,
              "column": 1
            },
            "end": {
              "line": 179,
              "column": 2
            }
          }
        ],
        "static": false,
        "readonly": false,
        "optional": false
      }
    ],
    "signatures": [
      "export declare function mergeProps<const User extends object | undefined, const Internal extends object>(user: User, internal: Internal): MergedHostProps<User, Internal>;"
    ],
    "typeParameters": [
      "const User extends object | undefined",
      "const Internal extends object"
    ],
    "summary": "Merges user host props with component-required internal props.",
    "sections": {
      "Why": "Internal accessibility/state props must remain authoritative, but user\nevents still run first and may cancel component behavior. Disabled hosts\nsuppress user activation handlers. Refs compose instead of overwriting one\nanother.",
      "Ownership and lifetime": "The function allocates only a merged object. Listener and ref effects are\nrun by the eventual template Scope. `composeRefs` rejects two hydration\nowners because one element can restore only one hydration protocol."
    },
    "examples": [
      {
        "language": "ts",
        "code": "import { mergeProps } from \"@typed/ui/Dom/Props\"\nimport { EventHandler } from \"@typed/template\"\nimport { Effect } from \"effect\"\n\nconst props = mergeProps(\n  {\n    class: \"external\",\n    onclick: EventHandler.make(() => Effect.log(\"user activation\"))\n  },\n  { role: \"button\", \"aria-disabled\": false }\n)"
      }
    ],
    "sourceSpans": [
      {
        "file": "packages/ui/src/Dom/Props.ts",
        "start": {
          "line": 152,
          "column": 1
        },
        "end": {
          "line": 179,
          "column": 2
        }
      }
    ],
    "since": "1.0.0",
    "category": "Prop composition"
  }
}
