@qwik-custom-elements/adapter-stencil 1.0.0 → 1.0.3

package/dist/index.qwik.mjs

@@ -1,154 +1,178 @@
-const D = {
+import { existsSync } from "node:fs";
+import path from "node:path";
+const metadata = {
   adapterId: "stencil",
   supportedSourceTypes: [
     "CEM",
     "PACKAGE_NAME"
   ],
-  supportsSsrProbe: !0,
+  supportsSsrProbe: true,
   ssrRuntimeSubpath: "./ssr"
 };
-function q({ source: e, adapterOptions: t }) {
-  const n = h(t?.runtime) ? t.runtime : void 0, r = y(n, "loaderImport", "QCE_STENCIL_RUNTIME_LOADER_OVERRIDE_INVALID", `Stencil ${e.type} projects must provide a non-empty adapterOptions.runtime.loaderImport override when the override is set.`);
-  if (y(n, "hydrateImport", "QCE_STENCIL_RUNTIME_HYDRATE_OVERRIDE_INVALID", `Stencil ${e.type} projects must provide a non-empty adapterOptions.runtime.hydrateImport override when the override is set.`), e.type === "CEM" && r == null)
-    throw g("QCE_STENCIL_RUNTIME_LOADER_REQUIRED", "Stencil CEM projects must provide adapterOptions.runtime.loaderImport.");
+function buildMissingCemHint({ packageRoot }) {
+  const collectionManifestPath = path.join(packageRoot, "dist", "collection", "collection-manifest.json");
+  if (!existsSync(collectionManifestPath)) return null;
+  return " This looks like a Stencil package. To fix this, ask the library author to add the `docs-custom-elements-manifest` output target to their `stencil.config.ts`: `{ type: 'docs-custom-elements-manifest', file: 'custom-elements.json' }`. Alternatively, set source.cemPath to the path of a manually generated CEM file.";
 }
-function V({ projectId: e, runtimeResolution: t, source: n, adapterOptions: r }) {
-  const o = h(r?.runtime) ? r.runtime : void 0, s = y(o, "loaderImport", "QCE_STENCIL_RUNTIME_LOADER_OVERRIDE_INVALID", `Stencil ${n.type} projects must provide a non-empty adapterOptions.runtime.loaderImport override when the override is set.`), a = y(o, "hydrateImport", "QCE_STENCIL_RUNTIME_HYDRATE_OVERRIDE_INVALID", `Stencil ${n.type} projects must provide a non-empty adapterOptions.runtime.hydrateImport override when the override is set.`);
-  if (n.type === "CEM") {
-    if (s == null) throw g("QCE_STENCIL_RUNTIME_LOADER_REQUIRED", "Stencil CEM projects must provide adapterOptions.runtime.loaderImport.");
+function validateProject({ source, adapterOptions }) {
+  const runtime = isRecord(adapterOptions?.runtime) ? adapterOptions.runtime : void 0;
+  const loaderImport = validateOptionalRuntimeOverride(runtime, "loaderImport", "QCE_STENCIL_RUNTIME_LOADER_OVERRIDE_INVALID", `Stencil ${source.type} projects must provide a non-empty adapterOptions.runtime.loaderImport override when the override is set.`);
+  validateOptionalRuntimeOverride(runtime, "hydrateImport", "QCE_STENCIL_RUNTIME_HYDRATE_OVERRIDE_INVALID", `Stencil ${source.type} projects must provide a non-empty adapterOptions.runtime.hydrateImport override when the override is set.`);
+  if (source.type !== "CEM") return;
+  if (loaderImport == null) throw createValidationError("QCE_STENCIL_RUNTIME_LOADER_REQUIRED", "Stencil CEM projects must provide adapterOptions.runtime.loaderImport.");
+}
+function resolveRuntimeImports({ projectId, runtimeResolution, source, adapterOptions }) {
+  const runtime = isRecord(adapterOptions?.runtime) ? adapterOptions.runtime : void 0;
+  const loaderImport = validateOptionalRuntimeOverride(runtime, "loaderImport", "QCE_STENCIL_RUNTIME_LOADER_OVERRIDE_INVALID", `Stencil ${source.type} projects must provide a non-empty adapterOptions.runtime.loaderImport override when the override is set.`);
+  const hydrateImport = validateOptionalRuntimeOverride(runtime, "hydrateImport", "QCE_STENCIL_RUNTIME_HYDRATE_OVERRIDE_INVALID", `Stencil ${source.type} projects must provide a non-empty adapterOptions.runtime.hydrateImport override when the override is set.`);
+  if (source.type === "CEM") {
+    if (loaderImport == null) throw createValidationError("QCE_STENCIL_RUNTIME_LOADER_REQUIRED", "Stencil CEM projects must provide adapterOptions.runtime.loaderImport.");
     return {
-      loaderImport: s,
-      hydrateImport: a
+      loaderImport,
+      hydrateImport
     };
   }
-  const c = j(n.packageName, t), l = x({
-    projectId: e,
-    packageName: n.packageName,
-    packageRoot: c,
-    runtimeResolution: t,
-    specifier: s ?? `${n.packageName}/loader`,
+  const packageRoot = resolvePackageRootForProject(source.packageName, runtimeResolution);
+  const resolvedLoaderImport = resolveRequiredPackageRuntimeImport({
+    projectId,
+    packageName: source.packageName,
+    packageRoot,
+    runtimeResolution,
+    specifier: loaderImport ?? `${source.packageName}/loader`,
     field: "loader"
-  }), p = [], m = M({
-    packageName: n.packageName,
-    packageRoot: c,
-    runtimeResolution: t,
-    specifier: a ?? `${n.packageName}/hydrate`,
+  });
+  const observedErrorCodes = [];
+  const resolvedHydrateImport = resolveOptionalPackageRuntimeImport({
+    packageName: source.packageName,
+    packageRoot,
+    runtimeResolution,
+    specifier: hydrateImport ?? `${source.packageName}/hydrate`,
     field: "hydrate",
-    observedErrorCodes: p
-  }), d = {
-    loaderImport: l
+    observedErrorCodes
+  });
+  const runtimeImports = {
+    loaderImport: resolvedLoaderImport
   };
-  return m != null && (d.hydrateImport = m), p.length === 0 ? d : {
-    runtimeImports: d,
-    observedErrorCodes: p,
-    clientOnlyMode: !0
+  if (resolvedHydrateImport != null) runtimeImports.hydrateImport = resolvedHydrateImport;
+  if (observedErrorCodes.length === 0) return runtimeImports;
+  return {
+    runtimeImports,
+    observedErrorCodes,
+    clientOnlyMode: true
   };
 }
-async function G({ runtimeImports: e } = {}) {
-  if (!S(e?.loaderImport)) return {
-    available: !1
+async function probeSSR({ runtimeImports } = {}) {
+  if (!isNonEmptyString(runtimeImports?.loaderImport)) return {
+    available: false
   };
-  if (!S(e?.hydrateImport)) return {
-    available: !1
+  if (!isNonEmptyString(runtimeImports?.hydrateImport)) return {
+    available: false
   };
   try {
+    const hydrateRuntimeModule = await import(
+      /* @vite-ignore */
+      runtimeImports.hydrateImport
+    );
     return {
-      available: typeof (await import(
-        /* @vite-ignore */
-        e.hydrateImport
-      )).renderToString == "function"
+      available: typeof hydrateRuntimeModule.renderToString === "function"
     };
   } catch {
     return {
-      available: !1
+      available: false
     };
   }
 }
-async function B({ componentDefinitions: e, runtimeImports: t }) {
-  if (!S(t?.hydrateImport)) return e;
-  let n;
+async function augmentComponentDefinitions({ componentDefinitions, runtimeImports }) {
+  if (!isNonEmptyString(runtimeImports?.hydrateImport)) return componentDefinitions;
+  let renderToString;
   try {
-    const o = await import(
+    const mod = await import(
       /* @vite-ignore */
-      t.hydrateImport
+      runtimeImports.hydrateImport
     );
-    typeof o.renderToString == "function" && (n = o.renderToString);
+    if (typeof mod.renderToString === "function") renderToString = mod.renderToString;
   } catch {
   }
-  if (n == null) return e;
-  const r = [];
-  for (const o of e) {
-    const s = await k(n, o.tagName), a = new Set(o.slots.map((l) => l.name)), c = s.filter((l) => !a.has(l)).map((l) => ({
-      name: l
+  if (renderToString == null) return componentDefinitions;
+  const augmented = [];
+  for (const def of componentDefinitions) {
+    const probedNames = await probeComponentNamedSlots(renderToString, def.tagName);
+    const existingNames = new Set(def.slots.map((s) => s.name));
+    const newSlots = probedNames.filter((name) => !existingNames.has(name)).map((name) => ({
+      name
     }));
-    r.push({
-      ...o,
+    augmented.push({
+      ...def,
       slots: [
-        ...o.slots,
-        ...c
+        ...def.slots,
+        ...newSlots
       ]
     });
   }
-  return r;
+  return augmented;
 }
-async function k(e, t) {
+async function probeComponentNamedSlots(renderToString, tagName) {
   try {
-    const n = await e(`<${t}></${t}>`);
-    return _(n.html ?? "");
+    const result = await renderToString(`<${tagName}></${tagName}>`);
+    return extractNamedSlotNames(result.html ?? "");
   } catch {
     return [];
   }
 }
-function _(e) {
-  const t = /<!--s\.(?:\d+\.){4}(.*?)-->/g, n = [];
-  for (const r of e.matchAll(t)) {
-    const o = r[1];
-    o.length > 0 && !n.includes(o) && n.push(o);
+function extractNamedSlotNames(html) {
+  const re = /<!--s\.(?:\d+\.){4}(.*?)-->/g;
+  const names = [];
+  for (const match of html.matchAll(re)) {
+    const name = match[1];
+    if (name.length > 0 && !names.includes(name)) names.push(name);
   }
-  return n;
+  return names;
 }
-function z({ projectId: e, libraryName: t, componentDefinitions: n, runtimeImports: r, ssrAvailable: o }) {
-  const s = typeof r?.loaderImport == "string" && r.loaderImport.trim() !== "" ? r.loaderImport : void 0;
-  if (s == null) return [];
-  const a = typeof r?.hydrateImport == "string" && r.hydrateImport.trim() !== "" ? r.hydrateImport : void 0, c = a != null, l = (n ?? []).map((m) => m.tagName), p = [
+function createGeneratedOutput({ projectId, libraryName, componentDefinitions, runtimeImports, ssrAvailable: _ssrAvailable }) {
+  const loaderImport = typeof runtimeImports?.loaderImport === "string" && runtimeImports.loaderImport.trim() !== "" ? runtimeImports.loaderImport : void 0;
+  if (loaderImport == null) return [];
+  const hydrateImport = typeof runtimeImports?.hydrateImport === "string" && runtimeImports.hydrateImport.trim() !== "" ? runtimeImports.hydrateImport : void 0;
+  const hasHydrateRuntime = hydrateImport != null;
+  const componentTags = (componentDefinitions ?? []).map((componentDefinition) => componentDefinition.tagName);
+  const plannedWrites = [
     {
       relativePath: "index.ts",
-      content: P(e, l)
+      content: renderGeneratedIndex(projectId, componentTags)
     },
     {
       relativePath: "runtime.ts",
-      content: T(e, c)
+      content: renderRuntimeBarrelModule(projectId, hasHydrateRuntime)
     },
     {
       relativePath: "runtime-csr.generated.ts",
-      content: w(e, s, t)
+      content: renderClientRuntimeModule(projectId, loaderImport, libraryName)
     }
   ];
-  a != null && p.push({
+  if (hydrateImport != null) plannedWrites.push({
     relativePath: "runtime-ssr.generated.ts",
-    content: L(e, a, t)
+    content: renderServerRuntimeModule(projectId, hydrateImport, libraryName)
   });
-  for (const m of n ?? []) p.push({
-    relativePath: `${m.tagName}.tsx`,
-    content: O(e, m, c, t)
+  for (const componentDefinition of componentDefinitions ?? []) plannedWrites.push({
+    relativePath: `${componentDefinition.tagName}.tsx`,
+    content: renderStencilComponentWrapper(projectId, componentDefinition, hasHydrateRuntime, libraryName)
   });
-  return p;
+  return plannedWrites;
 }
-function h(e) {
-  return typeof e == "object" && e !== null && !Array.isArray(e);
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function S(e) {
-  return typeof e == "string" && e.trim() !== "";
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.trim() !== "";
 }
-function w(e, t, n) {
-  const r = f(n, "CSR", "GeneratedStencilCSRComponent");
+function renderClientRuntimeModule(projectId, loaderImport, libraryName) {
+  const csrBridgeName = toBridgeComponentName(libraryName, "CSR", "GeneratedStencilCSRComponent");
   return [
-    `// Generated by @qwik-custom-elements/core. Project: ${e ?? "unknown"}.`,
+    `// Generated by @qwik-custom-elements/core. Project: ${projectId ?? "unknown"}.`,
     "// Do not edit this file directly. Use a manual extension layer.",
     "",
     "import { $ } from '@builder.io/qwik';",
     "import { createStencilCSRComponent, createStencilClientSetup } from '@qwik-custom-elements/adapter-stencil/client';",
-    `import { defineCustomElements as runtimeDefineCustomElements } from '${t}';`,
+    `import { defineCustomElements as runtimeDefineCustomElements } from '${loaderImport}';`,
     "",
     "export const defineCustomElements = async (): Promise<void> => {",
     "  await Promise.resolve(runtimeDefineCustomElements());",
@@ -157,40 +181,38 @@ function w(e, t, n) {
     "export const defineCustomElementsQrl = $(defineCustomElements);",
     "export const useStencilClientSetup =",
     "  createStencilClientSetup(defineCustomElementsQrl);",
-    `export const ${r} = createStencilCSRComponent();`,
+    `export const ${csrBridgeName} = createStencilCSRComponent();`,
     ""
-  ].join(`
-`);
+  ].join("\n");
 }
-function P(e, t) {
-  const n = t.map((r) => `export { ${E(r)} } from './${r}';`);
+function renderGeneratedIndex(projectId, componentTags) {
+  const exportLines = componentTags.map((componentTag) => `export { ${toWrapperName(componentTag)} } from './${componentTag}';`);
   return [
-    `// Generated by @qwik-custom-elements/core. Project: ${e ?? "unknown"}.`,
+    `// Generated by @qwik-custom-elements/core. Project: ${projectId ?? "unknown"}.`,
     "// Do not edit this file directly. Use a manual extension layer.",
     "",
-    `export const generatedComponentTags = ${JSON.stringify(t)} as const;`,
-    ...n,
+    `export const generatedComponentTags = ${JSON.stringify(componentTags)} as const;`,
+    ...exportLines,
     ""
-  ].join(`
-`);
+  ].join("\n");
 }
-function T(e, t) {
-  const n = [
+function renderRuntimeBarrelModule(projectId, hasHydrateRuntime) {
+  const exportLines = [
     "export * from './runtime-csr.generated';"
   ];
-  return t && n.push("export * from './runtime-ssr.generated';"), [
-    `// Generated by @qwik-custom-elements/core. Project: ${e ?? "unknown"}.`,
+  if (hasHydrateRuntime) exportLines.push("export * from './runtime-ssr.generated';");
+  return [
+    `// Generated by @qwik-custom-elements/core. Project: ${projectId ?? "unknown"}.`,
     "// Do not edit this file directly. Use a manual extension layer.",
     "",
-    ...n,
+    ...exportLines,
     ""
-  ].join(`
-`);
+  ].join("\n");
 }
-function L(e, t, n) {
-  const r = f(n, "SSR", "GeneratedStencilComponent");
+function renderServerRuntimeModule(projectId, hydrateImport, libraryName) {
+  const ssrBridgeName = toBridgeComponentName(libraryName, "SSR", "GeneratedStencilComponent");
   return [
-    `// Generated by @qwik-custom-elements/core. Project: ${e ?? "unknown"}.`,
+    `// Generated by @qwik-custom-elements/core. Project: ${projectId ?? "unknown"}.`,
     "// Do not edit this file directly. Use a manual extension layer.",
     "",
     "import { $ } from '@builder.io/qwik';",
@@ -199,40 +221,50 @@ function L(e, t, n) {
     "  type StencilRenderToString,",
     "} from '@qwik-custom-elements/adapter-stencil/ssr';",
     "",
-    `const hydrateModuleId = '${t}';`,
+    `const hydrateRuntimeImport = ${JSON.stringify(hydrateImport.split("/"))}.join('/');`,
     "",
     "export const renderToString: StencilRenderToString = async (input, options) => {",
     "  const { renderToString: runtimeRenderToString } = await import(",
-    "    // Variable indirection + @vite-ignore: prevents Vite from bundling the Node.js-only hydrate module into the client bundle.",
-    "    /* @vite-ignore */ hydrateModuleId",
+    "    /* @vite-ignore */",
+    "    hydrateRuntimeImport",
     "  );",
     "  return runtimeRenderToString(input, options);",
     "};",
     "",
     "export const generatedStencilRenderToStringQrl = $(renderToString);",
-    `export const ${r} = createStencilSSRBridgeComponent(`,
+    "",
+    `export const ${ssrBridgeName} = createStencilSSRBridgeComponent(`,
     "  generatedStencilRenderToStringQrl,",
     ");",
     ""
-  ].join(`
-`);
+  ].join("\n");
 }
-function O(e, t, n, r) {
-  const o = E(t.tagName), s = `${o}Props`, a = n ? f(r, "SSR", "GeneratedStencilComponent") : f(r, "CSR", "GeneratedStencilCSRComponent"), c = [
+function renderStencilComponentWrapper(projectId, componentDefinition, ssrAvailable, libraryName) {
+  const wrapperName = toWrapperName(componentDefinition.tagName);
+  const propsTypeName = `${wrapperName}Props`;
+  const generatedStencilComponentName = ssrAvailable ? toBridgeComponentName(libraryName, "SSR", "GeneratedStencilComponent") : toBridgeComponentName(libraryName, "CSR", "GeneratedStencilCSRComponent");
+  const slotLines = [
     "      <Slot />",
-    ...t.slots.map((i) => `      <span q:slot=${JSON.stringify(i.name)} style={{ display: 'contents' }}>
-        <Slot name=${JSON.stringify(i.name)} />
+    ...componentDefinition.slots.map((slot) => `      <span q:slot=${JSON.stringify(slot.name)} style={{ display: 'contents' }}>
+        <Slot name=${JSON.stringify(slot.name)} />
       </span>`)
-  ], l = t.slots.length > 0 ? JSON.stringify(t.slots.map((i) => i.name)) : "undefined", p = t.props.map((i) => {
-    const I = b(i.name) ? i.name : `'${i.name}'`, N = i.required ? "" : "?";
-    return `  ${I}${N}: ${i.type};`;
-  }), m = t.events.map((i) => `  ${u(i.name)}?: QRL<(event: ${i.type}) => void>;`);
-  p.push(...m, "  [key: string]: unknown;");
-  const d = [
+  ];
+  const slotListToken = componentDefinition.slots.length > 0 ? JSON.stringify(componentDefinition.slots.map((slot) => slot.name)) : "undefined";
+  const propLines = componentDefinition.props.map((prop) => {
+    const key = isValidIdentifier(prop.name) ? prop.name : `'${prop.name}'`;
+    const optionalToken = prop.required ? "" : "?";
+    return `  ${key}${optionalToken}: ${prop.type};`;
+  });
+  const eventPropLines = componentDefinition.events.map((event) => {
+    return `  ${toEventPropName(event.name)}?: QRL<(event: ${event.type}) => void>;`;
+  });
+  propLines.push(...eventPropLines, "  [key: string]: unknown;");
+  const importLines = [
     "import { Slot, component$ } from '@builder.io/qwik';"
   ];
-  t.events.length > 0 && d.push("import type { QRL } from '@builder.io/qwik';"), d.push(`import { ${a} } from './runtime';`);
-  const R = [
+  if (componentDefinition.events.length > 0) importLines.push("import type { QRL } from '@builder.io/qwik';");
+  importLines.push(`import { ${generatedStencilComponentName} } from './runtime';`);
+  const splitPropsLines = [
     "  const isEventBindingKey = (key: string) =>",
     "    /^on[A-Z].*\\$$/.test(key) || key.includes(':');",
     "  const eventProps: Record<string, unknown> = {};",
@@ -250,9 +282,10 @@ function O(e, t, n, r) {
     "",
     "    elementProps[key] = value;",
     "  }"
-  ], $ = t.events.length > 0 ? [
+  ];
+  const mappedEventLines = componentDefinition.events.length > 0 ? [
     "",
-    `  const mappedEventPropKeys = new Set(${JSON.stringify(t.events.map((i) => u(i.name)))});`,
+    `  const mappedEventPropKeys = new Set(${JSON.stringify(componentDefinition.events.map((event) => toEventPropName(event.name)))});`,
     "  const passthroughEventProps = Object.fromEntries(",
     "    Object.entries(eventProps).filter(",
     "      ([key]) => !mappedEventPropKeys.has(key),",
@@ -260,105 +293,112 @@ function O(e, t, n, r) {
     "  );",
     "",
     "  const events: Record<string, QRL<(...args: any[]) => void>> = {};",
-    ...t.events.map((i) => `  if (props.${u(i.name)}) { events['${i.name}'] = props.${u(i.name)}; }`),
+    ...componentDefinition.events.map((event) => `  if (props.${toEventPropName(event.name)}) { events['${event.name}'] = props.${toEventPropName(event.name)}; }`),
     "  const mappedEvents = Object.keys(events).length > 0 ? events : undefined;"
   ] : [
     "",
     "  const passthroughEventProps = eventProps;",
     "  const mappedEvents = undefined;"
-  ], C = [
-    ...R,
-    ...$,
+  ];
+  const bodyLines = [
+    ...splitPropsLines,
+    ...mappedEventLines,
     "",
     "  return (",
-    `    <${a}`,
-    `      tagName=${JSON.stringify(t.tagName)}`,
+    `    <${generatedStencilComponentName}`,
+    `      tagName=${JSON.stringify(componentDefinition.tagName)}`,
     "      props={elementProps}",
     "      events={mappedEvents}",
-    `      slots={${l}}`,
+    `      slots={${slotListToken}}`,
     "      {...passthroughEventProps}",
     "    >",
-    ...c,
-    `    </${a}>`,
+    ...slotLines,
+    `    </${generatedStencilComponentName}>`,
     "  );"
   ];
   return [
-    `// Generated by @qwik-custom-elements/core. Project: ${e ?? "unknown"}.`,
+    `// Generated by @qwik-custom-elements/core. Project: ${projectId ?? "unknown"}.`,
     "// Do not edit this file directly. Use a manual extension layer.",
     "",
-    ...d,
+    ...importLines,
     "",
-    `export interface ${s} {`,
-    ...p,
+    `export interface ${propsTypeName} {`,
+    ...propLines,
     "}",
     "",
-    `export const ${o} = component$<${s}>((props) => {`,
-    ...C,
+    `export const ${wrapperName} = component$<${propsTypeName}>((props) => {`,
+    ...bodyLines,
     "});",
     ""
-  ].join(`
-`);
+  ].join("\n");
 }
-function E(e) {
-  return `Qwik${e.split("-").filter((r) => r.length > 0).map((r) => `${r.charAt(0).toUpperCase()}${r.slice(1)}`).join("")}`;
+function toWrapperName(componentTag) {
+  const parts = componentTag.split("-").filter((part) => part.length > 0);
+  const normalizedName = parts.map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`).join("");
+  return `Qwik${normalizedName}`;
 }
-function A(e) {
-  return e.split(/[-_]/).filter((t) => t.length > 0).map((t) => `${t.charAt(0).toUpperCase()}${t.slice(1)}`).join("");
+function toPascalCase(name) {
+  return name.split(/[-_]/).filter((p) => p.length > 0).map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`).join("");
 }
-function f(e, t, n) {
-  return !e || e.trim().length === 0 ? n : `${A(e)}${t}BridgeComponent`;
+function toBridgeComponentName(libraryName, mode, fallback) {
+  if (!libraryName || libraryName.trim().length === 0) return fallback;
+  return `${toPascalCase(libraryName)}${mode}BridgeComponent`;
 }
-function b(e) {
-  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(e);
+function isValidIdentifier(name) {
+  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name);
 }
-function u(e) {
-  return `on${e.split(/[^A-Za-z0-9]+/).filter((n) => n.length > 0).map((n) => `${n.charAt(0).toUpperCase()}${n.slice(1)}`).join("")}$`;
+function toEventPropName(eventName) {
+  const normalizedName = eventName.split(/[^A-Za-z0-9]+/).filter((part) => part.length > 0).map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`).join("");
+  return `on${normalizedName}$`;
 }
-function j(e, t) {
-  return t?.resolveSourcePackageRoot?.(e ?? "");
+function resolvePackageRootForProject(packageName, runtimeResolution) {
+  return runtimeResolution?.resolveSourcePackageRoot?.(packageName ?? "");
 }
-function x(e) {
-  const { projectId: t, packageName: n, packageRoot: r, runtimeResolution: o, specifier: s, field: a } = e;
+function resolveRequiredPackageRuntimeImport(params) {
+  const { projectId, packageName, packageRoot, runtimeResolution, specifier, field } = params;
   try {
-    return o?.resolveImportSpecifier?.(s, r), s;
-  } catch (c) {
-    throw g(v(a), Q(t, `Could not resolve Stencil ${a} runtime import "${s}" for source package "${n}": ${U(c)}`));
+    runtimeResolution?.resolveImportSpecifier?.(specifier, packageRoot);
+    return specifier;
+  } catch (error) {
+    throw createValidationError(getRuntimeResolutionErrorCode(field), createProjectAwareMessage(projectId, `Could not resolve Stencil ${field} runtime import "${specifier}" for source package "${packageName}": ${toErrorMessage(error)}`));
   }
 }
-function M(e) {
-  const { packageRoot: t, runtimeResolution: n, specifier: r, field: o, observedErrorCodes: s } = e;
+function resolveOptionalPackageRuntimeImport(params) {
+  const { packageRoot, runtimeResolution, specifier, field, observedErrorCodes } = params;
   try {
-    return n?.resolveImportSpecifier?.(r, t), r;
+    runtimeResolution?.resolveImportSpecifier?.(specifier, packageRoot);
+    return specifier;
   } catch {
-    s.push(v(o));
-    return;
+    observedErrorCodes.push(getRuntimeResolutionErrorCode(field));
+    return void 0;
   }
 }
-function v(e) {
-  return e === "loader" ? "QCE_STENCIL_RUNTIME_LOADER_RESOLVE_FAILED" : "QCE_STENCIL_RUNTIME_HYDRATE_RESOLVE_FAILED";
+function getRuntimeResolutionErrorCode(field) {
+  return field === "loader" ? "QCE_STENCIL_RUNTIME_LOADER_RESOLVE_FAILED" : "QCE_STENCIL_RUNTIME_HYDRATE_RESOLVE_FAILED";
 }
-function Q(e, t) {
-  return e == null ? t : `Project "${e}": ${t}`;
+function createProjectAwareMessage(projectId, message) {
+  return projectId == null ? message : `Project "${projectId}": ${message}`;
 }
-function U(e) {
-  return e instanceof Error ? e.message : String(e);
+function toErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
 }
-function y(e, t, n, r) {
-  if (e == null || !(t in e)) return;
-  const o = e[t];
-  if (typeof o == "string" && o.trim() !== "") return o;
-  throw g(n, r);
+function validateOptionalRuntimeOverride(runtime, field, code, message) {
+  if (runtime == null || !(field in runtime)) return void 0;
+  const value = runtime[field];
+  if (typeof value === "string" && value.trim() !== "") return value;
+  throw createValidationError(code, message);
 }
-function g(e, t) {
-  return Object.assign(new Error(t), {
-    code: e
+function createValidationError(code, message) {
+  return Object.assign(new Error(message), {
+    code
   });
 }
 export {
-  B as augmentComponentDefinitions,
-  z as createGeneratedOutput,
-  D as metadata,
-  G as probeSSR,
-  V as resolveRuntimeImports,
-  q as validateProject
+  augmentComponentDefinitions,
+  buildMissingCemHint,
+  createGeneratedOutput,
+  metadata,
+  probeSSR,
+  resolveRuntimeImports,
+  validateProject
 };