improve

Author: baseballyama

docs/rules/no-unused-props.md

@@ -167,9 +167,9 @@ Note: Properties of class types are not checked for usage, as they might be used
 }
 ```
 
-- `checkImportedTypes` ... Controls whether to check properties from imported types. Default is `false`.
-- `ignoreTypePatterns` ... Patterns to ignore when checking property types. Default is `[]` (no types are ignored by default). This option can be used to exclude certain types from being checked for unused properties, which is useful for utility or internal types.
-- `ignorePropertyPatterns` ... Patterns to ignore when checking for unused props. Default is `[]` (no properties are ignored by default). This option can be used to ignore properties starting with special characters often used for internal or framework-specific identifiers.
+- `checkImportedTypes` ... Controls whether to check properties from types defined in external files. Default is `false`, meaning the rule only checks types defined within the component file itself. When set to `true`, the rule will also check properties from imported and extended types.
+- `ignoreTypePatterns` ... Regular expression patterns for type names to exclude from checks. Default is `[]` (no exclusions). Most useful when `checkImportedTypes` is `true`, allowing you to exclude specific imported types (like utility types or third-party types) from being checked.
+- `ignorePropertyPatterns` ... Regular expression patterns for property names to exclude from unused checks. Default is `[]` (no exclusions). Most useful when `checkImportedTypes` is `true`, allowing you to ignore specific properties from external types that shouldn't trigger warnings.
 
 Examples:
 

packages/eslint-plugin-svelte/tests/fixtures/rules/no-unused-props/invalid/custom-config-combination-config.json

@@ -0,0 +1,9 @@
+{
+	"options": [
+		{
+			"checkImportedTypes": true,
+			"ignoreTypePatterns": ["BaseProps"],
+			"ignorePropertyPatterns": ["/^(_|baz)/"]
+		}
+	]
+}

packages/eslint-plugin-svelte/tests/fixtures/rules/no-unused-props/invalid/custom-config-combination-errors.yaml

@@ -0,0 +1,12 @@
+- message: "'base' is an unused Props property."
+  line: 10
+  column: 6
+  suggestions: null
+- message: "'bar' in 'my_foo' is an unused property."
+  line: 10
+  column: 6
+  suggestions: null
+- message: "'qux' is an unused Props property."
+  line: 10
+  column: 6
+  suggestions: null

packages/eslint-plugin-svelte/tests/fixtures/rules/no-unused-props/invalid/custom-config-combination-input.svelte

@@ -0,0 +1,12 @@
+<script lang="ts">
+	import type { BaseProps, FooDTO } from './shared-types';
+	interface Props {
+		base: BaseProps;
+		my_foo: FooDTO;
+		_my_bar: string;
+		baz: string;
+		qux: string;
+	}
+	let { my_foo }: Props = $props();
+	console.log(my_foo.foo);
+</script>

packages/eslint-plugin-svelte/tests/fixtures/rules/no-unused-props/valid/custom-config-combination-config.json

@@ -0,0 +1,9 @@
+{
+	"options": [
+		{
+			"checkImportedTypes": true,
+			"ignoreTypePatterns": ["BaseProps"],
+			"ignorePropertyPatterns": ["/^(_|baz)/"]
+		}
+	]
+}

packages/eslint-plugin-svelte/tests/fixtures/rules/no-unused-props/valid/custom-config-combination-input.svelte

@@ -0,0 +1,11 @@
+<script lang="ts">
+	import type { BaseProps, FooDTO } from './shared-types';
+	interface Props {
+		base: BaseProps;
+		my_foo: FooDTO;
+		_my_bar: string;
+		baz: string;
+	}
+	let { base, my_foo }: Props = $props();
+	console.log(base.age, my_foo.foo, my_foo.bar);
+</script>

packages/eslint-plugin-svelte/tests/fixtures/rules/no-unused-props/valid/shared-types.ts

@@ -1,5 +1,6 @@
 export interface BaseProps {
 	name: string;
+	age: number;
 }
 
 export interface FooDTO {