@stencil/core 5.0.0-beta.2 → 5.0.0-beta.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/app-data/index.d.ts +1 -1
- package/dist/{client-BRu0GtRn.mjs → client-CVXS3JZ-.mjs} +105 -60
- package/dist/compiler/browser.d.ts +110 -79
- package/dist/compiler/browser.js +542 -241
- package/dist/compiler/index.d.mts +110 -2
- package/dist/compiler/index.mjs +3 -3
- package/dist/compiler/utils/index.d.mts +1 -1
- package/dist/{compiler-C8yf59oh.mjs → compiler-CUsOl_Kw.mjs} +4428 -2709
- package/dist/declarations/stencil-public-compiler.d.ts +144 -120
- package/dist/declarations/stencil-public-docs.d.ts +23 -0
- package/dist/declarations/stencil-public-runtime.d.ts +60 -58
- package/dist/{index-BopBfjPu.d.mts → index-B9-Byy8z.d.mts} +142 -118
- package/dist/{index-BXAcVN2j.d.ts → index-BHciXst1.d.ts} +57 -55
- package/dist/{index-DmHmu3y0.d.mts → index-Dz1G9pWZ.d.mts} +2 -2
- package/dist/index.d.mts +3 -0
- package/dist/index.mjs +1 -1
- package/dist/jsx-runtime.mjs +1 -1
- package/dist/{node-75gQKkFz.mjs → node-Bz2SOK7_.mjs} +6 -35
- package/dist/runtime/client/lazy.js +228 -180
- package/dist/runtime/client/runtime.d.ts +67 -66
- package/dist/runtime/client/runtime.js +228 -180
- package/dist/runtime/index.d.ts +4 -5
- package/dist/runtime/index.js +226 -178
- package/dist/runtime/server/index.d.mts +11 -11
- package/dist/runtime/server/index.mjs +287 -220
- package/dist/runtime/server/runner.d.mts +4 -4
- package/dist/runtime/server/runner.mjs +82 -54
- package/dist/signals/index.d.ts +11 -2
- package/dist/signals/index.js +11 -1
- package/dist/sys/node/index.d.mts +1 -1
- package/dist/sys/node/index.mjs +1 -1
- package/dist/sys/node/worker.mjs +2 -2
- package/dist/testing/index.d.mts +129 -112
- package/dist/testing/index.mjs +244 -193
- package/package.json +8 -4
|
@@ -1111,6 +1111,11 @@ interface JsonDocsComponent {
|
|
|
1111
1111
|
* A deprecation reason/description found following a `@deprecated` tag
|
|
1112
1112
|
*/
|
|
1113
1113
|
deprecation?: string;
|
|
1114
|
+
/**
|
|
1115
|
+
* `true` if this is a "CSS-only component"
|
|
1116
|
+
* discovered in .css file via `@component`-marked JSDoc block
|
|
1117
|
+
*/
|
|
1118
|
+
cssOnly?: boolean;
|
|
1114
1119
|
}
|
|
1115
1120
|
interface JsonDocsDependencyGraph {
|
|
1116
1121
|
[tagName: string]: string[];
|
|
@@ -1270,6 +1275,16 @@ interface JsonDocsStyle {
|
|
|
1270
1275
|
* The annotation used in the JSDoc of the style (e.g. `@prop`)
|
|
1271
1276
|
*/
|
|
1272
1277
|
annotation: string;
|
|
1278
|
+
/**
|
|
1279
|
+
* The CSS `syntax` descriptor for a custom property, if it was registered via a native
|
|
1280
|
+
* `@property` at-rule (e.g. `"<length>"`).
|
|
1281
|
+
*/
|
|
1282
|
+
syntax?: string;
|
|
1283
|
+
/**
|
|
1284
|
+
* The `initial-value` descriptor for a custom property, if it was registered via a native
|
|
1285
|
+
* `@property` at-rule.
|
|
1286
|
+
*/
|
|
1287
|
+
default?: string;
|
|
1273
1288
|
/**
|
|
1274
1289
|
* The mode associated with the style
|
|
1275
1290
|
*/
|
|
@@ -1356,6 +1371,14 @@ interface StyleDoc {
|
|
|
1356
1371
|
* The Stencil style-mode that is associated with this property.
|
|
1357
1372
|
*/
|
|
1358
1373
|
mode: string | undefined;
|
|
1374
|
+
/**
|
|
1375
|
+
* The CSS `syntax` descriptor, if this property was registered via a native `@property` at-rule.
|
|
1376
|
+
*/
|
|
1377
|
+
syntax?: string;
|
|
1378
|
+
/**
|
|
1379
|
+
* The `initial-value` descriptor, if this property was registered via a native `@property` at-rule.
|
|
1380
|
+
*/
|
|
1381
|
+
default?: string;
|
|
1359
1382
|
}
|
|
1360
1383
|
//#endregion
|
|
1361
1384
|
//#region src/declarations/stencil-public-runtime.d.ts
|
|
@@ -1412,7 +1435,7 @@ interface ComponentOptions {
|
|
|
1412
1435
|
/**
|
|
1413
1436
|
* Relative URL to an external stylesheet providing document-level styles for this component.
|
|
1414
1437
|
* Unlike `styleUrl`, these styles are not scoped to shadow/scoped DOM - they are collected
|
|
1415
|
-
* at build time and injected wherever `@import "stencil-globals"` appears in a global stylesheet.
|
|
1438
|
+
* at build time and injected wherever `@import "stencil-component-globals"` appears in a global stylesheet.
|
|
1416
1439
|
*
|
|
1417
1440
|
* Useful for
|
|
1418
1441
|
* - pre-first-js-render styles (combatting cumulative layout shift)
|
|
@@ -1427,7 +1450,7 @@ interface ComponentOptions {
|
|
|
1427
1450
|
globalStyleUrl?: string;
|
|
1428
1451
|
/**
|
|
1429
1452
|
* Inline CSS string providing document-level styles for this component.
|
|
1430
|
-
* Collected at build time and injected wherever `@import "stencil-globals"` appears.
|
|
1453
|
+
* Collected at build time and injected wherever `@import "stencil-component-globals"` appears.
|
|
1431
1454
|
* @see globalStyleUrl
|
|
1432
1455
|
*/
|
|
1433
1456
|
globalStyle?: string;
|
|
@@ -1787,6 +1810,15 @@ interface StencilConfig {
|
|
|
1787
1810
|
* @default false
|
|
1788
1811
|
*/
|
|
1789
1812
|
generateExportMaps?: boolean;
|
|
1813
|
+
/**
|
|
1814
|
+
* Set to `false` to disable discovery of "CSS-only components" - pure-CSS custom-element
|
|
1815
|
+
* definitions marked with a `@component` JSDoc tag in `.css` files under `srcDir`. No JS
|
|
1816
|
+
* class, never registered via `customElements.define()` - just a documented,
|
|
1817
|
+
* type-checked tag name and its CSS custom properties/attribute variants.
|
|
1818
|
+
*
|
|
1819
|
+
* Defaults to `true`.
|
|
1820
|
+
*/
|
|
1821
|
+
enableCssOnlyComponents?: boolean;
|
|
1790
1822
|
/**
|
|
1791
1823
|
* The namespace config is a string representing a namespace for the app.
|
|
1792
1824
|
* For apps that are not meant to be a library of reusable components,
|
|
@@ -1829,7 +1861,7 @@ interface StencilConfig {
|
|
|
1829
1861
|
*/
|
|
1830
1862
|
transformAliasedImportPaths?: boolean;
|
|
1831
1863
|
/**
|
|
1832
|
-
* Passes custom configuration
|
|
1864
|
+
* Passes custom configuration to Rolldown's module resolution (its `resolve` option), e.g. `alias`.
|
|
1833
1865
|
* For further information: https://stenciljs.com/docs/module-bundling
|
|
1834
1866
|
*/
|
|
1835
1867
|
nodeResolve?: NodeResolveConfig;
|
|
@@ -2633,7 +2665,7 @@ interface SerializeDocumentOptions extends SsrDocumentOptions {
|
|
|
2633
2665
|
* Note that this is "approximate", in that HTML may often not be able
|
|
2634
2666
|
* to be split at an exact line width. Additionally, new lines created
|
|
2635
2667
|
* is where HTML naturally already has whitespace, such as before an
|
|
2636
|
-
* attribute or spaces between words. Defaults to `100
|
|
2668
|
+
* attribute or spaces between words. Defaults to no wrapping (`100` when prerendering).
|
|
2637
2669
|
*/
|
|
2638
2670
|
approximateLineWidth?: number;
|
|
2639
2671
|
/**
|
|
@@ -2651,12 +2683,12 @@ interface SerializeDocumentOptions extends SsrDocumentOptions {
|
|
|
2651
2683
|
prettyHtml?: boolean;
|
|
2652
2684
|
/**
|
|
2653
2685
|
* Remove quotes from attribute values when possible.
|
|
2654
|
-
* Defaults to `true
|
|
2686
|
+
* Defaults to `false` (`true` when prerendering).
|
|
2655
2687
|
*/
|
|
2656
2688
|
removeAttributeQuotes?: boolean;
|
|
2657
2689
|
/**
|
|
2658
2690
|
* Remove the `=""` from standardized `boolean` attributes,
|
|
2659
|
-
* such as `hidden` or `checked`. Defaults to `true
|
|
2691
|
+
* such as `hidden` or `checked`. Defaults to `false` (`true` when prerendering).
|
|
2660
2692
|
*/
|
|
2661
2693
|
removeBooleanAttributeQuotes?: boolean;
|
|
2662
2694
|
/**
|
|
@@ -2665,7 +2697,7 @@ interface SerializeDocumentOptions extends SsrDocumentOptions {
|
|
|
2665
2697
|
*/
|
|
2666
2698
|
removeEmptyAttributes?: boolean;
|
|
2667
2699
|
/**
|
|
2668
|
-
* Remove HTML comments. Defaults to `true
|
|
2700
|
+
* Remove HTML comments. Defaults to `false` (`true` when prerendering).
|
|
2669
2701
|
*/
|
|
2670
2702
|
removeHtmlComments?: boolean;
|
|
2671
2703
|
/**
|
|
@@ -2764,7 +2796,7 @@ interface CompilerSystem {
|
|
|
2764
2796
|
name: 'node' | 'in-memory';
|
|
2765
2797
|
version: string;
|
|
2766
2798
|
events?: BuildEvents;
|
|
2767
|
-
details
|
|
2799
|
+
details: SystemDetails;
|
|
2768
2800
|
/**
|
|
2769
2801
|
* Add a callback which will be ran when destroy() is called.
|
|
2770
2802
|
*/
|
|
@@ -2777,14 +2809,15 @@ interface CompilerSystem {
|
|
|
2777
2809
|
* SYNC! Always returns a boolean, does not throw.
|
|
2778
2810
|
*/
|
|
2779
2811
|
accessSync(p: string): boolean;
|
|
2780
|
-
applyGlobalPatch?(fromDir: string): Promise<void>;
|
|
2781
2812
|
applyPrerenderGlobalPatch?(opts: {
|
|
2782
2813
|
devServerHostUrl: string;
|
|
2783
2814
|
window: any;
|
|
2784
2815
|
}): void;
|
|
2785
|
-
|
|
2786
|
-
|
|
2787
|
-
|
|
2816
|
+
/**
|
|
2817
|
+
* Check npm for a newer Stencil version. Resolves a function that logs the result.
|
|
2818
|
+
*/
|
|
2819
|
+
checkVersion(logger: Logger, currentVersion: string): Promise<() => void>;
|
|
2820
|
+
copy(copyTasks: Required<CopyTask>[], srcDir: string): Promise<CopyResults>;
|
|
2788
2821
|
/**
|
|
2789
2822
|
* Always returns a boolean if the files were copied or not. Does not throw.
|
|
2790
2823
|
*/
|
|
@@ -2809,7 +2842,7 @@ interface CompilerSystem {
|
|
|
2809
2842
|
/**
|
|
2810
2843
|
* Each platform has a different way to dynamically import modules.
|
|
2811
2844
|
*/
|
|
2812
|
-
dynamicImport
|
|
2845
|
+
dynamicImport(p: string): Promise<any>;
|
|
2813
2846
|
/**
|
|
2814
2847
|
* Creates the worker controller for the current system.
|
|
2815
2848
|
*
|
|
@@ -2823,20 +2856,14 @@ interface CompilerSystem {
|
|
|
2823
2856
|
* process.exit()
|
|
2824
2857
|
*/
|
|
2825
2858
|
exit(exitCode: number): Promise<void>;
|
|
2826
|
-
/**
|
|
2827
|
-
* Optionally provide a fetch() function rather than using the built-in fetch().
|
|
2828
|
-
* First arg is a url string or Request object (RequestInfo).
|
|
2829
|
-
* Second arg is the RequestInit. Returns the Response object
|
|
2830
|
-
*/
|
|
2831
|
-
fetch?(input: string | any, init?: any): Promise<any>;
|
|
2832
2859
|
/**
|
|
2833
2860
|
* Generates a sha1 digest encoded as HEX
|
|
2834
2861
|
*/
|
|
2835
|
-
generateContentHash
|
|
2862
|
+
generateContentHash(content: string | any, length?: number): Promise<string>;
|
|
2836
2863
|
/**
|
|
2837
2864
|
* Generates a sha1 digest encoded as HEX from a file path
|
|
2838
2865
|
*/
|
|
2839
|
-
generateFileHash
|
|
2866
|
+
generateFileHash(filePath: string | any, length?: number): Promise<string>;
|
|
2840
2867
|
/**
|
|
2841
2868
|
* Get the current directory.
|
|
2842
2869
|
*/
|
|
@@ -2845,7 +2872,6 @@ interface CompilerSystem {
|
|
|
2845
2872
|
* The compiler's executing path.
|
|
2846
2873
|
*/
|
|
2847
2874
|
getCompilerExecutingPath(): string;
|
|
2848
|
-
getEnvironmentVar?(key: string): string;
|
|
2849
2875
|
/**
|
|
2850
2876
|
* Gets the absolute file path when for a dependency module.
|
|
2851
2877
|
*/
|
|
@@ -2884,11 +2910,7 @@ interface CompilerSystem {
|
|
|
2884
2910
|
* Normalize file system path.
|
|
2885
2911
|
*/
|
|
2886
2912
|
normalizePath(p: string): string;
|
|
2887
|
-
onProcessInterrupt
|
|
2888
|
-
parseYarnLockFile?: (content: string) => {
|
|
2889
|
-
type: 'success' | 'merge' | 'conflict';
|
|
2890
|
-
object: any;
|
|
2891
|
-
};
|
|
2913
|
+
onProcessInterrupt(cb: () => void): void;
|
|
2892
2914
|
platformPath: PlatformPath;
|
|
2893
2915
|
/**
|
|
2894
2916
|
* All return paths are full normalized paths, not just the basenames. Always returns an array, does not throw.
|
|
@@ -2924,6 +2946,9 @@ interface CompilerSystem {
|
|
|
2924
2946
|
* Rename old path to new path. Does not throw.
|
|
2925
2947
|
*/
|
|
2926
2948
|
rename(oldPath: string, newPath: string): Promise<CompilerSystemRenameResults>;
|
|
2949
|
+
/**
|
|
2950
|
+
* Assigned by the compiler. Used by plugins (e.g. `@stencil/sass`) to resolve `~` imports.
|
|
2951
|
+
*/
|
|
2927
2952
|
resolveModuleId?(opts: ResolveModuleIdOptions): Promise<ResolveModuleIdResults>;
|
|
2928
2953
|
resolvePath(p: string): string;
|
|
2929
2954
|
/**
|
|
@@ -3117,6 +3142,7 @@ interface CompilerBuildResults {
|
|
|
3117
3142
|
buildId: number;
|
|
3118
3143
|
componentGraph?: BuildResultsComponentGraph;
|
|
3119
3144
|
components: ComponentCompilerMeta[];
|
|
3145
|
+
cssOnlyComponents: ComponentCompilerMeta[];
|
|
3120
3146
|
diagnostics: Diagnostic$1[];
|
|
3121
3147
|
dirsAdded: string[];
|
|
3122
3148
|
dirsDeleted: string[];
|
|
@@ -3133,6 +3159,15 @@ interface CompilerBuildResults {
|
|
|
3133
3159
|
namespace: string;
|
|
3134
3160
|
fsNamespace: string;
|
|
3135
3161
|
outputs: BuildOutput[];
|
|
3162
|
+
/**
|
|
3163
|
+
* Absolute paths to every global stylesheet, in cascade order: each `global-style` output
|
|
3164
|
+
* target's compiled CSS in the order those targets are declared in `config.outputTargets` - or,
|
|
3165
|
+
* with none configured, the generated `{fsNamespace}.css` holding Stencil's auto-placed CSS (when
|
|
3166
|
+
* emitted). Unlike `outputs`, which groups files by type and sorts them alphabetically, this
|
|
3167
|
+
* preserves author-intended order for consumers like the dev-server's auto-generated component
|
|
3168
|
+
* preview.
|
|
3169
|
+
*/
|
|
3170
|
+
globalStyleFiles: string[];
|
|
3136
3171
|
rootDir: string;
|
|
3137
3172
|
srcDir: string;
|
|
3138
3173
|
timestamp: string;
|
|
@@ -3148,6 +3183,7 @@ interface HotModuleReplacement {
|
|
|
3148
3183
|
componentsUpdated?: string[];
|
|
3149
3184
|
excludeHmr?: string[];
|
|
3150
3185
|
externalStylesUpdated?: string[];
|
|
3186
|
+
globalStylesUpdated?: HmrGlobalStyleUpdate[];
|
|
3151
3187
|
imagesUpdated?: string[];
|
|
3152
3188
|
indexHtmlUpdated?: boolean;
|
|
3153
3189
|
inlineStylesUpdated?: HmrStyleUpdate[];
|
|
@@ -3162,6 +3198,15 @@ interface HmrStyleUpdate {
|
|
|
3162
3198
|
styleTag: string;
|
|
3163
3199
|
styleText: string;
|
|
3164
3200
|
}
|
|
3201
|
+
/**
|
|
3202
|
+
* A live-reload update for a `global-style` output target's CSS. Applied on
|
|
3203
|
+
* the client by matching `fileName` against the `<link>` that loads it and
|
|
3204
|
+
* inserting/updating an adjacent `<style>` override
|
|
3205
|
+
*/
|
|
3206
|
+
interface HmrGlobalStyleUpdate {
|
|
3207
|
+
fileName: string;
|
|
3208
|
+
styleText: string;
|
|
3209
|
+
}
|
|
3165
3210
|
type BuildOnEventRemove = () => boolean;
|
|
3166
3211
|
interface BuildEvents extends BuildOnEvents, BuildEmitEvents {
|
|
3167
3212
|
unsubscribeAll(): void;
|
|
@@ -3554,7 +3599,7 @@ interface OutputTargetCollection extends OutputTargetBaseNext {
|
|
|
3554
3599
|
* When `true` this flag will transform aliased import paths defined in
|
|
3555
3600
|
* a project's `tsconfig.json` to relative import paths in the compiled output.
|
|
3556
3601
|
*
|
|
3557
|
-
* Paths will be left in aliased format if `false
|
|
3602
|
+
* Paths will be left in aliased format if `false`. Defaults to `true`.
|
|
3558
3603
|
*
|
|
3559
3604
|
* @example
|
|
3560
3605
|
* // tsconfig.json
|
|
@@ -3656,11 +3701,11 @@ interface OutputTargetGlobalStyle extends OutputTargetBaseNext {
|
|
|
3656
3701
|
* Controls whether this global stylesheet is injected into component shadow DOMs
|
|
3657
3702
|
* as a constructable stylesheet at runtime.
|
|
3658
3703
|
*
|
|
3659
|
-
* - `'none'
|
|
3704
|
+
* - `'none'`: Don't inject - stylesheet must be loaded externally (e.g., via `<link>`)
|
|
3660
3705
|
* - `'client'`: Inject only in client builds, not SSR (reduces SSR output size)
|
|
3661
3706
|
* - `'all'`: Inject in both client and SSR builds
|
|
3662
3707
|
*
|
|
3663
|
-
* @default 'none'
|
|
3708
|
+
* @default 'client' when the stylesheet comes from `globalStyle` (or an auto-detected `src/global.*`), 'none' when `input` is set
|
|
3664
3709
|
*/
|
|
3665
3710
|
inject?: 'none' | 'client' | 'all';
|
|
3666
3711
|
}
|
|
@@ -3718,6 +3763,10 @@ interface OutputTargetSsr extends OutputTargetBase {
|
|
|
3718
3763
|
*/
|
|
3719
3764
|
cjs?: boolean;
|
|
3720
3765
|
}
|
|
3766
|
+
/**
|
|
3767
|
+
* Compiles the SSR hydrate app to a WASM plugin (via `extism-js`/QuickJS-ng) that can run
|
|
3768
|
+
* outside of Node
|
|
3769
|
+
*/
|
|
3721
3770
|
interface OutputTargetSsrWasm extends OutputTargetBase {
|
|
3722
3771
|
type: 'ssr-wasm';
|
|
3723
3772
|
/** Output directory. @default 'dist/ssr-wasm' */
|
|
@@ -3855,7 +3904,7 @@ interface OutputTargetDocsAgentSkill extends OutputTargetBase {
|
|
|
3855
3904
|
/**
|
|
3856
3905
|
* The skill's name, used in the `SKILL.md` frontmatter.
|
|
3857
3906
|
*
|
|
3858
|
-
* Defaults to
|
|
3907
|
+
* Defaults to {@link Config.namespace}, lowercased, with anything other than letters and numbers replaced by `-`.
|
|
3859
3908
|
*/
|
|
3860
3909
|
name?: string;
|
|
3861
3910
|
/**
|
|
@@ -3918,10 +3967,8 @@ interface OutputTargetStandalone extends OutputTargetBaseNext {
|
|
|
3918
3967
|
type: 'standalone';
|
|
3919
3968
|
empty?: boolean;
|
|
3920
3969
|
/**
|
|
3921
|
-
*
|
|
3922
|
-
*
|
|
3923
|
-
* 2. File names are not hashed.
|
|
3924
|
-
* 3. File minification will follow the behavior defined at the root of the Stencil config.
|
|
3970
|
+
* When `true`, all `@stencil/core/*` module references are treated as external
|
|
3971
|
+
* during bundling rather than being included in the generated output.
|
|
3925
3972
|
*
|
|
3926
3973
|
* @default false
|
|
3927
3974
|
*/
|
|
@@ -3985,8 +4032,10 @@ interface OutputTargetBase {
|
|
|
3985
4032
|
* This improves dev build times by not generating production-only artifacts.
|
|
3986
4033
|
*
|
|
3987
4034
|
* Defaults vary by output target type:
|
|
3988
|
-
* - `loader-bundle`: `
|
|
3989
|
-
* - `standalone`: `true`
|
|
4035
|
+
* - `loader-bundle`: `true` (skips the npm distribution files; the browser bundle always builds)
|
|
4036
|
+
* - `standalone`: `true` if `loader-bundle` is also configured, otherwise `false`
|
|
4037
|
+
* - `types`, `collection`, `ssr-wasm`: `true` (skips in dev)
|
|
4038
|
+
* - `assets`, `global-style`: `false` (always runs)
|
|
3990
4039
|
* - `ssr`: `true` (skips in dev, unless `devServer.ssr` is enabled)
|
|
3991
4040
|
* - `docs-*`: `true` (skips in dev)
|
|
3992
4041
|
* - `custom`: `true` (skips in dev)
|
|
@@ -4181,10 +4230,6 @@ interface Diagnostic$1 {
|
|
|
4181
4230
|
relFilePath?: string | undefined;
|
|
4182
4231
|
type: string;
|
|
4183
4232
|
}
|
|
4184
|
-
interface CacheStorage {
|
|
4185
|
-
get(key: string): Promise<any>;
|
|
4186
|
-
set(key: string, value: any): Promise<void>;
|
|
4187
|
-
}
|
|
4188
4233
|
interface WorkerOptions {
|
|
4189
4234
|
maxConcurrentWorkers?: number;
|
|
4190
4235
|
maxConcurrentTasksPerWorker?: number;
|
|
@@ -4446,6 +4491,12 @@ interface TranspileOptions {
|
|
|
4446
4491
|
* that the specified flags take effect for this component at runtime.
|
|
4447
4492
|
*/
|
|
4448
4493
|
buildOverrides?: BuildOverrides;
|
|
4494
|
+
/**
|
|
4495
|
+
* When `true`, a `.css`/`.scss` transpile also collects CSS custom-property docs
|
|
4496
|
+
* onto {@link TranspileResults.styleDocs}. Off by default, since it costs an extra parse
|
|
4497
|
+
* of the style text.
|
|
4498
|
+
*/
|
|
4499
|
+
docs?: boolean;
|
|
4449
4500
|
}
|
|
4450
4501
|
/**
|
|
4451
4502
|
* Keys of {@link BuildConditionals} that can be meaningfully overridden at
|
|
@@ -4471,6 +4522,7 @@ interface TranspileResults {
|
|
|
4471
4522
|
inputFilePath: string;
|
|
4472
4523
|
map: any;
|
|
4473
4524
|
outputFilePath: string;
|
|
4525
|
+
styleDocs?: StyleDoc[];
|
|
4474
4526
|
}
|
|
4475
4527
|
interface TransformOptions {
|
|
4476
4528
|
coreImportPath: string;
|
|
@@ -4514,8 +4566,35 @@ interface CliInitOptions {
|
|
|
4514
4566
|
logger: Logger;
|
|
4515
4567
|
sys: CompilerSystem;
|
|
4516
4568
|
}
|
|
4569
|
+
/**
|
|
4570
|
+
* A Stencil `resolveId`/`load`/`transform` plugin, as accepted by {@link StencilConfig.plugins}.
|
|
4571
|
+
*/
|
|
4572
|
+
interface Plugin$1 {
|
|
4573
|
+
name?: string;
|
|
4574
|
+
pluginType?: string;
|
|
4575
|
+
load?: (id: string, context: PluginCtx) => Promise<string> | string;
|
|
4576
|
+
resolveId?: (importee: string, importer: string, context: PluginCtx) => Promise<string> | string;
|
|
4577
|
+
transform?: (sourceText: string, id: string, context: PluginCtx) => Promise<PluginTransformResults> | PluginTransformResults;
|
|
4578
|
+
}
|
|
4579
|
+
type PluginTransformResults = PluginTransformationDescriptor | string | null;
|
|
4580
|
+
interface PluginTransformationDescriptor {
|
|
4581
|
+
code?: string;
|
|
4582
|
+
map?: string;
|
|
4583
|
+
id?: string;
|
|
4584
|
+
diagnostics?: Diagnostic$1[];
|
|
4585
|
+
dependencies?: string[];
|
|
4586
|
+
}
|
|
4587
|
+
interface PluginCtx {
|
|
4588
|
+
config: Config;
|
|
4589
|
+
sys: CompilerSystem;
|
|
4590
|
+
fs: InMemoryFileSystem;
|
|
4591
|
+
cache: Cache;
|
|
4592
|
+
diagnostics: Diagnostic$1[];
|
|
4593
|
+
}
|
|
4517
4594
|
//#endregion
|
|
4518
4595
|
//#region src/declarations/stencil-private.d.ts
|
|
4596
|
+
/** Build-time virtual `@import`s a `global-style` input can use to place Stencil-generated CSS. */
|
|
4597
|
+
type StencilVirtualImport = 'stencil-hydrate' | 'stencil-component-globals' | 'stencil-css-components';
|
|
4519
4598
|
interface SourceMap$1 {
|
|
4520
4599
|
file: string;
|
|
4521
4600
|
mappings: string;
|
|
@@ -4654,6 +4733,7 @@ interface BuildCtx {
|
|
|
4654
4733
|
esmComponentBundle: ReadonlyArray<BundleModule>;
|
|
4655
4734
|
commonJsComponentBundle: ReadonlyArray<BundleModule>;
|
|
4656
4735
|
components: ComponentCompilerMeta[];
|
|
4736
|
+
cssOnlyComponents: ComponentCompilerMeta[];
|
|
4657
4737
|
componentGraph: Map<string, string[]>;
|
|
4658
4738
|
config: ValidatedConfig;
|
|
4659
4739
|
createTimeSpan(msg: string, debug?: boolean): LoggerTimeSpan;
|
|
@@ -4702,6 +4782,9 @@ interface BuildCtx {
|
|
|
4702
4782
|
*/
|
|
4703
4783
|
stylesPromise: Promise<string>;
|
|
4704
4784
|
stylesUpdated: BuildStyleUpdate[];
|
|
4785
|
+
globalStylesUpdated: BuildGlobalStyleLinkUpdate[];
|
|
4786
|
+
/** Absolute path of the generated `{fsNamespace}.css`, when this build emitted one */
|
|
4787
|
+
stencilCssFile?: string;
|
|
4705
4788
|
timeSpan: LoggerTimeSpan;
|
|
4706
4789
|
timestamp: string;
|
|
4707
4790
|
transpileBuildCount: number;
|
|
@@ -4714,6 +4797,14 @@ interface BuildStyleUpdate {
|
|
|
4714
4797
|
styleText: string;
|
|
4715
4798
|
styleMode: string;
|
|
4716
4799
|
}
|
|
4800
|
+
/**
|
|
4801
|
+
* A live-reload update for a `global-style` output target's CSS, matched on
|
|
4802
|
+
* the client by `fileName` against the `<link>`
|
|
4803
|
+
*/
|
|
4804
|
+
interface BuildGlobalStyleLinkUpdate {
|
|
4805
|
+
fileName: string;
|
|
4806
|
+
styleText: string;
|
|
4807
|
+
}
|
|
4717
4808
|
type BuildTask = any;
|
|
4718
4809
|
interface CompilerBuildStats {
|
|
4719
4810
|
timestamp: string;
|
|
@@ -4855,6 +4946,12 @@ interface CompilerCtx {
|
|
|
4855
4946
|
cssModuleImports: Map<string, string[]>;
|
|
4856
4947
|
/** Cache of built global styles, keyed by input file path */
|
|
4857
4948
|
globalStyleCache: Map<string, string>;
|
|
4949
|
+
/** Cache of discovered CSS-only components from the last scan, keyed by absolute .css file path */
|
|
4950
|
+
cssOnlyComponentsCache: Map<string, ComponentCompilerMeta[]>;
|
|
4951
|
+
/** Contents of the last auto-placed `stencil-*` CSS, used to detect changes for HMR */
|
|
4952
|
+
stencilCss?: string;
|
|
4953
|
+
/** Virtual imports found in each built global style (post-preprocessing), keyed by input path */
|
|
4954
|
+
globalStyleVirtualImports: Map<string, Set<StencilVirtualImport>>;
|
|
4858
4955
|
collections: CollectionCompilerMeta[];
|
|
4859
4956
|
compilerOptions: any;
|
|
4860
4957
|
events: BuildEvents;
|
|
@@ -5000,7 +5097,7 @@ interface ComponentCompilerMeta extends ComponentCompilerFeatures {
|
|
|
5000
5097
|
* Custom states to initialize on the ElementInternals.states CustomStateSet.
|
|
5001
5098
|
* These are defined via @AttachInternals({ states: {...} }).
|
|
5002
5099
|
*/
|
|
5003
|
-
attachInternalsCustomStates:
|
|
5100
|
+
attachInternalsCustomStates: JsonDocsCustomState[];
|
|
5004
5101
|
componentClassName: string;
|
|
5005
5102
|
/**
|
|
5006
5103
|
* A list of web component tag names that are either:
|
|
@@ -5070,7 +5167,7 @@ interface ComponentCompilerMeta extends ComponentCompilerFeatures {
|
|
|
5070
5167
|
sourceFilePath: string;
|
|
5071
5168
|
sourceMapPath: string;
|
|
5072
5169
|
states: ComponentCompilerState[];
|
|
5073
|
-
styleDocs:
|
|
5170
|
+
styleDocs: StyleDoc[];
|
|
5074
5171
|
styles: StyleCompiler[];
|
|
5075
5172
|
globalStyles: ComponentGlobalStyle[];
|
|
5076
5173
|
tagName: string;
|
|
@@ -5273,20 +5370,6 @@ interface ComponentCompilerState {
|
|
|
5273
5370
|
* Custom states are exposed via the ElementInternals.states CustomStateSet
|
|
5274
5371
|
* and can be targeted with the CSS :state() pseudo-class.
|
|
5275
5372
|
*/
|
|
5276
|
-
interface ComponentCompilerCustomState {
|
|
5277
|
-
/**
|
|
5278
|
-
* The name of the custom state (without dashes)
|
|
5279
|
-
*/
|
|
5280
|
-
name: string;
|
|
5281
|
-
/**
|
|
5282
|
-
* The initial value of the state
|
|
5283
|
-
*/
|
|
5284
|
-
initialValue: boolean;
|
|
5285
|
-
/**
|
|
5286
|
-
* Optional JSDoc description for the state
|
|
5287
|
-
*/
|
|
5288
|
-
docs: string;
|
|
5289
|
-
}
|
|
5290
5373
|
/**
|
|
5291
5374
|
* Representation of JSDoc that is pulled off a node in the AST
|
|
5292
5375
|
*/
|
|
@@ -5298,44 +5381,7 @@ interface CompilerJsDoc {
|
|
|
5298
5381
|
/**
|
|
5299
5382
|
* Tags included in the JSDoc
|
|
5300
5383
|
*/
|
|
5301
|
-
tags:
|
|
5302
|
-
}
|
|
5303
|
-
/**
|
|
5304
|
-
* Representation of a tag that exists in a JSDoc
|
|
5305
|
-
*/
|
|
5306
|
-
interface CompilerJsDocTagInfo {
|
|
5307
|
-
/**
|
|
5308
|
-
* The name of the tag - e.g. `@deprecated`
|
|
5309
|
-
*/
|
|
5310
|
-
name: string;
|
|
5311
|
-
/**
|
|
5312
|
-
* Additional text that is associated with the tag - e.g. `@deprecated use v2 of this API`
|
|
5313
|
-
*/
|
|
5314
|
-
text?: string;
|
|
5315
|
-
}
|
|
5316
|
-
/**
|
|
5317
|
-
* The (internal) representation of a CSS block comment in a CSS, Sass, etc. file. This data structure is used during
|
|
5318
|
-
* the initial compilation phases of Stencil, as a piece of {@link ComponentCompilerMeta}.
|
|
5319
|
-
*/
|
|
5320
|
-
interface CompilerStyleDoc {
|
|
5321
|
-
/**
|
|
5322
|
-
* The name of the CSS property
|
|
5323
|
-
*/
|
|
5324
|
-
name: string;
|
|
5325
|
-
/**
|
|
5326
|
-
* The user-defined description of the CSS property
|
|
5327
|
-
*/
|
|
5328
|
-
docs: string;
|
|
5329
|
-
/**
|
|
5330
|
-
* The JSDoc-style annotation (e.g. `@prop`) that was used in the block comment to detect the comment.
|
|
5331
|
-
* Used to inform Stencil where the start of a new property's description starts (and where the previous description
|
|
5332
|
-
* ends).
|
|
5333
|
-
*/
|
|
5334
|
-
annotation: 'prop';
|
|
5335
|
-
/**
|
|
5336
|
-
* The Stencil style-mode that is associated with this property.
|
|
5337
|
-
*/
|
|
5338
|
-
mode: string;
|
|
5384
|
+
tags: JsonDocsTag[];
|
|
5339
5385
|
}
|
|
5340
5386
|
interface CompilerAssetDir {
|
|
5341
5387
|
absolutePath?: string;
|
|
@@ -5556,28 +5602,6 @@ interface Module {
|
|
|
5556
5602
|
hasVdomXlink: boolean;
|
|
5557
5603
|
hasSignalsImport: boolean;
|
|
5558
5604
|
}
|
|
5559
|
-
interface Plugin$1 {
|
|
5560
|
-
name?: string;
|
|
5561
|
-
pluginType?: string;
|
|
5562
|
-
load?: (id: string, context: PluginCtx) => Promise<string> | string;
|
|
5563
|
-
resolveId?: (importee: string, importer: string, context: PluginCtx) => Promise<string> | string;
|
|
5564
|
-
transform?: (sourceText: string, id: string, context: PluginCtx) => Promise<PluginTransformResults> | PluginTransformResults;
|
|
5565
|
-
}
|
|
5566
|
-
type PluginTransformResults = PluginTransformationDescriptor | string | null;
|
|
5567
|
-
interface PluginTransformationDescriptor {
|
|
5568
|
-
code?: string;
|
|
5569
|
-
map?: string;
|
|
5570
|
-
id?: string;
|
|
5571
|
-
diagnostics?: Diagnostic$1[];
|
|
5572
|
-
dependencies?: string[];
|
|
5573
|
-
}
|
|
5574
|
-
interface PluginCtx {
|
|
5575
|
-
config: Config;
|
|
5576
|
-
sys: CompilerSystem;
|
|
5577
|
-
fs: InMemoryFileSystem;
|
|
5578
|
-
cache: Cache;
|
|
5579
|
-
diagnostics: Diagnostic$1[];
|
|
5580
|
-
}
|
|
5581
5605
|
interface PrerenderUrlResults {
|
|
5582
5606
|
anchorUrls: string[];
|
|
5583
5607
|
diagnostics: Diagnostic$1[];
|
|
@@ -6182,4 +6206,4 @@ type MsgToWorker<T extends WorkerContextMethod> = IPCSerializable<{
|
|
|
6182
6206
|
*/
|
|
6183
6207
|
type WorkerMsgHandler = <T extends WorkerContextMethod>(msgToWorker: MsgToWorker<T>) => ReturnType<CompilerWorkerContext[T]>;
|
|
6184
6208
|
//#endregion
|
|
6185
|
-
export {
|
|
6209
|
+
export { CompilerFsStats as $, CUSTOM as $i, WorkerMainController as $n, filterActiveTargets as $r, OutputTargetBuild as $t, BuildOverrides as A, buildWarn as Ai, ResolveModuleIdResults as An, ModeValidationError as Ar, HotModuleReplacement as At, CompilerEventBuildLog as B, loadTypeScriptDiagnostics as Bi, SsrFactoryOptions as Bn, isJsFile as Br, Logger as Bt, BuildEmitEvents as C, TYPES as Ca, isOutputTargetWww as Ci, PluginTransformResults as Cn, JsonDocsStyle as Cr, DevServerEditor as Ct, BuildOnEventRemove as D, XLINK_NS as Da, TASK_CANCELED_MSG as Di, PrerenderResults as Dn, JsonDocsValue as Dr, HistoryApiFallback as Dt, BuildNoChangeResults as E, WWW as Ea, shouldExcludeComponent as Ei, PrerenderOptions as En, JsonDocsUsage as Er, FsWatchResults as Et, Compiler as F, escapeHtml as Fi, SerializeDocumentOptions as Fn, createJsVarName as Fr, LazyRequire as Ft, CompilerEventFileAdd as G, formatLazyBundleRuntimeMeta as Gi, TransformOptions as Gn, readOnlyArrayHasStringMember as Gr, OptimizeCssInput as Gt, CompilerEventBuildStart as H, isRolldownError as Hi, StencilDevServerConfig as Hn, isTsFile as Hr, LoggerTimeSpan as Ht, CompilerBuildResults as I, normalizeDiagnostics as Ii, ServiceWorkerConfig as In, generatePreamble as Ir, LightDomPatches as It, CompilerEventFsChange as J, CMP_FLAGS as Ji, TranspileResults as Jn, getSourceMappingUrlForEndOfFile as Jr, OptimizeJsOutput as Jt, CompilerEventFileDelete as K, stringifyRuntimeData as Ki, TranspileOnlyResults as Kn, readPackageJson as Kr, OptimizeCssOutput as Kt, CompilerBuildStart as L, splitLineBreaks as Li, SitemapXmpOpts as Ln, getTextDocs as Lr, LoadConfigInit as Lt, CliInitOptions as M, hasError as Mi, RobotsTxtOpts as Mn, validateComponentTag as Mr, HydrateFactoryOptions as Mt, CompileScriptMinifyOptions as N, hasWarning as Ni, RobotsTxtResults as Nn, ParsePackageJsonResult as Nr, HydratedFlag as Nt, BuildOnEvents as O, buildError as Oi, PrerenderStartOptions as On, StyleDoc as Or, HmrGlobalStyleUpdate as Ot, CompileTarget as P, shouldIgnoreError as Pi, RolldownConfig as Pn, addDocBlock as Pr, LOG_LEVELS as Pt, CompilerFileWatcherEvent as Q, COPY as Qi, WatcherCloseResults as Qn, FilterComponentsResult as Qr, OutputTargetBaseNext as Qt, CompilerDependency as R, augmentDiagnosticWithNode as Ri, SitemapXmpResults as Rn, hasDependency as Rr, LoadConfigResults as Rt, AutoprefixerOptions as S, SVG_NS as Sa, isOutputTargetTypes as Si, PluginCtx as Sn, JsonDocsSlot as Sr, DevServerConfig as St, BuildLog as T, WATCH_FLAGS as Ta, relativeImport as Ti, PrerenderHydrateOptions as Tn, JsonDocsTypeLibrary as Tr, DocsReadmeCustomColumn as Tt, CompilerEventDirAdd as U, loadRolldownDiagnostics as Ui, StencilDocsConfig as Un, isTsxFile as Ur, ModeConfig as Ut, CompilerEventBuildNoChange as V, createOnWarnFn as Vi, StencilConfig as Vn, isJsxFile as Vr, LoggerLineUpdater as Vt, CompilerEventDirDelete as W, formatComponentRuntimeMeta as Wi, SystemDetails as Wn, parsePackageJson as Wr, NodeResolveConfig as Wt, CompilerFileWatcher as X, COLLECTION_APP_DATA_FILE_NAME as Xi, ValidatedConfig as Xn, rolldownToStencilSourceMap as Xr, OutputTargetAssets as Xt, CompilerEventName as Y, COLLECTION as Yi, UnvalidatedConfig as Yn, getSourceMappingUrlLinker as Yr, OutputTarget as Yt, CompilerFileWatcherCallback as Z, COLLECTION_MANIFEST_FILE_NAME as Zi, ValidatedOutputTargetWww as Zn, result_d_exports as Zr, OutputTargetBase as Zt, PrintLine as _, SSR as _a, isOutputTargetLoaderBundle as _i, OutputTargetWww as _n, JsonDocsListener as _r, CopyTask as _t, ComponentCompilerEvent as a, DOCS_JSON as aa, isOutputTargetCollection as ai, OutputTargetDocsCustom as an, RafCallback as ar, CompilerSystemRealpathResults as at, SsrResults as b, STATS as ba, isOutputTargetStandalone as bi, PlatformPath as bn, JsonDocsPart as br, CustomElementsExportBehaviorOptions as bt, ComponentCompilerMethod as c, EVENT_FLAGS as ca, isOutputTargetDistLazy as ci, OutputTargetDocsReadme as cn, TagTransformer as cr, CompilerSystemRemoveFileResults as ct, ComponentCompilerTypeReferences as d, HOST_FLAGS as da, isOutputTargetDocsCustom as di, OutputTargetLoaderBundle as dn, JsonDocMethodParameter as dr, CompilerSystemWriteFileResults as dt, DEFAULT_STYLE_MODE as ea, filterExcludedComponents as ei, OutputTargetCollection as en, WorkerOptions as er, CompilerRequest as et, ComponentGlobalStyle as f, HTML_NS as fa, isOutputTargetDocsCustomElementsManifest as fi, OutputTargetSsr as fn, JsonDocs as fr, CompilerWatcher as ft, PrerenderUrlResults as g, NODE_TYPES as ga, isOutputTargetGlobalStyle as gi, OutputTargetTypes as gn, JsonDocsEvent as gr, CopyResults as gt, PackageJsonData as h, MEMBER_FLAGS as ha, isOutputTargetDocsVscode as hi, OutputTargetStats as hn, JsonDocsDependencyGraph as hr, ConfigCompat as ht, CompilerWorkerContext as i, DOCS_CUSTOM_ELEMENTS_MANIFEST as ia, isOutputTargetAssets as ii, OutputTargetDocsAgentSkill as in, MixedInCtor as ir, CompilerSystemCreateDirectoryResults as it, BuildResultsComponentGraph as j, catchError as ji, ResolveModuleOptions as jn, validateComponentModes as jr, HydrateDocumentOptions as jt, BuildOutput as k, buildJsonFileError as ki, ResolveModuleIdOptions as kn, FsWriteResults as kr, HmrStyleUpdate as kt, ComponentCompilerProperty as l, GENERATED_DTS as la, isOutputTargetDocs as li, OutputTargetDocsVscode as ln, UserBuildConditionals as lr, CompilerSystemRenameResults as lt, LazyBundlesRuntimeData as m, LOADER_BUNDLE as ma, isOutputTargetDocsReadme as mi, OutputTargetStandalone as mn, JsonDocsCustomState as mr, ConfigBundle as mt, ChildType as n, DOCS_AGENT_SKILL as na, getComponentsDtsTypesFilePath as ni, OutputTargetCustom as nn, ErrorHandler as nr, CompilerSystem as nt, ComponentCompilerListener as o, DOCS_README as oa, isOutputTargetCopy as oi, OutputTargetDocsCustomElementsManifest as on, ReactiveControllerHostInterface as or, CompilerSystemRemoveDirectoryOptions as ot, HostElement as p, LISTENER_FLAGS as pa, isOutputTargetDocsJson as pi, OutputTargetSsrWasm as pn, JsonDocsComponent as pr, Config as pt, CompilerEventFileUpdate as q, ASSETS as qi, TranspileOptions as qn, getInlineSourceMappingUrlLinker as qr, OptimizeJsInput as qt, CompilerCtx as r, DOCS_CUSTOM as ra, getComponentsFromModules as ri, OutputTargetDistLazy as rn, FunctionalComponent as rr, CompilerSystemCreateDirectoryOptions as rt, ComponentCompilerMeta as s, DOCS_VSCODE as sa, isOutputTargetCustom as si, OutputTargetDocsJson as sn, ResolutionHandler as sr, CompilerSystemRemoveDirectoryResults as st, BuildCtx as t, DIST_LAZY as ta, getComponentsDtsSrcFilePath as ti, OutputTargetCopy as tn, ComponentInterface as tr, CompilerRequestResponse as tt, ComponentCompilerState as u, GLOBAL_STYLE as ua, isOutputTargetDocsAgentSkill as ui, OutputTargetGlobalStyle as un, VNode as ur, CompilerSystemRenamedPath as ut, PropsType as v, SSR_WASM as va, isOutputTargetSsr as vi, PageReloadStrategy as vn, JsonDocsMethod as vr, Credentials as vt, BuildEvents as w, VALID_CONFIG_OUTPUT_TARGETS as wa, isValidConfigOutputTarget as wi, PrerenderConfig as wn, JsonDocsTag as wr, Diagnostic$1 as wt, WorkerMsgHandler as x, STYLE_EXT as xa, isOutputTargetStats as xi, Plugin$1 as xn, JsonDocsProp as xr, DevServer as xt, RuntimeRef as y, STANDALONE as ya, isOutputTargetSsrWasm as yi, ParsedPath as yn, JsonDocsMethodReturn as yr, CustomElementsExportBehavior as yt, CompilerEventBuildFinish as z, loadTypeScriptDiagnostic as zi, SsrDocumentOptions as zn, isDtsFile as zr, LogLevel as zt };
|