@context-action/lit-ui 0.0.0-stage → 0.1.0

package/dist/hydrate.js

@@ -0,0 +1,127 @@
+import { LitElement } from "lit";
+import "@lit-labs/ssr-client/lit-element-hydrate-support.js";
+import { hydrate } from "@lit-labs/ssr-client";
+// src/hydrate.ts
+const COMMENT_NODE = 8;
+const DOCUMENT_FRAGMENT_NODE = 11;
+function hasLitPartMarker(root) {
+	for (let node = root.firstChild; node; node = node.nextSibling) if (node.nodeType === COMMENT_NODE && node.data.startsWith("lit-part")) return true;
+	return false;
+}
+function findServerHost(root, element) {
+	const tagName = element.localName;
+	if (!tagName) return null;
+	if (root.nodeType === DOCUMENT_FRAGMENT_NODE && "host" in root && root.host === element) return null;
+	if (root.nodeType === 1 && root.localName === tagName) return root;
+	return root.querySelector?.(tagName) ?? null;
+}
+function isHydrationSupportInstalled() {
+	const shadow = {};
+	const probe = { shadowRoot: shadow };
+	const createRenderRoot = LitElement.prototype.createRenderRoot;
+	try {
+		return createRenderRoot.call(probe) === shadow;
+	} catch {
+		return false;
+	}
+}
+function hydrateHost(host) {
+	const shadow = host.shadowRoot;
+	if (!shadow) {
+		host.requestUpdate();
+		return;
+	}
+	const hydrationSupportInstalled = isHydrationSupportInstalled();
+	if (!hydrationSupportInstalled) Object.defineProperty(host, "createRenderRoot", {
+		configurable: true,
+		value: () => shadow
+	});
+	if (shadow._$litPart$ !== void 0) {
+		host.requestUpdate();
+		return;
+	}
+	if (!hasLitPartMarker(shadow)) {
+		shadow.replaceChildren();
+		host.requestUpdate();
+		return;
+	}
+	if (hydrationSupportInstalled) {
+		host.requestUpdate();
+		return;
+	}
+	const rendered = host.render();
+	hydrate(rendered, shadow);
+	host.requestUpdate();
+}
+function upgradeServerHost(host, element) {
+	const tagName = element.localName;
+	const registry = globalThis.customElements;
+	if (!registry) throw new Error("hydrateLit() requires a DOM environment with customElements.");
+	if (!registry.get(tagName)) registry.define(tagName, element.constructor);
+	const existingShadow = host.shadowRoot;
+	if (existingShadow && !isHydrationSupportInstalled()) Object.defineProperty(host, "createRenderRoot", {
+		configurable: true,
+		value: () => existingShadow
+	});
+	const elementConstructor = element.constructor;
+	if (host instanceof elementConstructor) {
+		hydrateHost(host);
+		return;
+	}
+	registry.upgrade(host);
+	if (host instanceof elementConstructor) hydrateHost(host);
+}
+/**
+* Hydrates server-produced markup on the client.
+*
+* Supported modes:
+* 1. `root` is an element's own shadow root (or contains the Lit template
+*    markers produced by `renderLitTemplate`): the element's current template is
+*    hydrated into that root, preserving existing DOM and attaching event parts.
+* 2. `root` contains a server-rendered custom element host for the same tag:
+*    the host is upgraded so its controllers and attributes connect.
+* 3. `root` is empty: the element is mounted and rendered normally.
+*
+* The function never reads a global `document`; it operates only on the supplied
+* root and element.
+*/
+function hydrateLit(root, element) {
+	if (!root || typeof root !== "object") throw new TypeError("hydrateLit() requires an Element or ShadowRoot.");
+	if (!element || typeof element !== "object") throw new TypeError("hydrateLit() requires a LitElement instance.");
+	const serverHost = findServerHost(root, element);
+	if (serverHost && serverHost !== element) {
+		upgradeServerHost(serverHost, element);
+		return;
+	}
+	if (root.nodeType === DOCUMENT_FRAGMENT_NODE && "host" in root && root.host === element) {
+		const shadow = root;
+		if (shadow._$litPart$ === void 0) {
+			Object.defineProperty(element, "createRenderRoot", {
+				configurable: true,
+				value: () => shadow
+			});
+			if (hasLitPartMarker(shadow)) {
+				const rendered = element.render();
+				hydrate(rendered, shadow);
+			} else shadow.replaceChildren();
+		}
+		element._$needsHydration = false;
+		element._$AG = false;
+		element.requestUpdate();
+		return;
+	}
+	if (hasLitPartMarker(root)) {
+		if (root._$litPart$ !== void 0) {
+			element.requestUpdate();
+			return;
+		}
+		const rendered = element.render();
+		hydrate(rendered, root);
+		return;
+	}
+	if (root !== element && !element.isConnected) root.append(element);
+	element.requestUpdate();
+}
+export { hydrateLit };
+
+//# sourceMappingURL=hydrate.js.map

