@public-ui/components 4.1.2-rc.3 → 4.1.2-rc.5

package/dist/kolibri/base-web-component-CjUKwppg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-web-component-CjUKwppg.js","sources":["src/internal/props/loading.ts","src/internal/props/variant-quote.ts","src/internal/functional-components/base-controller.ts","src/internal/functional-components/base-web-component.ts"],"sourcesContent":["import type { SimpleProp } from './helpers/factory';\nimport { createPropDefinition } from './helpers/factory';\nimport { normalizeString } from './helpers/normalizers';\n\n/**\n * Loading prop for lazy-loading behavior of embedded content\n *\n * Description:\n * The loading attribute controls when the browser should start fetching the resource.\n * Lazy loading defers loading of off-screen content until it is near the viewport,\n * improving initial page load performance.\n *\n * Usage (according to W3C HTML specification):\n * - \"lazy\": Defers loading until the element approaches the viewport\n * - \"eager\": Loads the resource immediately regardless of viewport position\n * - Default is \"lazy\" to optimize performance\n *\n * Accessibility:\n * - Lazy loading must not interfere with assistive technology access to content\n * - Content must be available when focused or navigated to via keyboard (WCAG 2.1.1 Keyboard)\n * - Ensure lazy-loaded content does not cause unexpected layout shifts (WCAG 2.3.3 Animation from Interactions)\n *\n * @see https://html.spec.whatwg.org/multipage/urls-and-fetching.html#lazy-loading-attributes\n * @see https://www.w3.org/WAI/WCAG21/Understanding/keyboard.html\n */\nconst LOADING_OPTIONS = ['eager', 'lazy'] as const;\nexport type LoadingType = (typeof LOADING_OPTIONS)[number];\nexport type LoadingProp = SimpleProp<'loading', LoadingType>;\n\nconst LOADING_SET: ReadonlySet<string> = new Set(LOADING_OPTIONS);\n\nexport const loadingProp = createPropDefinition<LoadingProp>(\n\t'loading',\n\t'lazy',\n\t(value: unknown) => normalizeString(value) as LoadingType,\n\t(v) => LOADING_SET.has(v),\n);\n","import type { SimpleProp } from './helpers/factory';\nimport { createPropDefinition } from './helpers/factory';\nimport { normalizeString } from './helpers/normalizers';\n\n/**\n * Variant prop for quotation display style\n *\n * Description:\n * Determines whether the quotation is rendered as a block-level (<blockquote>) or\n * inline (<q>) element. The choice affects both visual layout and semantic HTML structure.\n *\n * Usage (according to W3C HTML specification):\n * - \"block\": Renders as <blockquote> — for extended, standalone quotations from an external source\n * - \"inline\": Renders as <q> — for short inline quotations within flowing text (default)\n * - The browser automatically adds appropriate quotation marks around <q> elements\n * - Both elements support the cite attribute to reference the quotation source\n *\n * Accessibility:\n * - Semantic HTML elements (<blockquote>, <q>) help assistive technologies convey content structure\n * - The quotation structure must be programmatically determinable (WCAG 1.3.1 Info and Relationships)\n * - Block quotes are announced as distinct sections by screen readers\n *\n * @see https://html.spec.whatwg.org/multipage/grouping-content.html#the-blockquote-element\n * @see https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-q-element\n * @see https://www.w3.org/WAI/WCAG21/Understanding/info-and-relationships.html\n */\nconst QUOTE_VARIANT_OPTIONS = ['block', 'inline'] as const;\nexport type QuoteVariantType = (typeof QUOTE_VARIANT_OPTIONS)[number];\nexport type VariantQuoteProp = SimpleProp<'variant', QuoteVariantType>;\n\nconst QUOTE_VARIANT_SET: ReadonlySet<string> = new Set(QUOTE_VARIANT_OPTIONS);\n\nexport const variantQuoteProp = createPropDefinition<VariantQuoteProp>(\n\t'variant',\n\t'inline',\n\t(value: unknown) => normalizeString(value) as QuoteVariantType,\n\t(v) => QUOTE_VARIANT_SET.has(v),\n);\n","import type { ComponentApi, GetStateFn, PropsConfigShape, ResolvedInputProps, ResolvedProps, SetStateFn, StrictFields } from './generic-types';\n\nfunction buildDefaultPropsFromConfig(config: PropsConfigShape): Record<string, unknown> {\n\tconst defaults: Record<string, unknown> = {};\n\tfor (const def of [...(config.required ?? []), ...(config.optional ?? [])]) {\n\t\tdefaults[def.propName] = def.getDefaultValue();\n\t}\n\treturn defaults;\n}\n\nexport abstract class BaseController<Api extends ComponentApi> {\n\tprivate readonly rawProps: Partial<Record<string, unknown>> = {};\n\tprivate readonly renderProps: StrictFields<ResolvedProps<Api>>;\n\n\tpublic constructor(\n\t\tpropsConfig: PropsConfigShape,\n\t\tprotected readonly setState: SetStateFn<Api>,\n\t\tprotected readonly getState: GetStateFn<Api>,\n\t) {\n\t\tthis.renderProps = buildDefaultPropsFromConfig(propsConfig) as StrictFields<ResolvedProps<Api>>;\n\t}\n\n\tprotected setRawProp<K extends keyof ResolvedInputProps<Api>>(key: K, value: ResolvedInputProps<Api>[K] | undefined): void {\n\t\tthis.rawProps[key as string] = value;\n\t}\n\n\tprotected getRawProp<K extends keyof ResolvedInputProps<Api>>(key: K): ResolvedInputProps<Api>[K] | undefined {\n\t\treturn this.rawProps[key as string] as ResolvedInputProps<Api>[K] | undefined;\n\t}\n\n\tprotected setRenderProp<K extends keyof ResolvedProps<Api>>(key: K, value: StrictFields<ResolvedProps<Api>>[K]): void {\n\t\tthis.renderProps[key] = value;\n\t}\n\n\tpublic getRenderProp<K extends keyof ResolvedProps<Api>>(key: K): StrictFields<ResolvedProps<Api>>[K] {\n\t\treturn this.renderProps[key];\n\t}\n}\n","import type { ComponentApi, GetStateFn, InternalOf, SetStateFn } from './generic-types';\n\n/**\n * Base class for web components that provides a type-safe setState method.\n * Subclasses pass `this.setState` to their controller constructors, ensuring\n * that all state writes are validated against Api['States'] at compile time.\n */\nexport abstract class BaseWebComponent<Api extends ComponentApi> {\n\t/**\n\t * Sets a reactive @State field with type safety.\n\t * The key must be a valid state field name defined in Api['States'],\n\t * and the value must match its declared type.\n\t * Each call triggers a Stencil re-render.\n\t */\n\tpublic setState: SetStateFn<Api> = <K extends keyof InternalOf<NonNullable<Api['States']>>>(\n\t\tkey: K,\n\t\tvalue: InternalOf<NonNullable<Api['States']>>[K],\n\t): void => {\n\t\t(this as Record<string, unknown>)[key as string] = value;\n\t};\n\n\t/**\n\t * Reads a reactive @State field with type safety.\n\t * The key must be a valid state field name defined in Api['States'],\n\t * and it returns the current value with the correct type.\n\t */\n\tpublic getState: GetStateFn<Api> = <K extends keyof InternalOf<NonNullable<Api['States']>>>(key: K): InternalOf<NonNullable<Api['States']>>[K] => {\n\t\treturn (this as Record<string, unknown>)[key as string] as InternalOf<NonNullable<Api['States']>>[K];\n\t};\n}\n"],"names":[],"mappings":";;;;;AAyBA,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,CAAU;AAIlD,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC,eAAe,CAAC;AAE1D,MAAM,WAAW,GAAG,oBAAoB,CAC9C,SAAS,EACT,MAAM,EACN,CAAC,KAAc,KAAK,eAAe,CAAC,KAAK,CAAgB,EACzD,CAAC,CAAC,KAAK,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;;ACT1B,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAU;AAI1D,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAC,qBAAqB,CAAC;AAEtE,MAAM,gBAAgB,GAAG,oBAAoB,CACnD,SAAS,EACT,QAAQ,EACR,CAAC,KAAc,KAAK,eAAe,CAAC,KAAK,CAAqB,EAC9D,CAAC,CAAC,KAAK,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;;AClChC,SAAS,2BAA2B,CAAC,MAAwB,EAAA;;IAC5D,MAAM,QAAQ,GAA4B,EAAE;IAC5C,KAAK,MAAM,GAAG,IAAI,CAAC,IAAI,CAAA,EAAA,GAAA,MAAM,CAAC,QAAQ,MAAI,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAA,EAAE,CAAC,EAAE,IAAI,CAAA,EAAA,GAAA,MAAM,CAAC,QAAQ,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,EAAE,CAAC,CAAC,EAAE;QAC3E,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,eAAe,EAAE;;AAE/C,IAAA,OAAO,QAAQ;AAChB;MAEsB,cAAc,CAAA;AAInC,IAAA,WAAA,CACC,WAA6B,EACV,QAAyB,EACzB,QAAyB,EAAA;AADzB,QAAA,IAAQ,CAAA,QAAA,GAAR,QAAQ;AACR,QAAA,IAAQ,CAAA,QAAA,GAAR,QAAQ;AANX,QAAA,IAAQ,CAAA,QAAA,GAAqC,EAAE;AAQ/D,QAAA,IAAI,CAAC,WAAW,GAAG,2BAA2B,CAAC,WAAW,CAAqC;;IAGtF,UAAU,CAA0C,GAAM,EAAE,KAA6C,EAAA;AAClH,QAAA,IAAI,CAAC,QAAQ,CAAC,GAAa,CAAC,GAAG,KAAK;;AAG3B,IAAA,UAAU,CAA0C,GAAM,EAAA;AACnE,QAAA,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAa,CAA2C;;IAGpE,aAAa,CAAqC,GAAM,EAAE,KAA0C,EAAA;AAC7G,QAAA,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK;;AAGvB,IAAA,aAAa,CAAqC,GAAM,EAAA;AAC9D,QAAA,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;;AAE7B;;MC9BqB,gBAAgB,CAAA;AAAtC,IAAA,WAAA,GAAA;QAOQ,IAAA,CAAA,QAAQ,GAAoB,CAClC,GAAM,EACN,KAAgD,KACvC;AACR,YAAA,IAAgC,CAAC,GAAa,CAAC,GAAG,KAAK;AACzD,SAAC;AAOM,QAAA,IAAA,CAAA,QAAQ,GAAoB,CAAyD,GAAM,KAA+C;AAChJ,YAAA,OAAQ,IAAgC,CAAC,GAAa,CAA8C;AACrG,SAAC;;AACD;;;;"}