@subconverter/core 0.2.1 → 0.3.0

package/dist/index.d.cts

@@ -228,15 +228,22 @@ interface ExtraSettings {
     nameRemove: string[];
     addEmoji: boolean;
     removeEmoji: boolean;
-    /** Prefix node names with the server's country/region when the name lacks one. */
+    /** Prefix node names with the server's ISO country code when the name lacks one. */
     autoCountry: boolean;
-    /** Locale used for `Intl.DisplayNames` country names (default `zh-CN`). */
-    countryLocale: string;
     /**
      * Resolve a node's ISO 3166-1 alpha-2 country code. Platform-free: the Node
      * adapter supplies a GeoIP-backed lookup; browsers may supply their own.
+     * Required by `autoCountry` and the country filters below.
      */
     countryResolver?: (node: Proxy) => string | undefined;
+    /** Keep only nodes whose GeoIP country is in this ISO code list. */
+    includeCountries: string[];
+    /** Drop nodes whose GeoIP country is in this ISO code list. */
+    excludeCountries: string[];
+    /** Keep only nodes matching one of these remark rules (empty keeps all). */
+    includeRemarks: string[];
+    /** Drop nodes matching one of these remark rules. */
+    excludeRemarks: string[];
     appendProxyType: boolean;
     nodeList: boolean;
     sortFlag: boolean;
@@ -273,6 +280,10 @@ interface RequestSettings {
     nameRemove: string[];
     includeRemarks: string[];
     excludeRemarks: string[];
+    /** Keep only nodes whose GeoIP country is in this ISO code list. */
+    includeCountries: string[];
+    /** Drop nodes whose GeoIP country is in this ISO code list. */
+    excludeCountries: string[];
     addEmoji: boolean;
     removeEmoji: boolean;
     autoCountry: boolean;
@@ -459,6 +470,8 @@ interface ExternalConfig {
     nameRemove: string[];
     includeRemarks: string[];
     excludeRemarks: string[];
+    includeCountries: string[];
+    excludeCountries: string[];
     addEmoji: boolean;
     removeEmoji: boolean;
     autoCountry: boolean;
@@ -1128,13 +1141,19 @@ declare function nodeNameRemove(node: Proxy, removeList: string[]): void;
 /** Apply rename rules to a node's remark (script rules are ignored). */
 declare function nodeRename(node: Proxy, renameArray: RegexMatchConfig[]): void;
 /**
- * Prefix a node's remark with its server country/region when the remark does
- * not already mention one (e.g. `server1` -> `美国-server1`).
+ * Prefix a node's remark with its ISO server country when the remark does
+ * not already mention one (e.g. `server1` -> `US-server1`).
  *
  * `resolve` returns an ISO 3166-1 alpha-2 code; a missing/unknown code leaves
  * the remark untouched. Mirrors the request `auto_country` switch.
  */
-declare function addCountryPrefix(node: Proxy, resolve: (node: Proxy) => string | undefined, locale?: string): string;
+declare function addCountryPrefix(node: Proxy, resolve: (node: Proxy) => string | undefined): string;
+/**
+ * Drop nodes by GeoIP country: keep only `include` codes (unknown countries
+ * never match, so they are dropped), then drop `exclude` codes (unknown
+ * countries are kept). Invalid codes are ignored.
+ */
+declare function filterNodesByCountry(nodes: Proxy[], resolve: ((node: Proxy) => string | undefined) | undefined, include: string[], exclude: string[]): void;
 interface PreprocessOptions {
     removeEmoji: boolean;
     addEmoji: boolean;
@@ -1146,8 +1165,15 @@ interface PreprocessOptions {
     /** Literal fragments stripped from names before every other naming rule. */
     nameRemove?: string[];
     autoCountry?: boolean;
-    countryLocale?: string;
     countryResolver?: (node: Proxy) => string | undefined;
+    /** Keep only nodes whose GeoIP country is in this ISO code list. */
+    includeCountries?: string[];
+    /** Drop nodes whose GeoIP country is in this ISO code list. */
+    excludeCountries?: string[];
+    /** Keep only nodes matching one of these remark rules (empty keeps all). */
+    includeRemarks?: string[];
+    /** Drop nodes matching one of these remark rules. */
+    excludeRemarks?: string[];
 }
 /** Apply name cleanup, emoji removal, renaming, emoji insertion, and optional sorting. */
 declare function preprocessNodes(nodes: Proxy[], options: PreprocessOptions): void;
@@ -1155,16 +1181,18 @@ declare function preprocessNodes(nodes: Proxy[], options: PreprocessOptions): vo
 declare function dedupeNodes(nodes: Proxy[]): number;
 
 /**
- * ISO 3166-1 alpha-2 region helpers used when a proxy name has no country.
+ * ISO 3166-1 alpha-2 region helpers.
  *
- * The display names come from `Intl.DisplayNames` (no bundled database), with
- * small overrides where the CLDR Chinese name is too verbose for a node name
- * (e.g. `中国香港特别行政区` -> `香港`). Flag emoji are derived from the code.
+ * Emitted prefixes are always the uppercase ISO code (`US-server1`) so node
+ * names stay stable across locales. Multilingual names (Chinese/English
+ * spellings, flag emoji) are only recognized by `hasRegionName` so existing
+ * names are never double-prefixed.
+ */
+/**
+ * Normalize user input to an ISO 3166-1 alpha-2 code (`"us"` -> `"US"`),
+ * or `undefined` when it is not a known region. Used for country filters.
  */
-/** Localized country/region name (e.g. `美国`), falling back to the code. */
-declare function regionDisplayName(code: string, locale?: string): string;
-/** Flag emoji for a region code, or `""` when the code is invalid. */
-declare function regionFlag(code: string): string;
+declare function normalizeCountryCode(code: string): string | undefined;
 /** `true` when the code is a known ISO 3166-1 alpha-2 region. */
 declare function isRegionCode(code: string): boolean;
 /**
@@ -1174,9 +1202,10 @@ declare function isRegionCode(code: string): boolean;
  */
 declare function hasRegionName(remark: string): boolean;
 /**
- * Prepend `name-` to a node remark (e.g. `server1` -> `美国-server1`).
- * An empty remark becomes just the country name.
+ * Prefix a remark with the ISO country code (e.g. `server1` -> `US-server1`).
+ * An empty remark becomes just the code. Invalid codes leave the remark
+ * unchanged.
  */
-declare function formatCountryRemark(remark: string, code: string, locale?: string): string;
+declare function formatCountryRemark(remark: string, code: string): string;
 
-export { BalanceStrategy, CLASH_RULE_TYPES, DEFAULT_GROUPS, type ExternalConfig, type ExtraSettings, type GenerateOptions, type IniDocument, type IniSection, type LoonOptions, type MellowOptions, type Proxy, type ProxyGroupConfig, ProxyGroupType, ProxyType, QUANX_RULE_TYPES, type QuanOptions, type QuanxOptions, type RawIniSection, type RegexMatchConfig, type RequestSettings, type RulesetConfig, type RulesetContent, RulesetType, SING_BOX_RULE_TYPES, SSR_CIPHERS, SS_CIPHERS, SURF_RULE_TYPES, SURGE2_RULE_TYPES, SURGE_RULE_TYPES, type SingBoxOptions, type SingBoxRoute, type SurfboardOptions, type SurgeRulesetResult, TargetFormat, type TemplateVars, type TriBool, type UserinfoData, type UserinfoProvider, addCountryPrefix, addEmoji, anyTlsConstruct, applyMatcher, base64Decode, base64Encode, buildClash, checkIgnore, convertRuleset, convertUserinfo, countOccurrences, createExtraSettings, createProxy, createProxyGroupConfig, createRequestSettings, createRulesetConfig, createSelectGroup, dedupeNodes, explode, explodeAnyTls, explodeClash, explodeHttp, explodeHttpSub, explodeHysteria2, explodeKitsunebi, explodeNetch, explodeNetchConf, explodeQuan, explodeShadowrocket, explodeSocks, explodeSs, explodeSsAndroid, explodeSsConf, explodeSsd, explodeSsr, explodeSsrConf, explodeSstap, explodeStdVmess, explodeSub, explodeSurge, explodeTrojan, explodeTuic, explodeVless, explodeVmess, explodeVmessConf, filterNodes, findSection, fnv1a64, fnv1a64Hex, formatCountryRemark, formatSingBoxInterval, formatSubscriptionUserinfo, generate, generatePeer, getAllUrlArgs, getDefaultProxyGroups, getDefaultRulesetConfigs, getDefaultRulesets, getSectionItems, getUrlArg, groupGenerate, hasRegionName, hasTemplatePlaceholders, httpConstruct, hysteria2Construct, hysteriaConstruct, inferUserinfoProviderFromUrl, isBlank, isFlattenableSsr, isIp, isIpv4, isIpv6, isLink, isRegionCode, isSsCipher, matchRange, nextMonthlyResetTimestamp, nodeNameRegex, nodeNameRemove, nodeRename, normalizeQueryKey, normalizeUserinfoProvider, pad2, parseClashText, parseConfContent, parseCustomProxyGroup, parseExternalConfig, parseGroupTimes, parseIni, parseJmsUserinfo, parseLink, parsePeers, parseProxyGroupType, parseRawIni, parseRegexMatch, parseRequestSettings, parseRulesetConfig, parseSubscription, parseSubscriptionUserinfo, parseTriBool, preprocessNodes, processRemark, proxyToSingle, proxyToSsSub, proxyToSsd, proxyTypeName, queryBoolFlag, regMatch, regReplace, regionDisplayName, regionFlag, removeEmoji, renderRawIni, renderTemplate, replaceAllDistinct, resolveNewFieldName, rulesetToClashRules, rulesetToSingBoxRules, rulesetToSurgeRules, runPreprocess, setRawSection, snellConstruct, socksConstruct, split, splitUrl, ssConstruct, ssLinkConstruct, ssrConstruct, ssrLinkConstruct, startsWith, strFind, stringifyClash, stripScheme, templateVariableNames, toBool, toClash, toInt, toLoon, toMellow, toQuan, toQuanX, toSingBox, toSip008, toSurfboard, toSurge, transformRuleToCommon, triBoolOr, trim, trimLowerCase, trojanConstruct, trojanLinkConstruct, tryBase64Decode, tuicConstruct, urlDecode, urlEncode, urlSafeBase64Decode, urlSafeBase64Encode, utf8Decode, utf8Encode, vlessConstruct, vmessConstruct, vmessLinkConstruct, wireGuardConstruct };
+export { BalanceStrategy, CLASH_RULE_TYPES, DEFAULT_GROUPS, type ExternalConfig, type ExtraSettings, type GenerateOptions, type IniDocument, type IniSection, type LoonOptions, type MellowOptions, type Proxy, type ProxyGroupConfig, ProxyGroupType, ProxyType, QUANX_RULE_TYPES, type QuanOptions, type QuanxOptions, type RawIniSection, type RegexMatchConfig, type RequestSettings, type RulesetConfig, type RulesetContent, RulesetType, SING_BOX_RULE_TYPES, SSR_CIPHERS, SS_CIPHERS, SURF_RULE_TYPES, SURGE2_RULE_TYPES, SURGE_RULE_TYPES, type SingBoxOptions, type SingBoxRoute, type SurfboardOptions, type SurgeRulesetResult, TargetFormat, type TemplateVars, type TriBool, type UserinfoData, type UserinfoProvider, addCountryPrefix, addEmoji, anyTlsConstruct, applyMatcher, base64Decode, base64Encode, buildClash, checkIgnore, convertRuleset, convertUserinfo, countOccurrences, createExtraSettings, createProxy, createProxyGroupConfig, createRequestSettings, createRulesetConfig, createSelectGroup, dedupeNodes, explode, explodeAnyTls, explodeClash, explodeHttp, explodeHttpSub, explodeHysteria2, explodeKitsunebi, explodeNetch, explodeNetchConf, explodeQuan, explodeShadowrocket, explodeSocks, explodeSs, explodeSsAndroid, explodeSsConf, explodeSsd, explodeSsr, explodeSsrConf, explodeSstap, explodeStdVmess, explodeSub, explodeSurge, explodeTrojan, explodeTuic, explodeVless, explodeVmess, explodeVmessConf, filterNodes, filterNodesByCountry, findSection, fnv1a64, fnv1a64Hex, formatCountryRemark, formatSingBoxInterval, formatSubscriptionUserinfo, generate, generatePeer, getAllUrlArgs, getDefaultProxyGroups, getDefaultRulesetConfigs, getDefaultRulesets, getSectionItems, getUrlArg, groupGenerate, hasRegionName, hasTemplatePlaceholders, httpConstruct, hysteria2Construct, hysteriaConstruct, inferUserinfoProviderFromUrl, isBlank, isFlattenableSsr, isIp, isIpv4, isIpv6, isLink, isRegionCode, isSsCipher, matchRange, nextMonthlyResetTimestamp, nodeNameRegex, nodeNameRemove, nodeRename, normalizeCountryCode, normalizeQueryKey, normalizeUserinfoProvider, pad2, parseClashText, parseConfContent, parseCustomProxyGroup, parseExternalConfig, parseGroupTimes, parseIni, parseJmsUserinfo, parseLink, parsePeers, parseProxyGroupType, parseRawIni, parseRegexMatch, parseRequestSettings, parseRulesetConfig, parseSubscription, parseSubscriptionUserinfo, parseTriBool, preprocessNodes, processRemark, proxyToSingle, proxyToSsSub, proxyToSsd, proxyTypeName, queryBoolFlag, regMatch, regReplace, removeEmoji, renderRawIni, renderTemplate, replaceAllDistinct, resolveNewFieldName, rulesetToClashRules, rulesetToSingBoxRules, rulesetToSurgeRules, runPreprocess, setRawSection, snellConstruct, socksConstruct, split, splitUrl, ssConstruct, ssLinkConstruct, ssrConstruct, ssrLinkConstruct, startsWith, strFind, stringifyClash, stripScheme, templateVariableNames, toBool, toClash, toInt, toLoon, toMellow, toQuan, toQuanX, toSingBox, toSip008, toSurfboard, toSurge, transformRuleToCommon, triBoolOr, trim, trimLowerCase, trojanConstruct, trojanLinkConstruct, tryBase64Decode, tuicConstruct, urlDecode, urlEncode, urlSafeBase64Decode, urlSafeBase64Encode, utf8Decode, utf8Encode, vlessConstruct, vmessConstruct, vmessLinkConstruct, wireGuardConstruct };

package/dist/index.d.ts

@@ -228,15 +228,22 @@ interface ExtraSettings {
     nameRemove: string[];
     addEmoji: boolean;
     removeEmoji: boolean;
-    /** Prefix node names with the server's country/region when the name lacks one. */
+    /** Prefix node names with the server's ISO country code when the name lacks one. */
     autoCountry: boolean;
-    /** Locale used for `Intl.DisplayNames` country names (default `zh-CN`). */
-    countryLocale: string;
     /**
      * Resolve a node's ISO 3166-1 alpha-2 country code. Platform-free: the Node
      * adapter supplies a GeoIP-backed lookup; browsers may supply their own.
+     * Required by `autoCountry` and the country filters below.
      */
     countryResolver?: (node: Proxy) => string | undefined;
+    /** Keep only nodes whose GeoIP country is in this ISO code list. */
+    includeCountries: string[];
+    /** Drop nodes whose GeoIP country is in this ISO code list. */
+    excludeCountries: string[];
+    /** Keep only nodes matching one of these remark rules (empty keeps all). */
+    includeRemarks: string[];
+    /** Drop nodes matching one of these remark rules. */
+    excludeRemarks: string[];
     appendProxyType: boolean;
     nodeList: boolean;
     sortFlag: boolean;
@@ -273,6 +280,10 @@ interface RequestSettings {
     nameRemove: string[];
     includeRemarks: string[];
     excludeRemarks: string[];
+    /** Keep only nodes whose GeoIP country is in this ISO code list. */
+    includeCountries: string[];
+    /** Drop nodes whose GeoIP country is in this ISO code list. */
+    excludeCountries: string[];
     addEmoji: boolean;
     removeEmoji: boolean;
     autoCountry: boolean;
@@ -459,6 +470,8 @@ interface ExternalConfig {
     nameRemove: string[];
     includeRemarks: string[];
     excludeRemarks: string[];
+    includeCountries: string[];
+    excludeCountries: string[];
     addEmoji: boolean;
     removeEmoji: boolean;
     autoCountry: boolean;
@@ -1128,13 +1141,19 @@ declare function nodeNameRemove(node: Proxy, removeList: string[]): void;
 /** Apply rename rules to a node's remark (script rules are ignored). */
 declare function nodeRename(node: Proxy, renameArray: RegexMatchConfig[]): void;
 /**
- * Prefix a node's remark with its server country/region when the remark does
- * not already mention one (e.g. `server1` -> `美国-server1`).
+ * Prefix a node's remark with its ISO server country when the remark does
+ * not already mention one (e.g. `server1` -> `US-server1`).
  *
  * `resolve` returns an ISO 3166-1 alpha-2 code; a missing/unknown code leaves
  * the remark untouched. Mirrors the request `auto_country` switch.
  */
-declare function addCountryPrefix(node: Proxy, resolve: (node: Proxy) => string | undefined, locale?: string): string;
+declare function addCountryPrefix(node: Proxy, resolve: (node: Proxy) => string | undefined): string;
+/**
+ * Drop nodes by GeoIP country: keep only `include` codes (unknown countries
+ * never match, so they are dropped), then drop `exclude` codes (unknown
+ * countries are kept). Invalid codes are ignored.
+ */
+declare function filterNodesByCountry(nodes: Proxy[], resolve: ((node: Proxy) => string | undefined) | undefined, include: string[], exclude: string[]): void;
 interface PreprocessOptions {
     removeEmoji: boolean;
     addEmoji: boolean;
@@ -1146,8 +1165,15 @@ interface PreprocessOptions {
     /** Literal fragments stripped from names before every other naming rule. */
     nameRemove?: string[];
     autoCountry?: boolean;
-    countryLocale?: string;
     countryResolver?: (node: Proxy) => string | undefined;
+    /** Keep only nodes whose GeoIP country is in this ISO code list. */
+    includeCountries?: string[];
+    /** Drop nodes whose GeoIP country is in this ISO code list. */
+    excludeCountries?: string[];
+    /** Keep only nodes matching one of these remark rules (empty keeps all). */
+    includeRemarks?: string[];
+    /** Drop nodes matching one of these remark rules. */
+    excludeRemarks?: string[];
 }
 /** Apply name cleanup, emoji removal, renaming, emoji insertion, and optional sorting. */
 declare function preprocessNodes(nodes: Proxy[], options: PreprocessOptions): void;
@@ -1155,16 +1181,18 @@ declare function preprocessNodes(nodes: Proxy[], options: PreprocessOptions): vo
 declare function dedupeNodes(nodes: Proxy[]): number;
 
 /**
- * ISO 3166-1 alpha-2 region helpers used when a proxy name has no country.
+ * ISO 3166-1 alpha-2 region helpers.
  *
- * The display names come from `Intl.DisplayNames` (no bundled database), with
- * small overrides where the CLDR Chinese name is too verbose for a node name
- * (e.g. `中国香港特别行政区` -> `香港`). Flag emoji are derived from the code.
+ * Emitted prefixes are always the uppercase ISO code (`US-server1`) so node
+ * names stay stable across locales. Multilingual names (Chinese/English
+ * spellings, flag emoji) are only recognized by `hasRegionName` so existing
+ * names are never double-prefixed.
+ */
+/**
+ * Normalize user input to an ISO 3166-1 alpha-2 code (`"us"` -> `"US"`),
+ * or `undefined` when it is not a known region. Used for country filters.
  */
-/** Localized country/region name (e.g. `美国`), falling back to the code. */
-declare function regionDisplayName(code: string, locale?: string): string;
-/** Flag emoji for a region code, or `""` when the code is invalid. */
-declare function regionFlag(code: string): string;
+declare function normalizeCountryCode(code: string): string | undefined;
 /** `true` when the code is a known ISO 3166-1 alpha-2 region. */
 declare function isRegionCode(code: string): boolean;
 /**
@@ -1174,9 +1202,10 @@ declare function isRegionCode(code: string): boolean;
  */
 declare function hasRegionName(remark: string): boolean;
 /**
- * Prepend `name-` to a node remark (e.g. `server1` -> `美国-server1`).
- * An empty remark becomes just the country name.
+ * Prefix a remark with the ISO country code (e.g. `server1` -> `US-server1`).
+ * An empty remark becomes just the code. Invalid codes leave the remark
+ * unchanged.
  */
-declare function formatCountryRemark(remark: string, code: string, locale?: string): string;
+declare function formatCountryRemark(remark: string, code: string): string;
 
-export { BalanceStrategy, CLASH_RULE_TYPES, DEFAULT_GROUPS, type ExternalConfig, type ExtraSettings, type GenerateOptions, type IniDocument, type IniSection, type LoonOptions, type MellowOptions, type Proxy, type ProxyGroupConfig, ProxyGroupType, ProxyType, QUANX_RULE_TYPES, type QuanOptions, type QuanxOptions, type RawIniSection, type RegexMatchConfig, type RequestSettings, type RulesetConfig, type RulesetContent, RulesetType, SING_BOX_RULE_TYPES, SSR_CIPHERS, SS_CIPHERS, SURF_RULE_TYPES, SURGE2_RULE_TYPES, SURGE_RULE_TYPES, type SingBoxOptions, type SingBoxRoute, type SurfboardOptions, type SurgeRulesetResult, TargetFormat, type TemplateVars, type TriBool, type UserinfoData, type UserinfoProvider, addCountryPrefix, addEmoji, anyTlsConstruct, applyMatcher, base64Decode, base64Encode, buildClash, checkIgnore, convertRuleset, convertUserinfo, countOccurrences, createExtraSettings, createProxy, createProxyGroupConfig, createRequestSettings, createRulesetConfig, createSelectGroup, dedupeNodes, explode, explodeAnyTls, explodeClash, explodeHttp, explodeHttpSub, explodeHysteria2, explodeKitsunebi, explodeNetch, explodeNetchConf, explodeQuan, explodeShadowrocket, explodeSocks, explodeSs, explodeSsAndroid, explodeSsConf, explodeSsd, explodeSsr, explodeSsrConf, explodeSstap, explodeStdVmess, explodeSub, explodeSurge, explodeTrojan, explodeTuic, explodeVless, explodeVmess, explodeVmessConf, filterNodes, findSection, fnv1a64, fnv1a64Hex, formatCountryRemark, formatSingBoxInterval, formatSubscriptionUserinfo, generate, generatePeer, getAllUrlArgs, getDefaultProxyGroups, getDefaultRulesetConfigs, getDefaultRulesets, getSectionItems, getUrlArg, groupGenerate, hasRegionName, hasTemplatePlaceholders, httpConstruct, hysteria2Construct, hysteriaConstruct, inferUserinfoProviderFromUrl, isBlank, isFlattenableSsr, isIp, isIpv4, isIpv6, isLink, isRegionCode, isSsCipher, matchRange, nextMonthlyResetTimestamp, nodeNameRegex, nodeNameRemove, nodeRename, normalizeQueryKey, normalizeUserinfoProvider, pad2, parseClashText, parseConfContent, parseCustomProxyGroup, parseExternalConfig, parseGroupTimes, parseIni, parseJmsUserinfo, parseLink, parsePeers, parseProxyGroupType, parseRawIni, parseRegexMatch, parseRequestSettings, parseRulesetConfig, parseSubscription, parseSubscriptionUserinfo, parseTriBool, preprocessNodes, processRemark, proxyToSingle, proxyToSsSub, proxyToSsd, proxyTypeName, queryBoolFlag, regMatch, regReplace, regionDisplayName, regionFlag, removeEmoji, renderRawIni, renderTemplate, replaceAllDistinct, resolveNewFieldName, rulesetToClashRules, rulesetToSingBoxRules, rulesetToSurgeRules, runPreprocess, setRawSection, snellConstruct, socksConstruct, split, splitUrl, ssConstruct, ssLinkConstruct, ssrConstruct, ssrLinkConstruct, startsWith, strFind, stringifyClash, stripScheme, templateVariableNames, toBool, toClash, toInt, toLoon, toMellow, toQuan, toQuanX, toSingBox, toSip008, toSurfboard, toSurge, transformRuleToCommon, triBoolOr, trim, trimLowerCase, trojanConstruct, trojanLinkConstruct, tryBase64Decode, tuicConstruct, urlDecode, urlEncode, urlSafeBase64Decode, urlSafeBase64Encode, utf8Decode, utf8Encode, vlessConstruct, vmessConstruct, vmessLinkConstruct, wireGuardConstruct };
+export { BalanceStrategy, CLASH_RULE_TYPES, DEFAULT_GROUPS, type ExternalConfig, type ExtraSettings, type GenerateOptions, type IniDocument, type IniSection, type LoonOptions, type MellowOptions, type Proxy, type ProxyGroupConfig, ProxyGroupType, ProxyType, QUANX_RULE_TYPES, type QuanOptions, type QuanxOptions, type RawIniSection, type RegexMatchConfig, type RequestSettings, type RulesetConfig, type RulesetContent, RulesetType, SING_BOX_RULE_TYPES, SSR_CIPHERS, SS_CIPHERS, SURF_RULE_TYPES, SURGE2_RULE_TYPES, SURGE_RULE_TYPES, type SingBoxOptions, type SingBoxRoute, type SurfboardOptions, type SurgeRulesetResult, TargetFormat, type TemplateVars, type TriBool, type UserinfoData, type UserinfoProvider, addCountryPrefix, addEmoji, anyTlsConstruct, applyMatcher, base64Decode, base64Encode, buildClash, checkIgnore, convertRuleset, convertUserinfo, countOccurrences, createExtraSettings, createProxy, createProxyGroupConfig, createRequestSettings, createRulesetConfig, createSelectGroup, dedupeNodes, explode, explodeAnyTls, explodeClash, explodeHttp, explodeHttpSub, explodeHysteria2, explodeKitsunebi, explodeNetch, explodeNetchConf, explodeQuan, explodeShadowrocket, explodeSocks, explodeSs, explodeSsAndroid, explodeSsConf, explodeSsd, explodeSsr, explodeSsrConf, explodeSstap, explodeStdVmess, explodeSub, explodeSurge, explodeTrojan, explodeTuic, explodeVless, explodeVmess, explodeVmessConf, filterNodes, filterNodesByCountry, findSection, fnv1a64, fnv1a64Hex, formatCountryRemark, formatSingBoxInterval, formatSubscriptionUserinfo, generate, generatePeer, getAllUrlArgs, getDefaultProxyGroups, getDefaultRulesetConfigs, getDefaultRulesets, getSectionItems, getUrlArg, groupGenerate, hasRegionName, hasTemplatePlaceholders, httpConstruct, hysteria2Construct, hysteriaConstruct, inferUserinfoProviderFromUrl, isBlank, isFlattenableSsr, isIp, isIpv4, isIpv6, isLink, isRegionCode, isSsCipher, matchRange, nextMonthlyResetTimestamp, nodeNameRegex, nodeNameRemove, nodeRename, normalizeCountryCode, normalizeQueryKey, normalizeUserinfoProvider, pad2, parseClashText, parseConfContent, parseCustomProxyGroup, parseExternalConfig, parseGroupTimes, parseIni, parseJmsUserinfo, parseLink, parsePeers, parseProxyGroupType, parseRawIni, parseRegexMatch, parseRequestSettings, parseRulesetConfig, parseSubscription, parseSubscriptionUserinfo, parseTriBool, preprocessNodes, processRemark, proxyToSingle, proxyToSsSub, proxyToSsd, proxyTypeName, queryBoolFlag, regMatch, regReplace, removeEmoji, renderRawIni, renderTemplate, replaceAllDistinct, resolveNewFieldName, rulesetToClashRules, rulesetToSingBoxRules, rulesetToSurgeRules, runPreprocess, setRawSection, snellConstruct, socksConstruct, split, splitUrl, ssConstruct, ssLinkConstruct, ssrConstruct, ssrLinkConstruct, startsWith, strFind, stringifyClash, stripScheme, templateVariableNames, toBool, toClash, toInt, toLoon, toMellow, toQuan, toQuanX, toSingBox, toSip008, toSurfboard, toSurge, transformRuleToCommon, triBoolOr, trim, trimLowerCase, trojanConstruct, trojanLinkConstruct, tryBase64Decode, tuicConstruct, urlDecode, urlEncode, urlSafeBase64Decode, urlSafeBase64Encode, utf8Decode, utf8Encode, vlessConstruct, vmessConstruct, vmessLinkConstruct, wireGuardConstruct };

package/dist/index.js

@@ -251,12 +251,15 @@ function createExtraSettings() {
     clashProxiesStyle: "flow",
     clashProxyGroupsStyle: "flow",
     clashScript: false,
-    countryLocale: "zh-CN",
     countryResolver: void 0,
     dedupe: false,
     emojiArray: [],
     enableRuleGenerator: true,
+    excludeCountries: [],
+    excludeRemarks: [],
     filterDeprecated: false,
+    includeCountries: [],
+    includeRemarks: [],
     managedConfigPrefix: "",
     nameRegexArray: [],
     nameRemove: [],
@@ -742,8 +745,10 @@ function parseExternalConfig(content) {
     baseFiles: {},
     emoji: [],
     enableRuleGenerator: true,
+    excludeCountries: [],
     excludeRemarks: [],
     groups: [],
+    includeCountries: [],
     includeRemarks: [],
     nameRegex: [],
     nameRemove: [],
@@ -812,6 +817,22 @@ function parseExternalConfig(content) {
             result.includeRemarks.push(value);
           }
           break;
+        case "include_country":
+          for (const fragment of value.split(",")) {
+            const trimmed = fragment.trim().toUpperCase();
+            if (trimmed !== "") {
+              result.includeCountries.push(trimmed);
+            }
+          }
+          break;
+        case "exclude_country":
+          for (const fragment of value.split(",")) {
+            const trimmed = fragment.trim().toUpperCase();
+            if (trimmed !== "") {
+              result.excludeCountries.push(trimmed);
+            }
+          }
+          break;
         case "exclude_remarks":
         case "exclude":
           if (value !== "") {
@@ -866,6 +887,9 @@ function listArg(query, key) {
   const value = getUrlArg(query, key);
   return value === "" ? [] : value.split(",");
 }
+function countryListArg(query, key) {
+  return getAllUrlArgs(query, key).flatMap((raw) => raw.split(",")).map((raw) => raw.trim().toUpperCase()).filter((raw) => raw !== "");
+}
 function resolveNewFieldName(query) {
   if (boolArg(query, "legacy") || boolArg(query, "legacy_field_name") || boolArg(query, "legacy-field-name")) {
     return false;
@@ -908,9 +932,11 @@ function createRequestSettings() {
     classicalRuleset: false,
     dedupe: false,
     emoji: [],
+    excludeCountries: [],
     excludeRemarks: [],
     filterDeprecated: false,
     group: [],
+    includeCountries: [],
     includeRemarks: [],
     insert: false,
     interval: 0,
@@ -971,6 +997,8 @@ function parseRequestSettings(query) {
   settings.proxyGroupsStyle = getUrlArg(query, "proxy_groups_style") || "flow";
   settings.includeRemarks = listArg(query, "include");
   settings.excludeRemarks = listArg(query, "exclude");
+  settings.includeCountries = countryListArg(query, "include_country");
+  settings.excludeCountries = countryListArg(query, "exclude_country");
   settings.userinfoUrl = firstArg(query, "userinfo_url", "userinfo-url", "userinfo");
   settings.userinfoProvider = firstArg(
     query,
@@ -4916,7 +4944,11 @@ function normalizeRegionCode(code) {
   const upper = code.trim().toUpperCase();
   return /^[A-Z]{2}$/.test(upper) ? upper : "";
 }
-function regionDisplayName(code, locale = "zh-CN") {
+function normalizeCountryCode(code) {
+  const upper = normalizeRegionCode(code);
+  return upper !== "" && isRegionCode(upper) ? upper : void 0;
+}
+function displayName(code, locale) {
   const upper = normalizeRegionCode(code);
   if (upper === "") {
     return code.trim();
@@ -4959,8 +4991,8 @@ function buildAliasRegex() {
     }
   };
   for (const code of REGION_CODES) {
-    add(regionDisplayName(code, "zh-CN"));
-    add(regionDisplayName(code, "en"));
+    add(displayName(code, "zh-CN"));
+    add(displayName(code, "en"));
     add(regionFlag(code));
   }
   for (const alias of EXTRA_ALIASES) {
@@ -5000,13 +5032,13 @@ function hasRegionName(remark) {
   }
   return false;
 }
-function formatCountryRemark(remark, code, locale = "zh-CN") {
-  const name = regionDisplayName(code, locale);
+function formatCountryRemark(remark, code) {
+  const normalized = normalizeCountryCode(code);
   const trimmed = remark.trim();
-  if (name === "") {
+  if (normalized === void 0) {
     return trimmed;
   }
-  return trimmed === "" ? name : `${name}-${trimmed}`;
+  return trimmed === "" ? normalized : `${normalized}-${trimmed}`;
 }
 
 // src/generator/nodes.ts
@@ -5265,7 +5297,7 @@ function nodeRename(node, renameArray) {
     node.remark = original;
   }
 }
-function addCountryPrefix(node, resolve, locale = "zh-CN") {
+function addCountryPrefix(node, resolve) {
   const remark = node.remark.trim();
   if (hasRegionName(remark)) {
     return node.remark;
@@ -5274,7 +5306,31 @@ function addCountryPrefix(node, resolve, locale = "zh-CN") {
   if (code === void 0 || code === "") {
     return node.remark;
   }
-  return formatCountryRemark(remark, code, locale);
+  return formatCountryRemark(remark, code);
+}
+function filterNodesByCountry(nodes, resolve, include, exclude) {
+  const includeSet = new Set(
+    include.map((code) => normalizeCountryCode(code)).filter((code) => code !== void 0)
+  );
+  const excludeSet = new Set(
+    exclude.map((code) => normalizeCountryCode(code)).filter((code) => code !== void 0)
+  );
+  if (includeSet.size === 0 && excludeSet.size === 0) {
+    return;
+  }
+  const kept = [];
+  for (const node of nodes) {
+    const code = resolve ? normalizeCountryCode(resolve(node) ?? "") : void 0;
+    if (includeSet.size > 0 && (code === void 0 || !includeSet.has(code))) {
+      continue;
+    }
+    if (code !== void 0 && excludeSet.has(code)) {
+      continue;
+    }
+    kept.push(node);
+  }
+  nodes.length = 0;
+  nodes.push(...kept);
 }
 function preprocessNodes(nodes, options) {
   for (const node of nodes) {
@@ -5292,13 +5348,25 @@ function preprocessNodes(nodes, options) {
       node.remark = addEmoji(node, options.emojiArray);
     }
     if (options.autoCountry && options.countryResolver) {
-      node.remark = addCountryPrefix(
-        node,
-        options.countryResolver,
-        options.countryLocale ?? "zh-CN"
-      );
+      node.remark = addCountryPrefix(node, options.countryResolver);
     }
   }
+  filterNodesByCountry(
+    nodes,
+    options.countryResolver,
+    options.includeCountries ?? [],
+    options.excludeCountries ?? []
+  );
+  const includeRemarks = options.includeRemarks ?? [];
+  const excludeRemarks = options.excludeRemarks ?? [];
+  if (includeRemarks.length > 0 || excludeRemarks.length > 0) {
+    const kept = nodes.filter((node) => !checkIgnore(node, excludeRemarks, includeRemarks));
+    kept.forEach((node, index) => {
+      node.id = index;
+    });
+    nodes.length = 0;
+    nodes.push(...kept);
+  }
   if (options.sortFlag) {
     nodes.sort((a, b) => a.remark < b.remark ? -1 : a.remark > b.remark ? 1 : 0);
   }
@@ -8184,9 +8252,12 @@ function runPreprocess(nodes, settings) {
   preprocessNodes(nodes, {
     addEmoji: settings.addEmoji,
     autoCountry: settings.autoCountry,
-    countryLocale: settings.countryLocale,
     countryResolver: settings.countryResolver,
     emojiArray: settings.emojiArray,
+    excludeCountries: settings.excludeCountries,
+    excludeRemarks: settings.excludeRemarks,
+    includeCountries: settings.includeCountries,
+    includeRemarks: settings.includeRemarks,
     nameRegexArray: settings.nameRegexArray,
     nameRemove: settings.nameRemove,
     removeEmoji: settings.removeEmoji,
@@ -8388,6 +8459,7 @@ export {
   explodeVmess,
   explodeVmessConf,
   filterNodes,
+  filterNodesByCountry,
   findSection,
   fnv1a64,
   fnv1a64Hex,
@@ -8422,6 +8494,7 @@ export {
   nodeNameRegex,
   nodeNameRemove,
   nodeRename,
+  normalizeCountryCode,
   normalizeQueryKey,
   normalizeUserinfoProvider,
   pad2,
@@ -8451,8 +8524,6 @@ export {
   queryBoolFlag,
   regMatch,
   regReplace,
-  regionDisplayName,
-  regionFlag,
   removeEmoji,
   renderRawIni,
   renderTemplate,