package/dist/hydrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate.js","names":[],"sources":["../src/hydrate.ts"],"sourcesContent":["/**\n * @fileoverview Client-only hydration entry (`@context-action/lit-ui/hydrate`).\n *\n * This module intentionally imports only `@lit-labs/ssr-client` and the Lit\n * runtime, never the server renderer. Client bundles that only need\n * `hydrateLit()` can avoid pulling `@lit-labs/ssr` into the browser graph.\n *\n * @implements view-layer\n * @implements web-component-primitive\n * @memberof core-concepts\n */\n\nimport '@lit-labs/ssr-client/lit-element-hydrate-support.js';\nimport { LitElement } from 'lit';\nimport { hydrate } from '@lit-labs/ssr-client';\n\nconst COMMENT_NODE = 8;\nconst DOCUMENT_FRAGMENT_NODE = 11;\n\nfunction hasLitPartMarker(root: Element | ShadowRoot): boolean {\n  for (let node = root.firstChild; node; node = node.nextSibling) {\n    if (\n      node.nodeType === COMMENT_NODE &&\n      (node as Comment).data.startsWith('lit-part')\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction findServerHost(\n  root: Element | ShadowRoot,\n  element: LitElement,\n): Element | null {\n  const tagName = element.localName;\n  if (!tagName) return null;\n\n  // A ShadowRoot owned by the element is a render target, not a host container.\n  if (\n    root.nodeType === DOCUMENT_FRAGMENT_NODE &&\n    'host' in root &&\n    root.host === element\n  ) {\n    return null;\n  }\n\n  if (root.nodeType === 1 && (root as Element).localName === tagName) {\n    return root as Element;\n  }\n\n  return root.querySelector?.(tagName) ?? null;\n}\n\nfunction isHydrationSupportInstalled(): boolean {\n  const shadow = {};\n  const probe = { shadowRoot: shadow } as unknown as LitElement;\n  const createRenderRoot = (\n    LitElement.prototype as unknown as {\n      createRenderRoot(this: LitElement): unknown;\n    }\n  ).createRenderRoot;\n  try {\n    return createRenderRoot.call(probe) === shadow;\n  } catch {\n    return false;\n  }\n}\n\nfunction hydrateHost(host: LitElement): void {\n  const shadow = host.shadowRoot;\n  if (!shadow) {\n    host.requestUpdate();\n    return;\n  }\n\n  const hydrationSupportInstalled = isHydrationSupportInstalled();\n  if (!hydrationSupportInstalled) {\n    Object.defineProperty(host, 'createRenderRoot', {\n      configurable: true,\n      value: () => shadow,\n    });\n  }\n\n  const livePart = (shadow as ShadowRoot & { _$litPart$?: unknown })._$litPart$;\n  if (livePart !== undefined) {\n    host.requestUpdate();\n    return;\n  }\n\n  if (!hasLitPartMarker(shadow)) {\n    // Server markup without lit-html markers cannot be hydrated. Clear it and\n    // force the first client render into this shadow root without asking Lit's\n    // hydration support to adopt a non-lit tree.\n    shadow.replaceChildren();\n    host.requestUpdate();\n    return;\n  }\n\n  // Lit's official hydration support patches createRenderRoot/update and\n  // adopts the declarative shadow root on the first update. Running hydrate()\n  // ourselves would make support hydrate the same container twice.\n  if (hydrationSupportInstalled) {\n    host.requestUpdate();\n    return;\n  }\n\n  const rendered = (host as unknown as { render(): unknown }).render();\n  hydrate(rendered, shadow);\n  host.requestUpdate();\n}\n\nfunction upgradeServerHost(host: Element, element: LitElement): void {\n  const tagName = element.localName;\n  const registry = globalThis.customElements;\n  if (!registry) {\n    throw new Error('hydrateLit() requires a DOM environment with customElements.');\n  }\n\n  if (!registry.get(tagName)) {\n    registry.define(tagName, element.constructor as CustomElementConstructor);\n  }\n\n  // A declarative shadow root already contains the server template. When Lit's\n  // hydration support is not installed, prevent the first update from calling\n  // attachShadow() on the same host. When support is installed, its patched\n  // createRenderRoot already does this and must remain in control.\n  const existingShadow = host.shadowRoot;\n  if (existingShadow && !isHydrationSupportInstalled()) {\n    Object.defineProperty(host, 'createRenderRoot', {\n      configurable: true,\n      value: () => existingShadow,\n    });\n  }\n\n  const elementConstructor = element.constructor as unknown as { new (): LitElement };\n  if (host instanceof elementConstructor) {\n    hydrateHost(host);\n    return;\n  }\n\n  registry.upgrade(host);\n  if (host instanceof elementConstructor) {\n    hydrateHost(host);\n  }\n}\n\n/**\n * Hydrates server-produced markup on the client.\n *\n * Supported modes:\n * 1. `root` is an element's own shadow root (or contains the Lit template\n *    markers produced by `renderLitTemplate`): the element's current template is\n *    hydrated into that root, preserving existing DOM and attaching event parts.\n * 2. `root` contains a server-rendered custom element host for the same tag:\n *    the host is upgraded so its controllers and attributes connect.\n * 3. `root` is empty: the element is mounted and rendered normally.\n *\n * The function never reads a global `document`; it operates only on the supplied\n * root and element.\n */\nexport function hydrateLit(root: Element | ShadowRoot, element: LitElement): void {\n  if (!root || typeof root !== 'object') {\n    throw new TypeError('hydrateLit() requires an Element or ShadowRoot.');\n  }\n  if (!element || typeof element !== 'object') {\n    throw new TypeError('hydrateLit() requires a LitElement instance.');\n  }\n\n  const serverHost = findServerHost(root, element);\n  if (serverHost && serverHost !== element) {\n    upgradeServerHost(serverHost, element);\n    return;\n  }\n\n  // The element's own shadow root is managed by its Lit update lifecycle.\n  // Hydrate it explicitly and bypass the support flag so the first update does\n  // not adopt the same container a second time.\n  if (\n    root.nodeType === DOCUMENT_FRAGMENT_NODE &&\n    'host' in root &&\n    root.host === element\n  ) {\n    const shadow = root as ShadowRoot;\n    const livePart = (shadow as ShadowRoot & { _$litPart$?: unknown })._$litPart$;\n    if (livePart === undefined) {\n      Object.defineProperty(element, 'createRenderRoot', {\n        configurable: true,\n        value: () => shadow,\n      });\n      if (hasLitPartMarker(shadow)) {\n        const rendered = (element as unknown as { render(): unknown }).render();\n        hydrate(rendered, shadow);\n      } else {\n        shadow.replaceChildren();\n      }\n    }\n    // Support uses `_$needsHydration` in development and a minified field in\n    // production. Clearing both is harmless when support is absent.\n    (element as unknown as { _$needsHydration?: boolean })._$needsHydration = false;\n    (element as unknown as { _$AG?: boolean })._$AG = false;\n    element.requestUpdate();\n    return;\n  }\n\n  if (hasLitPartMarker(root)) {\n    const livePart = (root as ShadowRoot & { _$litPart$?: unknown })._$litPart$;\n    if (livePart !== undefined) {\n      element.requestUpdate();\n      return;\n    }\n    const rendered = (element as unknown as { render(): unknown }).render();\n    hydrate(rendered, root);\n    return;\n  }\n\n  if (root !== element && !element.isConnected) {\n    root.append(element);\n  }\n  element.requestUpdate();\n}\n"],"mappings":"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"}