1 line
11 KiB
Plaintext
1 line
11 KiB
Plaintext
{"version":3,"file":"directive-helpers.js","sources":["../../src/directive-helpers.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2020 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport {\n _$LH,\n Part,\n DirectiveParent,\n CompiledTemplateResult,\n MaybeCompiledTemplateResult,\n UncompiledTemplateResult,\n} from './lit-html.js';\nimport {\n DirectiveResult,\n DirectiveClass,\n PartInfo,\n AttributePartInfo,\n} from './directive.js';\ntype Primitive = null | undefined | boolean | number | string | symbol | bigint;\n\nconst {_ChildPart: ChildPart} = _$LH;\n\ntype ChildPart = InstanceType<typeof ChildPart>;\n\nconst ENABLE_SHADYDOM_NOPATCH = true;\n\nconst wrap =\n ENABLE_SHADYDOM_NOPATCH &&\n window.ShadyDOM?.inUse &&\n window.ShadyDOM?.noPatch === true\n ? window.ShadyDOM!.wrap\n : (node: Node) => node;\n\n/**\n * Tests if a value is a primitive value.\n *\n * See https://tc39.github.io/ecma262/#sec-typeof-operator\n */\nexport const isPrimitive = (value: unknown): value is Primitive =>\n value === null || (typeof value != 'object' && typeof value != 'function');\n\nexport const TemplateResultType = {\n HTML: 1,\n SVG: 2,\n} as const;\n\nexport type TemplateResultType =\n (typeof TemplateResultType)[keyof typeof TemplateResultType];\n\ntype IsTemplateResult = {\n (val: unknown): val is MaybeCompiledTemplateResult;\n <T extends TemplateResultType>(\n val: unknown,\n type: T\n ): val is UncompiledTemplateResult<T>;\n};\n\n/**\n * Tests if a value is a TemplateResult or a CompiledTemplateResult.\n */\nexport const isTemplateResult: IsTemplateResult = (\n value: unknown,\n type?: TemplateResultType\n): value is UncompiledTemplateResult =>\n type === undefined\n ? // This property needs to remain unminified.\n (value as UncompiledTemplateResult)?.['_$litType$'] !== undefined\n : (value as UncompiledTemplateResult)?.['_$litType$'] === type;\n\n/**\n * Tests if a value is a CompiledTemplateResult.\n */\nexport const isCompiledTemplateResult = (\n value: unknown\n): value is CompiledTemplateResult => {\n return (value as CompiledTemplateResult)?.['_$litType$']?.h != null;\n};\n\n/**\n * Tests if a value is a DirectiveResult.\n */\nexport const isDirectiveResult = (value: unknown): value is DirectiveResult =>\n // This property needs to remain unminified.\n (value as DirectiveResult)?.['_$litDirective$'] !== undefined;\n\n/**\n * Retrieves the Directive class for a DirectiveResult\n */\nexport const getDirectiveClass = (value: unknown): DirectiveClass | undefined =>\n // This property needs to remain unminified.\n (value as DirectiveResult)?.['_$litDirective$'];\n\n/**\n * Tests whether a part has only a single-expression with no strings to\n * interpolate between.\n *\n * Only AttributePart and PropertyPart can have multiple expressions.\n * Multi-expression parts have a `strings` property and single-expression\n * parts do not.\n */\nexport const isSingleExpression = (part: PartInfo) =>\n (part as AttributePartInfo).strings === undefined;\n\nconst createMarker = () => document.createComment('');\n\n/**\n * Inserts a ChildPart into the given container ChildPart's DOM, either at the\n * end of the container ChildPart, or before the optional `refPart`.\n *\n * This does not add the part to the containerPart's committed value. That must\n * be done by callers.\n *\n * @param containerPart Part within which to add the new ChildPart\n * @param refPart Part before which to add the new ChildPart; when omitted the\n * part added to the end of the `containerPart`\n * @param part Part to insert, or undefined to create a new part\n */\nexport const insertPart = (\n containerPart: ChildPart,\n refPart?: ChildPart,\n part?: ChildPart\n): ChildPart => {\n const container = wrap(containerPart._$startNode).parentNode!;\n\n const refNode =\n refPart === undefined ? containerPart._$endNode : refPart._$startNode;\n\n if (part === undefined) {\n const startNode = wrap(container).insertBefore(createMarker(), refNode);\n const endNode = wrap(container).insertBefore(createMarker(), refNode);\n part = new ChildPart(\n startNode,\n endNode,\n containerPart,\n containerPart.options\n );\n } else {\n const endNode = wrap(part._$endNode!).nextSibling;\n const oldParent = part._$parent;\n const parentChanged = oldParent !== containerPart;\n if (parentChanged) {\n part._$reparentDisconnectables?.(containerPart);\n // Note that although `_$reparentDisconnectables` updates the part's\n // `_$parent` reference after unlinking from its current parent, that\n // method only exists if Disconnectables are present, so we need to\n // unconditionally set it here\n part._$parent = containerPart;\n // Since the _$isConnected getter is somewhat costly, only\n // read it once we know the subtree has directives that need\n // to be notified\n let newConnectionState;\n if (\n part._$notifyConnectionChanged !== undefined &&\n (newConnectionState = containerPart._$isConnected) !==\n oldParent!._$isConnected\n ) {\n part._$notifyConnectionChanged(newConnectionState);\n }\n }\n if (endNode !== refNode || parentChanged) {\n let start: Node | null = part._$startNode;\n while (start !== endNode) {\n const n: Node | null = wrap(start!).nextSibling;\n wrap(container).insertBefore(start!, refNode);\n start = n;\n }\n }\n }\n\n return part;\n};\n\n/**\n * Sets the value of a Part.\n *\n * Note that this should only be used to set/update the value of user-created\n * parts (i.e. those created using `insertPart`); it should not be used\n * by directives to set the value of the directive's container part. Directives\n * should return a value from `update`/`render` to update their part state.\n *\n * For directives that require setting their part value asynchronously, they\n * should extend `AsyncDirective` and call `this.setValue()`.\n *\n * @param part Part to set\n * @param value Value to set\n * @param index For `AttributePart`s, the index to set\n * @param directiveParent Used internally; should not be set by user\n */\nexport const setChildPartValue = <T extends ChildPart>(\n part: T,\n value: unknown,\n directiveParent: DirectiveParent = part\n): T => {\n part._$setValue(value, directiveParent);\n return part;\n};\n\n// A sentinel value that can never appear as a part value except when set by\n// live(). Used to force a dirty-check to fail and cause a re-render.\nconst RESET_VALUE = {};\n\n/**\n * Sets the committed value of a ChildPart directly without triggering the\n * commit stage of the part.\n *\n * This is useful in cases where a directive needs to update the part such\n * that the next update detects a value change or not. When value is omitted,\n * the next update will be guaranteed to be detected as a change.\n *\n * @param part\n * @param value\n */\nexport const setCommittedValue = (part: Part, value: unknown = RESET_VALUE) =>\n (part._$committedValue = value);\n\n/**\n * Returns the committed value of a ChildPart.\n *\n * The committed value is used for change detection and efficient updates of\n * the part. It can differ from the value set by the template or directive in\n * cases where the template value is transformed before being committed.\n *\n * - `TemplateResult`s are committed as a `TemplateInstance`\n * - Iterables are committed as `Array<ChildPart>`\n * - All other types are committed as the template value or value returned or\n * set by a directive.\n *\n * @param part\n */\nexport const getCommittedValue = (part: ChildPart) => part._$committedValue;\n\n/**\n * Removes a ChildPart from the DOM, including any of its content.\n *\n * @param part The Part to remove\n */\nexport const removePart = (part: ChildPart) => {\n part._$notifyConnectionChanged?.(false, true);\n let start: ChildNode | null = part._$startNode;\n const end: ChildNode | null = wrap(part._$endNode!).nextSibling;\n while (start !== end) {\n const n: ChildNode | null = wrap(start!).nextSibling;\n (wrap(start!) as ChildNode).remove();\n start = n;\n }\n};\n\nexport const clearPart = (part: ChildPart) => {\n part._$clear();\n};\n"],"names":[],"mappings":"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"} |