@stencil/core 4.39.0 → 4.40.1-dev.1766552834.64f6089

package/internal/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/internal",
-  "version": "4.39.0",
+  "version": "4.40.1-dev.1766552834.64f6089",
   "description": "Stencil internals only to be imported by the Stencil Compiler. Breaking changes can and will happen at any time.",
   "main": "./index.js",
   "types": "./index.d.ts",

package/internal/stencil-private.d.ts

@@ -18,7 +18,7 @@ export interface SourceMap {
     names: string[];
     sourceRoot?: string;
     sources: string[];
-    sourcesContent?: string[];
+    sourcesContent?: (string | null)[];
     version: number;
 }
 export interface PrintLine {
@@ -47,6 +47,11 @@ export interface ImportData {
 export interface SerializeImportData extends ImportData {
     importeePath: string;
     importerPath?: string;
+    /**
+     * True if this is a node module import (e.g. using ~ prefix like ~foo/style.css)
+     * These should be treated as bare module specifiers and not have ./ prepended
+     */
+    isNodeModule?: boolean;
 }
 export interface BuildFeatures {
     style: boolean;
@@ -54,6 +59,7 @@ export interface BuildFeatures {
     formAssociated: boolean;
     shadowDom: boolean;
     shadowDelegatesFocus: boolean;
+    shadowSlotAssignmentManual: boolean;
     scoped: boolean;
     /**
      * Every component has a render function
@@ -470,6 +476,7 @@ export interface ComponentCompilerFeatures {
     hasReflect: boolean;
     hasRenderFn: boolean;
     hasSerializer: boolean;
+    hasSlot: boolean;
     hasState: boolean;
     hasStyle: boolean;
     hasVdomAttribute: boolean;
@@ -554,6 +561,11 @@ export interface ComponentCompilerMeta extends ComponentCompilerFeatures {
     properties: ComponentCompilerProperty[];
     serializers: ComponentCompilerChangeHandler[];
     shadowDelegatesFocus: boolean;
+    /**
+     * Slot assignment mode for shadow DOM. 'manual', enables imperative slotting
+     * using HTMLSlotElement.assign(). Only applicable when encapsulation is 'shadow'.
+     */
+    slotAssignment: 'manual' | null;
     sourceFilePath: string;
     sourceMapPath: string;
     states: ComponentCompilerState[];
@@ -707,6 +719,9 @@ export interface ComponentCompilerMethodComplexType {
 export interface ComponentCompilerChangeHandler {
     propName: string;
     methodName: string;
+    handlerOptions?: {
+        immediate?: boolean;
+    };
 }
 export interface ComponentCompilerMethod extends ComponentCompilerStaticMethod {
     name: string;
@@ -798,7 +813,9 @@ export interface ComponentConstructor {
  * them.
  */
 export interface ComponentConstructorChangeHandlers {
-    [propName: string]: string[];
+    [propName: string]: {
+        [methodName: string]: number;
+    }[];
 }
 export interface ComponentTestingConstructor extends ComponentConstructor {
     COMPILER_META: ComponentCompilerMeta;
@@ -1829,12 +1846,18 @@ export interface CssImportData {
     filePath: string;
     altFilePath?: string;
     styleText?: string | null;
+    modifiers?: string;
 }
 export interface CssToEsmImportData {
     srcImportText: string;
     varName: string;
     url: string;
     filePath: string;
+    /**
+     * True if this is a node module import (e.g. using ~ prefix like ~foo/style.css)
+     * These should be treated as bare module specifiers and not have ./ prepended
+     */
+    isNodeModule?: boolean;
 }
 /**
  * Input CSS to be transformed into ESM

package/internal/stencil-public-compiler.d.ts

@@ -123,9 +123,12 @@ export interface StencilConfig {
      */
     plugins?: any[];
     /**
-     * Generate js source map files for all bundles
+     * Generate js source map files for all bundles.
+     * Set to `true` to always generate source maps, `false` to never generate source maps.
+     * Set to `'dev'` to only generate source maps when the `--dev` flag is passed.
+     * Defaults to `'dev'`.
      */
-    sourceMap?: boolean;
+    sourceMap?: boolean | 'dev';
     /**
      * The srcDir config specifies the directory which should contain the source typescript files
      * for each component. The standard for Stencil apps is to use src, which is the default.
@@ -294,6 +297,30 @@ export interface StencilConfig {
      * is updated, it will not trigger a re-run of tests.
      */
     watchIgnoredRegex?: RegExp | RegExp[];
+    /**
+     * An array of component tag names to exclude from production builds.
+     * Useful to remove test, demo or experimental components from final output.
+     *
+     * **Note:** Exclusion only applies to production builds (default, or when `--prod` is used).
+     * Development builds (with `--dev` flag) will include all components to support local testing.
+     *
+     * Supports glob patterns for matching multiple components:
+     * - `['demo-*']` - Excludes all components starting with "demo-"
+     * - `['*-test', '*-demo']` - Excludes components ending with "-test" or "-demo"
+     * - `['my-component']` - Excludes a specific component
+     *
+     * Components matching these patterns will be completely excluded from all output targets.
+     *
+     * @example
+     * ```ts
+     * export const config: Config = {
+     *   excludeComponents: ['demo-*', 'test-component', '*-internal'],
+     * };
+     * ```
+     *
+     * @default []
+     */
+    excludeComponents?: string[];
     /**
      * Set whether unused dependencies should be excluded from the built output.
      */
@@ -472,7 +499,9 @@ type StrictConfigFields = keyof Pick<Config, 'buildEs5' | 'cacheDir' | 'devMode'
  * about the data from a type-safety perspective, this type is intended to be used throughout the codebase once
  * validations have occurred at runtime.
  */
-export type ValidatedConfig = RequireFields<Config, StrictConfigFields>;
+export type ValidatedConfig = RequireFields<Config, StrictConfigFields> & {
+    sourceMap: boolean;
+};
 export interface HydratedFlag {
     /**
      * Defaults to `hydrated`.
@@ -2143,6 +2172,7 @@ export interface OutputTargetHydrate extends OutputTargetBase {
      */
     external?: string[];
     empty?: boolean;
+    minify?: boolean;
 }
 export interface OutputTargetCustom extends OutputTargetBase {
     type: 'custom';

package/internal/stencil-public-runtime.d.ts

@@ -63,6 +63,12 @@ export interface ShadowRootOptions {
      * focusable part is given focus, and the shadow host is given any available `:focus` styling.
      */
     delegatesFocus?: boolean;
+    /**
+     * Sets the slot assignment mode for the shadow root. When set to `'manual'`, enables imperative
+     * slotting using the `HTMLSlotElement.assign()` method. Defaults to `'named'` for standard
+     * declarative slotting behavior.
+     */
+    slotAssignment?: 'manual' | 'named';
 }
 export interface ModeStyles {
     [modeName: string]: string | string[];
@@ -156,7 +162,9 @@ export interface StateDecorator {
     (): PropertyDecorator;
 }
 export interface WatchDecorator {
-    (propName: any): CustomMethodDecorator<(newValue?: any, oldValue?: any, propName?: any, ...args: any[]) => any | void>;
+    (propName: any, watchOptions?: {
+        immediate?: boolean;
+    }): CustomMethodDecorator<(newValue?: any, oldValue?: any, propName?: any, ...args: any[]) => any | void>;
 }
 export interface PropSerializeDecorator {
     (propName: any): CustomMethodDecorator<(newValue?: any, propName?: string, ...args: any[]) => string | null>;
@@ -695,7 +703,7 @@ declare namespace LocalJSX {
 export { LocalJSX as JSX };
 export declare namespace JSXBase {
     interface IntrinsicElements {
-        slot: JSXBase.SlotAttributes;
+        slot: JSXBase.SlotAttributes<HTMLSlotElement>;
         a: JSXBase.AnchorHTMLAttributes<HTMLAnchorElement>;
         abbr: JSXBase.HTMLAttributes;
         address: JSXBase.HTMLAttributes;
@@ -865,7 +873,7 @@ export declare namespace JSXBase {
         use: JSXBase.SVGAttributes;
         view: JSXBase.SVGAttributes;
     }
-    interface SlotAttributes extends JSXAttributes {
+    interface SlotAttributes<T = HTMLSlotElement> extends JSXAttributes<T> {
         name?: string;
         slot?: string;
         onSlotchange?: (event: Event) => void;
@@ -921,6 +929,9 @@ export declare namespace JSXBase {
         popoverTargetAction?: string;
         popoverTargetElement?: Element | null;
         popoverTarget?: string;
+        command?: string;
+        commandFor?: string;
+        commandfor?: string;
     }
     interface CanvasHTMLAttributes<T> extends HTMLAttributes<T> {
         height?: number | string;