| 1 | {"version":3,"file":"polyfill-support.js","sources":["src/polyfill-support.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2017 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * lit-html patch to support browsers without native web components.\n *\n * This module should be used in addition to loading the web components\n * polyfills via @webcomponents/webcomponentjs. When using those polyfills\n * support for polyfilled Shadow DOM is automatic via the ShadyDOM polyfill.\n * Scoping classes are added to DOM nodes to facilitate CSS scoping that\n * simulates the style scoping Shadow DOM provides. ShadyDOM does this scoping\n * to all elements added to the DOM. This module provides an important\n * optimization for this process by pre-scoping lit-html template\n * DOM. This means ShadyDOM does not have to scope each instance of the\n * template DOM. Instead, each template is scoped only once.\n *\n * Creating scoped CSS is not covered by this module. It is, however, integrated\n * into the lit-element and @lit/reactive-element packages. See the ShadyCSS docs\n * for how to apply scoping to CSS:\n * https://github.com/webcomponents/polyfills/tree/master/packages/shadycss#usage.\n *\n * @packageDocumentation\n */\n\nexport {};\n\ninterface RenderOptions {\n readonly renderBefore?: ChildNode | null;\n scope?: string;\n}\n\ninterface ShadyTemplateResult {\n strings: TemplateStringsArray;\n // This property needs to remain unminified.\n ['_$litType$']?: string;\n}\n\n// Note, this is a dummy type as the full type here is big.\ninterface Directive {\n __directive?: Directive;\n}\n\ninterface DirectiveParent {\n _$parent?: DirectiveParent;\n __directive?: Directive;\n __directives?: Array<Directive | undefined>;\n}\n\ninterface PatchableChildPartConstructor {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-misused-new\n new (...args: any[]): PatchableChildPart;\n}\n\ninterface PatchableChildPart {\n __directive?: Directive;\n _$committedValue: unknown;\n _$startNode: ChildNode;\n _$endNode: ChildNode | null;\n options: RenderOptions;\n _$setValue(value: unknown, directiveParent: DirectiveParent): void;\n _$getTemplate(result: ShadyTemplateResult): HTMLTemplateElement;\n}\n\ninterface PatchableTemplate {\n el: HTMLTemplateElement;\n}\n\ninterface PatchableTemplateConstructor {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-misused-new\n new (...args: any[]): PatchableTemplate;\n createElement(html: string, options?: RenderOptions): HTMLTemplateElement;\n}\n\ninterface PatchableTemplateInstance {\n _$template: PatchableTemplate;\n}\n\n// Scopes that have had styling prepared. Note, must only be done once per\n// scope.\nconst styledScopes: Set<string> = new Set();\n// Map of css per scope. This is collected during first scope render, used when\n// styling is prepared, and then discarded.\nconst scopeCssStore: Map<string, string[]> = new Map();\n\nconst ENABLE_SHADYDOM_NOPATCH = true;\n\n// Note, explicitly use `var` here so that this can be re-defined when\n// bundled.\n// eslint-disable-next-line no-var\nvar DEV_MODE = true;\n\n/**\n * lit-html patches. These properties cannot be renamed.\n * * ChildPart.prototype._$getTemplate\n * * ChildPart.prototype._$setValue\n */\nconst polyfillSupport: NonNullable<typeof litHtmlPolyfillSupport> = (\n Template: PatchableTemplateConstructor,\n ChildPart: PatchableChildPartConstructor\n) => {\n // polyfill-support is only needed if ShadyCSS or the ApplyShim is in use\n // We test at the point of patching, which makes it safe to load\n // webcomponentsjs and polyfill-support in either order\n if (\n window.ShadyCSS === undefined ||\n (window.ShadyCSS.nativeShadow && !window.ShadyCSS.ApplyShim)\n ) {\n return;\n }\n\n // console.log(\n // '%c Making lit-html compatible with ShadyDOM/CSS.',\n // 'color: lightgreen; font-style: italic'\n // );\n\n const wrap =\n ENABLE_SHADYDOM_NOPATCH &&\n window.ShadyDOM?.inUse &&\n window.ShadyDOM?.noPatch === true\n ? window.ShadyDOM!.wrap\n : (node: Node) => node;\n\n const needsPrepareStyles = (name: string | undefined) =>\n name !== undefined && !styledScopes.has(name);\n\n const cssForScope = (name: string) => {\n let scopeCss = scopeCssStore.get(name);\n if (scopeCss === undefined) {\n scopeCssStore.set(name, (scopeCss = []));\n }\n return scopeCss;\n };\n\n const prepareStyles = (name: string, template: HTMLTemplateElement) => {\n // Get styles\n const scopeCss = cssForScope(name);\n const hasScopeCss = scopeCss.length !== 0;\n if (hasScopeCss) {\n const style = document.createElement('style');\n style.textContent = scopeCss.join('\\n');\n // Note, it's important to add the style to the *end* of the template so\n // it doesn't mess up part indices.\n template.content.appendChild(style);\n }\n // Mark this scope as styled.\n styledScopes.add(name);\n // Remove stored data since it's no longer needed.\n scopeCssStore.delete(name);\n // ShadyCSS removes scopes and removes the style under ShadyDOM and leaves\n // it under native Shadow DOM\n window.ShadyCSS!.prepareTemplateStyles(template, name);\n // Note, under native Shadow DOM, the style is added to the beginning of the\n // template. It must be moved to the *end* of the template so it doesn't\n // mess up part indices.\n if (hasScopeCss && window.ShadyCSS!.nativeShadow) {\n // If there were styles but the CSS text was empty, ShadyCSS will\n // eliminate the style altogether, so the style here could be null\n const style = template.content.querySelector('style');\n if (style !== null) {\n template.content.appendChild(style);\n }\n }\n };\n\n const scopedTemplateCache = new Map<\n string | undefined,\n Map<TemplateStringsArray, PatchableTemplate>\n >();\n\n /**\n * Override to extract style elements from the template\n * and store all style.textContent in the shady scope data.\n * Note, it's ok to patch Template since it's only used via ChildPart.\n */\n const originalCreateElement = Template.createElement;\n Template.createElement = function (html: string, options?: RenderOptions) {\n const element = originalCreateElement.call(Template, html, options);\n const scope = options?.scope;\n if (scope !== undefined) {\n if (!window.ShadyCSS!.nativeShadow) {\n window.ShadyCSS!.prepareTemplateDom(element, scope);\n }\n // Process styles only if this scope is being prepared. Otherwise,\n // leave styles as is for back compat with Lit1.\n if (needsPrepareStyles(scope)) {\n const scopeCss = cssForScope(scope);\n // Remove styles and store textContent.\n const styles = element.content.querySelectorAll(\n 'style'\n ) as NodeListOf<HTMLStyleElement>;\n // Store the css in this template in the scope css and remove the <style>\n // from the template _before_ the node-walk captures part indices\n scopeCss.push(\n ...Array.from(styles).map((style) => {\n style.parentNode?.removeChild(style);\n return style.textContent!;\n })\n );\n }\n }\n return element;\n };\n\n const renderContainer = document.createDocumentFragment();\n const renderContainerMarker = document.createComment('');\n\n const childPartProto = ChildPart.prototype;\n /**\n * Patch to apply gathered css via ShadyCSS. This is done only once per scope.\n */\n const setValue = childPartProto._$setValue;\n childPartProto._$setValue = function (\n this: PatchableChildPart,\n value: unknown,\n directiveParent: DirectiveParent = this\n ) {\n const container = wrap(this._$startNode).parentNode!;\n const scope = this.options?.scope;\n if (container instanceof ShadowRoot && needsPrepareStyles(scope)) {\n // Note, @apply requires outer => inner scope rendering on initial\n // scope renders to apply property values correctly. Style preparation\n // is tied to rendering into `shadowRoot`'s and this is typically done by\n // custom elements. If this is done in `connectedCallback`, as is typical,\n // the code below ensures the right order since content is rendered\n // into a fragment first so the hosting element can prepare styles first.\n // If rendering is done in the constructor, this won't work, but that's\n // not supported in ShadyDOM anyway.\n const startNode = this._$startNode;\n const endNode = this._$endNode;\n\n // Temporarily move this part into the renderContainer.\n renderContainer.appendChild(renderContainerMarker);\n this._$startNode = renderContainerMarker;\n this._$endNode = null;\n\n // Note, any nested template results render here and their styles will\n // be extracted and collected.\n setValue.call(this, value, directiveParent);\n\n // Get the template for this result or create a dummy one if a result\n // is not being rendered.\n // This property needs to remain unminified.\n const template = (value as ShadyTemplateResult)?.['_$litType$']\n ? (this._$committedValue as PatchableTemplateInstance)._$template.el\n : document.createElement('template');\n prepareStyles(scope!, template);\n\n // Note, this is the temporary startNode.\n renderContainer.removeChild(renderContainerMarker);\n // When using native Shadow DOM, include prepared style in shadowRoot.\n if (window.ShadyCSS?.nativeShadow) {\n const style = template.content.querySelector('style');\n if (style !== null) {\n renderContainer.appendChild(style.cloneNode(true));\n }\n }\n container.insertBefore(renderContainer, endNode);\n // Move part back to original container.\n this._$startNode = startNode;\n this._$endNode = endNode;\n } else {\n setValue.call(this, value, directiveParent);\n }\n };\n\n /**\n * Patch ChildPart._$getTemplate to look up templates in a cache bucketed\n * by element name.\n */\n childPartProto._$getTemplate = function (\n this: PatchableChildPart,\n result: ShadyTemplateResult\n ) {\n const scope = this.options?.scope;\n let templateCache = scopedTemplateCache.get(scope);\n if (templateCache === undefined) {\n scopedTemplateCache.set(scope, (templateCache = new Map()));\n }\n let template = templateCache.get(result.strings);\n if (template === undefined) {\n templateCache.set(\n result.strings,\n (template = new Template(result, this.options))\n );\n }\n return template;\n };\n};\n\nif (ENABLE_SHADYDOM_NOPATCH) {\n polyfillSupport.noPatchSupported = ENABLE_SHADYDOM_NOPATCH;\n}\n\nif (DEV_MODE) {\n globalThis.litHtmlPolyfillSupportDevMode ??= polyfillSupport;\n} else {\n globalThis.litHtmlPolyfillSupport ??= polyfillSupport;\n}\n"],"names":["styledScopes","Set","scopeCssStore","Map","globalThis","litHtmlPolyfillSupport","Template","ChildPart","undefined","window","ShadyCSS","nativeShadow","ApplyShim","needsPrepareStyles","name","has","cssForScope","scopeCss","get","set","scopedTemplateCache","originalCreateElement","createElement","html","options","element","call","scope","prepareTemplateDom","styles","content","querySelectorAll","push","Array","from","map","style","parentNode","removeChild","textContent","renderContainer","document","createDocumentFragment","renderContainerMarker","createComment","childPartProto","prototype","setValue","_$setValue","value","directiveParent","container","this","_$startNode","ShadowRoot","startNode","endNode","_$endNode","appendChild","template","_$committedValue","_$template","el","hasScopeCss","length","join","add","delete","prepareTemplateStyles","querySelector","prepareStyles","cloneNode","insertBefore","_$getTemplate","result","templateCache","strings"],"mappings":"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"} |