@stencil/angular-output-target 0.9.1 → 0.10.1

package/README.md

@@ -49,3 +49,4 @@ export const config: Config = {
 | `excludeComponents`    | An array of tag names to exclude from generating component wrappers for. This is helpful when have a custom framework implementation of a specific component or need to extend the base component wrapper behavior.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | `outputType`           | Specifies the type of output to be generated. It can take one of the following values: <br />1. `component`: Generates all the component wrappers to be declared on an Angular module. This option is required for Stencil projects using the `dist` hydrated output.<br /> 2. `scam`: Generates a separate Angular module for each component.<br /> 3. `standalone`: Generates standalone component wrappers.<br /> Both `scam` and `standalone` options are compatible with the `dist-custom-elements` output. <br />Note: Please choose the appropriate `outputType` based on your project's requirements and the desired output structure. Defaults to `component`. |
 | `customElementsDir`    | This is the directory where the custom elements are imported from when using the [Custom Elements Bundle](https://stenciljs.com/docs/custom-elements). Defaults to the `components` directory. Only applies for `outputType: "scam"` or `outputType: "standalone"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `inlineProperties` | Experimental. When true, tries to inline the properties of components. This is required to enable Angular Language Service to type-check and show jsdocs when using the components in html-templates.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

package/dist/generate-angular-component.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentCompilerEvent } from '@stencil/core/internal';
+import type { ComponentCompilerEvent, ComponentCompilerProperty } from '@stencil/core/internal';
 import type { OutputType } from './types';
 /**
  * Creates an Angular component declaration from formatted Stencil compiler metadata.
@@ -9,9 +9,10 @@ import type { OutputType } from './types';
  * @param methods The methods of the Stencil component. (e.g. ['myMethod']).
  * @param includeImportCustomElements Whether to define the component as a custom element.
  * @param standalone Whether to define the component as a standalone component.
+ * @param inlineComponentProps List of properties that should be inlined into the component definition.
  * @returns The component declaration as a string.
  */
-export declare const createAngularComponentDefinition: (tagName: string, inputs: readonly string[], outputs: readonly string[], methods: readonly string[], includeImportCustomElements?: boolean, standalone?: boolean) => string;
+export declare const createAngularComponentDefinition: (tagName: string, inputs: readonly string[], outputs: readonly string[], methods: readonly string[], includeImportCustomElements?: boolean, standalone?: boolean, inlineComponentProps?: readonly ComponentCompilerProperty[]) => string;
 /**
  * Creates the component interface type definition.
  * @param outputType The output type.

package/dist/generate-angular-component.js

@@ -1,4 +1,29 @@
 import { createComponentEventTypeImports, dashToPascalCase, formatToQuotedList } from './utils';
+/**
+ * Creates a property declaration.
+ *
+ * @param prop A ComponentCompilerEvent or ComponentCompilerProperty to turn into a property declaration.
+ * @param type The name of the type (e.g. 'string')
+ * @param inlinePropertyAsSetter Inlines the entire property as an empty Setter, to aid Angulars Compilerp
+ * @returns The property declaration as a string.
+ */
+function createPropertyDeclaration(prop, type, inlinePropertyAsSetter = false) {
+    const comment = createDocComment(prop.docs);
+    let eventName = prop.name;
+    if (/[-/]/.test(prop.name)) {
+        // If a member name includes a dash or a forward slash, we need to wrap it in quotes.
+        // https://github.com/ionic-team/stencil-ds-output-targets/issues/212
+        eventName = `'${prop.name}'`;
+    }
+    if (inlinePropertyAsSetter) {
+        return `${comment.length > 0 ? `  ${comment}` : ''}
+  set ${eventName}(_: ${type}) {};`;
+    }
+    else {
+        return `${comment.length > 0 ? `  ${comment}` : ''}
+  ${eventName}: ${type};`;
+    }
+}
 /**
  * Creates an Angular component declaration from formatted Stencil compiler metadata.
  *
@@ -8,9 +33,10 @@ import { createComponentEventTypeImports, dashToPascalCase, formatToQuotedList }
  * @param methods The methods of the Stencil component. (e.g. ['myMethod']).
  * @param includeImportCustomElements Whether to define the component as a custom element.
  * @param standalone Whether to define the component as a standalone component.
+ * @param inlineComponentProps List of properties that should be inlined into the component definition.
  * @returns The component declaration as a string.
  */
-export const createAngularComponentDefinition = (tagName, inputs, outputs, methods, includeImportCustomElements = false, standalone = false) => {
+export const createAngularComponentDefinition = (tagName, inputs, outputs, methods, includeImportCustomElements = false, standalone = false, inlineComponentProps = []) => {
     const tagNameAsPascal = dashToPascalCase(tagName);
     const hasInputs = inputs.length > 0;
     const hasOutputs = outputs.length > 0;
@@ -36,6 +62,8 @@ export const createAngularComponentDefinition = (tagName, inputs, outputs, metho
     if (standalone && includeImportCustomElements) {
         standaloneOption = `\n  standalone: true`;
     }
+    const propertyDeclarations = inlineComponentProps.map((m) => createPropertyDeclaration(m, `Components.${tagNameAsPascal}['${m.name}']`, true));
+    const propertiesDeclarationText = [`protected el: HTML${tagNameAsPascal}Element;`, ...propertyDeclarations].join('\n  ');
     /**
      * Notes on the generated output:
      * - We disable @angular-eslint/no-inputs-metadata-property, so that
@@ -52,7 +80,7 @@ export const createAngularComponentDefinition = (tagName, inputs, outputs, metho
   inputs: [${formattedInputs}],${standaloneOption}
 })
 export class ${tagNameAsPascal} {
-  protected el: HTMLElement;
+  ${propertiesDeclarationText}
   constructor(c: ChangeDetectorRef, r: ElementRef, protected z: NgZone) {
     c.detach();
     this.el = r.nativeElement;${hasOutputs
@@ -146,17 +174,7 @@ export const createComponentTypeDefinition = (outputType, tagNameAsPascal, event
         customElementsDir,
         outputType,
     });
-    const eventTypes = publicEvents.map((event) => {
-        const comment = createDocComment(event.docs);
-        let eventName = event.name;
-        if (/[-/]/.test(event.name)) {
-            // If an event name includes a dash or a forward slash, we need to wrap it in quotes.
-            // https://github.com/ionic-team/stencil-ds-output-targets/issues/212
-            eventName = `'${event.name}'`;
-        }
-        return `${comment.length > 0 ? `  ${comment}` : ''}
-  ${eventName}: EventEmitter<CustomEvent<${formatOutputType(tagNameAsPascal, event)}>>;`;
-    });
+    const eventTypes = publicEvents.map((event) => createPropertyDeclaration(event, `EventEmitter<CustomEvent<${formatOutputType(tagNameAsPascal, event)}>>`));
     const interfaceDeclaration = `export declare interface ${tagNameAsPascal} extends Components.${tagNameAsPascal} {`;
     const typeDefinition = (eventTypeImports.length > 0 ? `${eventTypeImports + '\n\n'}` : '') +
         `${interfaceDeclaration}${eventTypes.length === 0

package/dist/index.cjs.js

@@ -1,14 +1,8 @@
 'use strict';
 
-Object.defineProperty(exports, '__esModule', { value: true });
-
 var path = require('path');
 var os = require('os');
 
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-var path__default = /*#__PURE__*/_interopDefaultLegacy(path);
-
 const OutputTypes = {
     Component: 'component',
     Scam: 'scam',
@@ -58,18 +52,18 @@ function normalizePath(str) {
     return str;
 }
 function relativeImport(pathFrom, pathTo, ext) {
-    let relativePath = path__default["default"].relative(path__default["default"].dirname(pathFrom), path__default["default"].dirname(pathTo));
+    let relativePath = path.relative(path.dirname(pathFrom), path.dirname(pathTo));
     if (relativePath === '') {
         relativePath = '.';
     }
     else if (relativePath[0] !== '.') {
         relativePath = './' + relativePath;
     }
-    return normalizePath(`${relativePath}/${path__default["default"].basename(pathTo, ext)}`);
+    return normalizePath(`${relativePath}/${path.basename(pathTo, ext)}`);
 }
 async function readPackageJson(config, rootDir) {
     var _a;
-    const pkgJsonPath = path__default["default"].join(rootDir, 'package.json');
+    const pkgJsonPath = path.join(rootDir, 'package.json');
     let pkgJson;
     try {
         pkgJson = (await ((_a = config.sys) === null || _a === void 0 ? void 0 : _a.readFile(pkgJsonPath, 'utf8')));
@@ -144,6 +138,31 @@ const EXTENDED_PATH_REGEX = /^\\\\\?\\/;
 const NON_ASCII_REGEX = /[^\x00-\x80]+/;
 const SLASH_REGEX = /\\/g;
 
+/**
+ * Creates a property declaration.
+ *
+ * @param prop A ComponentCompilerEvent or ComponentCompilerProperty to turn into a property declaration.
+ * @param type The name of the type (e.g. 'string')
+ * @param inlinePropertyAsSetter Inlines the entire property as an empty Setter, to aid Angulars Compilerp
+ * @returns The property declaration as a string.
+ */
+function createPropertyDeclaration(prop, type, inlinePropertyAsSetter = false) {
+    const comment = createDocComment(prop.docs);
+    let eventName = prop.name;
+    if (/[-/]/.test(prop.name)) {
+        // If a member name includes a dash or a forward slash, we need to wrap it in quotes.
+        // https://github.com/ionic-team/stencil-ds-output-targets/issues/212
+        eventName = `'${prop.name}'`;
+    }
+    if (inlinePropertyAsSetter) {
+        return `${comment.length > 0 ? `  ${comment}` : ''}
+  set ${eventName}(_: ${type}) {};`;
+    }
+    else {
+        return `${comment.length > 0 ? `  ${comment}` : ''}
+  ${eventName}: ${type};`;
+    }
+}
 /**
  * Creates an Angular component declaration from formatted Stencil compiler metadata.
  *
@@ -153,9 +172,10 @@ const SLASH_REGEX = /\\/g;
  * @param methods The methods of the Stencil component. (e.g. ['myMethod']).
  * @param includeImportCustomElements Whether to define the component as a custom element.
  * @param standalone Whether to define the component as a standalone component.
+ * @param inlineComponentProps List of properties that should be inlined into the component definition.
  * @returns The component declaration as a string.
  */
-const createAngularComponentDefinition = (tagName, inputs, outputs, methods, includeImportCustomElements = false, standalone = false) => {
+const createAngularComponentDefinition = (tagName, inputs, outputs, methods, includeImportCustomElements = false, standalone = false, inlineComponentProps = []) => {
     const tagNameAsPascal = dashToPascalCase(tagName);
     const hasInputs = inputs.length > 0;
     const hasOutputs = outputs.length > 0;
@@ -181,6 +201,8 @@ const createAngularComponentDefinition = (tagName, inputs, outputs, methods, inc
     if (standalone && includeImportCustomElements) {
         standaloneOption = `\n  standalone: true`;
     }
+    const propertyDeclarations = inlineComponentProps.map((m) => createPropertyDeclaration(m, `Components.${tagNameAsPascal}['${m.name}']`, true));
+    const propertiesDeclarationText = [`protected el: HTML${tagNameAsPascal}Element;`, ...propertyDeclarations].join('\n  ');
     /**
      * Notes on the generated output:
      * - We disable @angular-eslint/no-inputs-metadata-property, so that
@@ -197,7 +219,7 @@ const createAngularComponentDefinition = (tagName, inputs, outputs, methods, inc
   inputs: [${formattedInputs}],${standaloneOption}
 })
 export class ${tagNameAsPascal} {
-  protected el: HTMLElement;
+  ${propertiesDeclarationText}
   constructor(c: ChangeDetectorRef, r: ElementRef, protected z: NgZone) {
     c.detach();
     this.el = r.nativeElement;${hasOutputs
@@ -291,17 +313,7 @@ const createComponentTypeDefinition = (outputType, tagNameAsPascal, events, comp
         customElementsDir,
         outputType,
     });
-    const eventTypes = publicEvents.map((event) => {
-        const comment = createDocComment(event.docs);
-        let eventName = event.name;
-        if (/[-/]/.test(event.name)) {
-            // If an event name includes a dash or a forward slash, we need to wrap it in quotes.
-            // https://github.com/ionic-team/stencil-ds-output-targets/issues/212
-            eventName = `'${event.name}'`;
-        }
-        return `${comment.length > 0 ? `  ${comment}` : ''}
-  ${eventName}: EventEmitter<CustomEvent<${formatOutputType(tagNameAsPascal, event)}>>;`;
-    });
+    const eventTypes = publicEvents.map((event) => createPropertyDeclaration(event, `EventEmitter<CustomEvent<${formatOutputType(tagNameAsPascal, event)}>>`));
     const interfaceDeclaration = `export declare interface ${tagNameAsPascal} extends Components.${tagNameAsPascal} {`;
     const typeDefinition = (eventTypeImports.length > 0 ? `${eventTypeImports + '\n\n'}` : '') +
         `${interfaceDeclaration}${eventTypes.length === 0
@@ -336,7 +348,7 @@ async function generateValueAccessors(compilerCtx, components, outputTarget, con
     if (!Array.isArray(outputTarget.valueAccessorConfigs) || outputTarget.valueAccessorConfigs.length === 0) {
         return;
     }
-    const targetDir = path__default["default"].dirname(outputTarget.directivesProxyFile);
+    const targetDir = path.dirname(outputTarget.directivesProxyFile);
     const normalizedValueAccessors = outputTarget.valueAccessorConfigs.reduce((allAccessors, va) => {
         const elementSelectors = Array.isArray(va.elementSelectors) ? va.elementSelectors : [va.elementSelectors];
         const type = va.type;
@@ -354,8 +366,8 @@ async function generateValueAccessors(compilerCtx, components, outputTarget, con
     await Promise.all(Object.keys(normalizedValueAccessors).map(async (type) => {
         const valueAccessorType = type; // Object.keys converts to string
         const targetFileName = `${type}-value-accessor.ts`;
-        const targetFilePath = path__default["default"].join(targetDir, targetFileName);
-        const srcFilePath = path__default["default"].join(__dirname, '../resources/control-value-accessors/', targetFileName);
+        const targetFilePath = path.join(targetDir, targetFileName);
+        const srcFilePath = path.join(__dirname, '../resources/control-value-accessors/', targetFileName);
         const srcFileContents = await compilerCtx.fs.readFile(srcFilePath);
         const finalText = createValueAccessor(srcFileContents, normalizedValueAccessors[valueAccessorType], outputTarget.outputType);
         await compilerCtx.fs.writeFile(targetFilePath, finalText);
@@ -375,14 +387,14 @@ function copyResources$1(config, resourcesFilesToCopy, directory) {
     }
     const copyTasks = resourcesFilesToCopy.map((rf) => {
         return {
-            src: path__default["default"].join(__dirname, '../resources/control-value-accessors/', rf),
-            dest: path__default["default"].join(directory, rf),
+            src: path.join(__dirname, '../resources/control-value-accessors/', rf),
+            dest: path.join(directory, rf),
             keepDirStructure: false,
             warn: false,
             ignore: [],
         };
     });
-    return config.sys.copy(copyTasks, path__default["default"].join(directory));
+    return config.sys.copy(copyTasks, path.join(directory));
 }
 const VALUE_ACCESSOR_SELECTORS = `<VALUE_ACCESSOR_SELECTORS>`;
 const VALUE_ACCESSOR_EVENT = `<VALUE_ACCESSOR_EVENT>`;
@@ -426,8 +438,8 @@ async function copyResources(config, outputTarget) {
     if (!config.sys || !config.sys.copy || !config.sys.glob) {
         throw new Error('stencil is not properly initialized at this step. Notify the developer');
     }
-    const srcDirectory = path__default["default"].join(__dirname, '..', 'angular-component-lib');
-    const destDirectory = path__default["default"].join(path__default["default"].dirname(outputTarget.directivesProxyFile), 'angular-component-lib');
+    const srcDirectory = path.join(__dirname, '..', 'angular-component-lib');
+    const destDirectory = path.join(path.dirname(outputTarget.directivesProxyFile), 'angular-component-lib');
     return config.sys.copy([
         {
             src: srcDirectory,
@@ -439,8 +451,8 @@ async function copyResources(config, outputTarget) {
     ], srcDirectory);
 }
 function generateProxies(components, pkgData, outputTarget, rootDir) {
-    const distTypesDir = path__default["default"].dirname(pkgData.types);
-    const dtsFilePath = path__default["default"].join(rootDir, distTypesDir, GENERATED_DTS);
+    const distTypesDir = path.dirname(pkgData.types);
+    const dtsFilePath = path.join(rootDir, distTypesDir, GENERATED_DTS);
     const { outputType } = outputTarget;
     const componentsTypeFile = relativeImport(outputTarget.directivesProxyFile, dtsFilePath, '.d.ts');
     const includeSingleComponentAngularModules = outputType === OutputTypes.Scam;
@@ -504,10 +516,11 @@ ${createImportStatement(componentLibImports, './angular-component-lib/utils')}\n
     const { componentCorePackage, customElementsDir } = outputTarget;
     for (let cmpMeta of components) {
         const tagNameAsPascal = dashToPascalCase(cmpMeta.tagName);
-        const inputs = [];
+        const internalProps = [];
         if (cmpMeta.properties) {
-            inputs.push(...cmpMeta.properties.filter(filterInternalProps).map(mapPropName));
+            internalProps.push(...cmpMeta.properties.filter(filterInternalProps));
         }
+        const inputs = internalProps.map(mapPropName);
         if (cmpMeta.virtualProperties) {
             inputs.push(...cmpMeta.virtualProperties.map(mapPropName));
         }
@@ -520,13 +533,14 @@ ${createImportStatement(componentLibImports, './angular-component-lib/utils')}\n
         if (cmpMeta.methods) {
             methods.push(...cmpMeta.methods.filter(filterInternalProps).map(mapPropName));
         }
+        const inlineComponentProps = outputTarget.inlineProperties ? internalProps : [];
         /**
          * For each component, we need to generate:
          * 1. The @Component decorated class
          * 2. Optionally the @NgModule decorated class (if includeSingleComponentAngularModules is true)
          * 3. The component interface (using declaration merging for types).
          */
-        const componentDefinition = createAngularComponentDefinition(cmpMeta.tagName, inputs, outputs, methods, isCustomElementsBuild, isStandaloneBuild);
+        const componentDefinition = createAngularComponentDefinition(cmpMeta.tagName, inputs, outputs, methods, isCustomElementsBuild, isStandaloneBuild, inlineComponentProps);
         const moduleDefinition = generateAngularModuleForComponent(cmpMeta.tagName);
         const componentTypeDefinition = createComponentTypeDefinition(outputType, tagNameAsPascal, cmpMeta.events, componentCorePackage, customElementsDir);
         proxyFileOutput.push(componentDefinition, '\n');
@@ -564,11 +578,11 @@ function normalizeOutputTarget(config, outputTarget) {
     if (outputTarget.directivesProxyFile == null) {
         throw new Error('directivesProxyFile is required. Please set it in the Stencil config.');
     }
-    if (outputTarget.directivesProxyFile && !path__default["default"].isAbsolute(outputTarget.directivesProxyFile)) {
-        results.directivesProxyFile = normalizePath(path__default["default"].join(config.rootDir, outputTarget.directivesProxyFile));
+    if (outputTarget.directivesProxyFile && !path.isAbsolute(outputTarget.directivesProxyFile)) {
+        results.directivesProxyFile = normalizePath(path.join(config.rootDir, outputTarget.directivesProxyFile));
     }
-    if (outputTarget.directivesArrayFile && !path__default["default"].isAbsolute(outputTarget.directivesArrayFile)) {
-        results.directivesArrayFile = normalizePath(path__default["default"].join(config.rootDir, outputTarget.directivesArrayFile));
+    if (outputTarget.directivesArrayFile && !path.isAbsolute(outputTarget.directivesArrayFile)) {
+        results.directivesArrayFile = normalizePath(path.join(config.rootDir, outputTarget.directivesArrayFile));
     }
     if (outputTarget.includeSingleComponentAngularModules !== undefined) {
         throw new Error("The 'includeSingleComponentAngularModules' option has been removed. Please use 'outputType' instead.");

package/dist/index.js

@@ -136,6 +136,31 @@ const EXTENDED_PATH_REGEX = /^\\\\\?\\/;
 const NON_ASCII_REGEX = /[^\x00-\x80]+/;
 const SLASH_REGEX = /\\/g;
 
+/**
+ * Creates a property declaration.
+ *
+ * @param prop A ComponentCompilerEvent or ComponentCompilerProperty to turn into a property declaration.
+ * @param type The name of the type (e.g. 'string')
+ * @param inlinePropertyAsSetter Inlines the entire property as an empty Setter, to aid Angulars Compilerp
+ * @returns The property declaration as a string.
+ */
+function createPropertyDeclaration(prop, type, inlinePropertyAsSetter = false) {
+    const comment = createDocComment(prop.docs);
+    let eventName = prop.name;
+    if (/[-/]/.test(prop.name)) {
+        // If a member name includes a dash or a forward slash, we need to wrap it in quotes.
+        // https://github.com/ionic-team/stencil-ds-output-targets/issues/212
+        eventName = `'${prop.name}'`;
+    }
+    if (inlinePropertyAsSetter) {
+        return `${comment.length > 0 ? `  ${comment}` : ''}
+  set ${eventName}(_: ${type}) {};`;
+    }
+    else {
+        return `${comment.length > 0 ? `  ${comment}` : ''}
+  ${eventName}: ${type};`;
+    }
+}
 /**
  * Creates an Angular component declaration from formatted Stencil compiler metadata.
  *
@@ -145,9 +170,10 @@ const SLASH_REGEX = /\\/g;
  * @param methods The methods of the Stencil component. (e.g. ['myMethod']).
  * @param includeImportCustomElements Whether to define the component as a custom element.
  * @param standalone Whether to define the component as a standalone component.
+ * @param inlineComponentProps List of properties that should be inlined into the component definition.
  * @returns The component declaration as a string.
  */
-const createAngularComponentDefinition = (tagName, inputs, outputs, methods, includeImportCustomElements = false, standalone = false) => {
+const createAngularComponentDefinition = (tagName, inputs, outputs, methods, includeImportCustomElements = false, standalone = false, inlineComponentProps = []) => {
     const tagNameAsPascal = dashToPascalCase(tagName);
     const hasInputs = inputs.length > 0;
     const hasOutputs = outputs.length > 0;
@@ -173,6 +199,8 @@ const createAngularComponentDefinition = (tagName, inputs, outputs, methods, inc
     if (standalone && includeImportCustomElements) {
         standaloneOption = `\n  standalone: true`;
     }
+    const propertyDeclarations = inlineComponentProps.map((m) => createPropertyDeclaration(m, `Components.${tagNameAsPascal}['${m.name}']`, true));
+    const propertiesDeclarationText = [`protected el: HTML${tagNameAsPascal}Element;`, ...propertyDeclarations].join('\n  ');
     /**
      * Notes on the generated output:
      * - We disable @angular-eslint/no-inputs-metadata-property, so that
@@ -189,7 +217,7 @@ const createAngularComponentDefinition = (tagName, inputs, outputs, methods, inc
   inputs: [${formattedInputs}],${standaloneOption}
 })
 export class ${tagNameAsPascal} {
-  protected el: HTMLElement;
+  ${propertiesDeclarationText}
   constructor(c: ChangeDetectorRef, r: ElementRef, protected z: NgZone) {
     c.detach();
     this.el = r.nativeElement;${hasOutputs
@@ -283,17 +311,7 @@ const createComponentTypeDefinition = (outputType, tagNameAsPascal, events, comp
         customElementsDir,
         outputType,
     });
-    const eventTypes = publicEvents.map((event) => {
-        const comment = createDocComment(event.docs);
-        let eventName = event.name;
-        if (/[-/]/.test(event.name)) {
-            // If an event name includes a dash or a forward slash, we need to wrap it in quotes.
-            // https://github.com/ionic-team/stencil-ds-output-targets/issues/212
-            eventName = `'${event.name}'`;
-        }
-        return `${comment.length > 0 ? `  ${comment}` : ''}
-  ${eventName}: EventEmitter<CustomEvent<${formatOutputType(tagNameAsPascal, event)}>>;`;
-    });
+    const eventTypes = publicEvents.map((event) => createPropertyDeclaration(event, `EventEmitter<CustomEvent<${formatOutputType(tagNameAsPascal, event)}>>`));
     const interfaceDeclaration = `export declare interface ${tagNameAsPascal} extends Components.${tagNameAsPascal} {`;
     const typeDefinition = (eventTypeImports.length > 0 ? `${eventTypeImports + '\n\n'}` : '') +
         `${interfaceDeclaration}${eventTypes.length === 0
@@ -496,10 +514,11 @@ ${createImportStatement(componentLibImports, './angular-component-lib/utils')}\n
     const { componentCorePackage, customElementsDir } = outputTarget;
     for (let cmpMeta of components) {
         const tagNameAsPascal = dashToPascalCase(cmpMeta.tagName);
-        const inputs = [];
+        const internalProps = [];
         if (cmpMeta.properties) {
-            inputs.push(...cmpMeta.properties.filter(filterInternalProps).map(mapPropName));
+            internalProps.push(...cmpMeta.properties.filter(filterInternalProps));
         }
+        const inputs = internalProps.map(mapPropName);
         if (cmpMeta.virtualProperties) {
             inputs.push(...cmpMeta.virtualProperties.map(mapPropName));
         }
@@ -512,13 +531,14 @@ ${createImportStatement(componentLibImports, './angular-component-lib/utils')}\n
         if (cmpMeta.methods) {
             methods.push(...cmpMeta.methods.filter(filterInternalProps).map(mapPropName));
         }
+        const inlineComponentProps = outputTarget.inlineProperties ? internalProps : [];
         /**
          * For each component, we need to generate:
          * 1. The @Component decorated class
          * 2. Optionally the @NgModule decorated class (if includeSingleComponentAngularModules is true)
          * 3. The component interface (using declaration merging for types).
          */
-        const componentDefinition = createAngularComponentDefinition(cmpMeta.tagName, inputs, outputs, methods, isCustomElementsBuild, isStandaloneBuild);
+        const componentDefinition = createAngularComponentDefinition(cmpMeta.tagName, inputs, outputs, methods, isCustomElementsBuild, isStandaloneBuild, inlineComponentProps);
         const moduleDefinition = generateAngularModuleForComponent(cmpMeta.tagName);
         const componentTypeDefinition = createComponentTypeDefinition(outputType, tagNameAsPascal, cmpMeta.events, componentCorePackage, customElementsDir);
         proxyFileOutput.push(componentDefinition, '\n');

package/dist/output-angular.js

@@ -101,10 +101,11 @@ ${createImportStatement(componentLibImports, './angular-component-lib/utils')}\n
     const { componentCorePackage, customElementsDir } = outputTarget;
     for (let cmpMeta of components) {
         const tagNameAsPascal = dashToPascalCase(cmpMeta.tagName);
-        const inputs = [];
+        const internalProps = [];
         if (cmpMeta.properties) {
-            inputs.push(...cmpMeta.properties.filter(filterInternalProps).map(mapPropName));
+            internalProps.push(...cmpMeta.properties.filter(filterInternalProps));
         }
+        const inputs = internalProps.map(mapPropName);
         if (cmpMeta.virtualProperties) {
             inputs.push(...cmpMeta.virtualProperties.map(mapPropName));
         }
@@ -117,13 +118,14 @@ ${createImportStatement(componentLibImports, './angular-component-lib/utils')}\n
         if (cmpMeta.methods) {
             methods.push(...cmpMeta.methods.filter(filterInternalProps).map(mapPropName));
         }
+        const inlineComponentProps = outputTarget.inlineProperties ? internalProps : [];
         /**
          * For each component, we need to generate:
          * 1. The @Component decorated class
          * 2. Optionally the @NgModule decorated class (if includeSingleComponentAngularModules is true)
          * 3. The component interface (using declaration merging for types).
          */
-        const componentDefinition = createAngularComponentDefinition(cmpMeta.tagName, inputs, outputs, methods, isCustomElementsBuild, isStandaloneBuild);
+        const componentDefinition = createAngularComponentDefinition(cmpMeta.tagName, inputs, outputs, methods, isCustomElementsBuild, isStandaloneBuild, inlineComponentProps);
         const moduleDefinition = generateAngularModuleForComponent(cmpMeta.tagName);
         const componentTypeDefinition = createComponentTypeDefinition(outputType, tagNameAsPascal, cmpMeta.events, componentCorePackage, customElementsDir);
         proxyFileOutput.push(componentDefinition, '\n');

package/dist/types.d.ts

@@ -27,6 +27,12 @@ export interface OutputTargetAngular {
      * - `standalone` - Generate a component with the `standalone` flag set to `true`.
      */
     outputType?: OutputType;
+    /**
+     * Experimental (!)
+     * When true, tries to inline the properties of components. This is required to enable Angular Language Service
+     * to type-check and show jsdocs when using the components in html-templates.
+     */
+    inlineProperties?: boolean;
 }
 export type ValueAccessorTypes = 'text' | 'radio' | 'select' | 'number' | 'boolean';
 export interface ValueAccessorConfig {

package/package.json

@@ -1,9 +1,16 @@
 {
   "name": "@stencil/angular-output-target",
-  "version": "0.9.1",
+  "version": "0.10.1",
   "description": "Angular output target for @stencil/core components.",
   "main": "dist/index.cjs.js",
   "module": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs.js"
+    }
+  },
   "types": "dist/index.d.ts",
   "files": [
     "dist/",
@@ -27,8 +34,8 @@
     "prettier.base": "prettier \"./({angular-component-lib,src,test,__tests__}/**/*.{ts,tsx,js,jsx})|*.{ts,tsx,js,jsx}\"",
     "prettier.dry-run": "pnpm run prettier.base --list-different",
     "release": "np",
-    "test": "jest --passWithNoTests",
-    "test.watch": "jest --watch"
+    "test": "vitest --run",
+    "test.watch": "vitest"
   },
   "repository": {
     "type": "git",
@@ -44,29 +51,14 @@
     "@angular/core": "8.2.14",
     "@angular/forms": "8.2.14",
     "@types/node": "^18.0.0",
-    "jest": "^27.0.0",
-    "jest-environment-jsdom": "^27.0.0",
     "npm-run-all2": "^6.2.4",
     "rimraf": "^5.0.0",
     "rollup": "^2.23.1",
-    "typescript": "~5.0.4"
+    "typescript": "~5.7.0",
+    "vitest": "^2.1.4"
   },
   "peerDependencies": {
     "@stencil/core": ">=2.0.0 || >=3 || >= 4.0.0-beta.0 || >= 4.0.0"
   },
-  "jest": {
-    "transform": {
-      "^.+\\.(js|ts|tsx)$": "<rootDir>/test/jest.preprocessor.js"
-    },
-    "testRegex": "(\\.(test|spec))\\.(ts?|tsx?|jsx?)$",
-    "moduleFileExtensions": [
-      "ts",
-      "tsx",
-      "js",
-      "json",
-      "jsx"
-    ],
-    "testURL": "http://localhost"
-  },
   "gitHead": "a3588e905186a0e86e7f88418fd5b2f9531b55e0"
 }

package/resources/control-value-accessors/boolean-value-accessor.ts

@@ -21,7 +21,7 @@ export class BooleanValueAccessor extends ValueAccessor {
   constructor(el: ElementRef) {
     super(el);
   }
-  writeValue(value: any) {
+  override writeValue(value: any) {
     this.el.nativeElement.checked = this.lastValue = value == null ? false : value;
   }
 }

package/resources/control-value-accessors/number-value-accessor.ts

@@ -21,7 +21,7 @@ export class NumericValueAccessor extends ValueAccessor {
   constructor(el: ElementRef) {
     super(el);
   }
-  registerOnChange(fn: (_: number | null) => void) {
+  override registerOnChange(fn: (_: number | null) => void) {
     super.registerOnChange(value => {
       fn(value === '' ? null : parseFloat(value));
     });