@subconverter/core 0.2.1 → 0.4.0

package/dist/index.d.cts

@@ -189,6 +189,13 @@ interface RulesetContent {
 /** Create a ruleset config with subconverter's defaults. */
 declare function createRulesetConfig(): RulesetConfig;
 
+/** Clash kernel flavor targeted by Clash output (`flavor=`). */
+type ClashFlavor = "mihomo" | "premium" | "stash";
+/**
+ * Parse a `flavor=` value (case-insensitive); unknown values fall back to
+ * `mihomo`, mirroring subconverter-rs `ClashFlavor::from_str`.
+ */
+declare function parseClashFlavor(value: string | undefined | null): ClashFlavor;
 /** A regex/script rewrite rule, mirroring `RegexMatchConfig`. */
 interface RegexMatchConfig {
     match: string;
@@ -228,15 +235,24 @@ 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[];
+    /** `false` keeps remote rulesets as `RULE-SET` references (Surge-family). */
+    expandRulesets: boolean;
     appendProxyType: boolean;
     nodeList: boolean;
     sortFlag: boolean;
@@ -244,6 +260,10 @@ interface ExtraSettings {
     clashNewFieldName: boolean;
     clashScript: boolean;
     clashClassicalRuleset: boolean;
+    /** Target Clash kernel: dropped protocols/fields follow its capabilities. */
+    clashFlavor: ClashFlavor;
+    /** Template variables applied to `{{ var }}` placeholders in base configs. */
+    templateVars: Record<string, string>;
     dedupe: boolean;
     surgeSsrPath: string;
     managedConfigPrefix: string;
@@ -273,6 +293,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;
@@ -288,6 +312,16 @@ interface RequestSettings {
     tls13: TriBool;
     newFieldName: boolean;
     classicalRuleset: boolean;
+    /** Target Clash kernel (`flavor=`): mihomo (default), premium, or stash. */
+    clashFlavor: ClashFlavor;
+    /** `false` keeps remote rulesets as `RULE-SET` references (Surge-family). */
+    expand: boolean;
+    /** Managed-config `strict=` flag for Surge-family `#!MANAGED-CONFIG`. */
+    strict: boolean;
+    /** Download filename override (`filename=`). */
+    filename: string;
+    /** Quantumult X device ID for remote-script signatures (`dev_id=`). */
+    devId: string;
     insert: boolean;
     mixin: string;
     interval: number;
@@ -365,7 +399,7 @@ declare function trim(input: string): string;
 declare function trimLowerCase(input: string): string;
 /** Parse the leading integer of a string; `0` when none is present. */
 declare function toInt(value: string | number | undefined | null): number;
-/** Parse a boolean-ish value ("true"/"false"/"1"/"0"). */
+/** Parse a boolean-ish value ("true"/"yes"/"1"/"on" and the matching negatives). */
 declare function toBool(value: string | undefined | null): boolean;
 /** `true` when `needle` occurs in `haystack`. */
 declare function strFind(haystack: string, needle: string): boolean;
@@ -449,6 +483,13 @@ declare function hasTemplatePlaceholders(content: string): boolean;
 /** Collect the variable names referenced by a template body. */
 declare function templateVariableNames(content: string): string[];
 
+/** `ruleset=` dialect prefixes (`surge:`, `quanx:`, `clash-domain:`, …). */
+declare const RULESET_TYPE_PREFIXES: ReadonlyArray<readonly [string, RulesetType]>;
+/** Split a ruleset source into its dialect prefix plus the bare URL/content. */
+declare function parseRulesetSource(source: string): {
+    url: string;
+    type?: RulesetType;
+};
 /** A parsed subconverter external configuration file. */
 interface ExternalConfig {
     groups: ProxyGroupConfig[];
@@ -459,6 +500,8 @@ interface ExternalConfig {
     nameRemove: string[];
     includeRemarks: string[];
     excludeRemarks: string[];
+    includeCountries: string[];
+    excludeCountries: string[];
     addEmoji: boolean;
     removeEmoji: boolean;
     autoCountry: boolean;
@@ -879,6 +922,12 @@ declare function explodeTrojan(trojan: string, node: Proxy): void;
 declare function explodeHysteria2(link: string, node: Proxy): void;
 /** Parse an `anytls://` link. */
 declare function explodeAnyTls(link: string, node: Proxy): void;
+/** Parse a `snell://psk@host:port?...` link. */
+declare function explodeSnell(link: string, node: Proxy): void;
+/** Parse a `hysteria://host:port?...` (v1) link. */
+declare function explodeHysteria(link: string, node: Proxy): void;
+/** Parse a `wg://` / `wireguard://host:port?...` link. */
+declare function explodeWireguard(link: string, node: Proxy): void;
 /** Parse a `vless://` link. */
 declare function explodeVless(link: string, node: Proxy): void;
 /** Parse a `tuic://` link. */
@@ -967,13 +1016,13 @@ declare function convertRuleset(content: string, type: RulesetType): string;
 /** Rewrite `TYPE,VALUE[,flag]` into `TYPE,VALUE,GROUP[,flag]`. */
 declare function transformRuleToCommon(input: string, group: string, noResolveOnly?: boolean): string;
 /** Convert rulesets into an ordered list of Clash rule strings. */
-declare function rulesetToClashRules(rulesets: RulesetContent[]): string[];
+declare function rulesetToClashRules(rulesets: RulesetContent[], classical?: boolean): string[];
 interface SurgeRulesetResult {
     section: string;
     lines: string[];
 }
 /** Convert rulesets into Surge/QuanX/Quan/Loon rule lines. */
-declare function rulesetToSurgeRules(rulesets: RulesetContent[], surgeVersion: number): SurgeRulesetResult;
+declare function rulesetToSurgeRules(rulesets: RulesetContent[], surgeVersion: number, expand?: boolean): SurgeRulesetResult;
 declare const SING_BOX_RULE_TYPES: string[];
 /** A sing-box `route` fragment produced from rulesets. */
 interface SingBoxRoute {
@@ -1093,6 +1142,13 @@ declare function proxyToSsSub(nodes: Proxy[], baseConf: string): string;
 /** Export Shadowsocks nodes as an `ssd://` document. */
 declare function proxyToSsd(nodes: Proxy[], group: string, userinfo: string): string;
 
+/**
+ * Patterns known to blow up the regex engine (mirrors subconverter-rs
+ * `REGEX_BLACK_LIST`); requests carrying them are rejected outright.
+ */
+declare const REGEX_BLACKLIST: readonly string[];
+/** `true` when `pattern` exactly matches a blacklisted catastrophic pattern. */
+declare function isBlacklistedPattern(pattern: string): boolean;
 /** Does `target` fall within a subconverter range expression like `1-5,8,!3`? */
 declare function matchRange(range: string, target: number): boolean;
 /**
@@ -1128,13 +1184,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 +1208,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 +1224,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 +1245,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, type ClashFlavor, 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, REGEX_BLACKLIST, RULESET_TYPE_PREFIXES, 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, explodeHysteria, explodeHysteria2, explodeKitsunebi, explodeNetch, explodeNetchConf, explodeQuan, explodeShadowrocket, explodeSnell, explodeSocks, explodeSs, explodeSsAndroid, explodeSsConf, explodeSsd, explodeSsr, explodeSsrConf, explodeSstap, explodeStdVmess, explodeSub, explodeSurge, explodeTrojan, explodeTuic, explodeVless, explodeVmess, explodeVmessConf, explodeWireguard, filterNodes, filterNodesByCountry, findSection, fnv1a64, fnv1a64Hex, formatCountryRemark, formatSingBoxInterval, formatSubscriptionUserinfo, generate, generatePeer, getAllUrlArgs, getDefaultProxyGroups, getDefaultRulesetConfigs, getDefaultRulesets, getSectionItems, getUrlArg, groupGenerate, hasRegionName, hasTemplatePlaceholders, httpConstruct, hysteria2Construct, hysteriaConstruct, inferUserinfoProviderFromUrl, isBlacklistedPattern, isBlank, isFlattenableSsr, isIp, isIpv4, isIpv6, isLink, isRegionCode, isSsCipher, matchRange, nextMonthlyResetTimestamp, nodeNameRegex, nodeNameRemove, nodeRename, normalizeCountryCode, normalizeQueryKey, normalizeUserinfoProvider, pad2, parseClashFlavor, parseClashText, parseConfContent, parseCustomProxyGroup, parseExternalConfig, parseGroupTimes, parseIni, parseJmsUserinfo, parseLink, parsePeers, parseProxyGroupType, parseRawIni, parseRegexMatch, parseRequestSettings, parseRulesetConfig, parseRulesetSource, 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

@@ -189,6 +189,13 @@ interface RulesetContent {
 /** Create a ruleset config with subconverter's defaults. */
 declare function createRulesetConfig(): RulesetConfig;
 
+/** Clash kernel flavor targeted by Clash output (`flavor=`). */
+type ClashFlavor = "mihomo" | "premium" | "stash";
+/**
+ * Parse a `flavor=` value (case-insensitive); unknown values fall back to
+ * `mihomo`, mirroring subconverter-rs `ClashFlavor::from_str`.
+ */
+declare function parseClashFlavor(value: string | undefined | null): ClashFlavor;
 /** A regex/script rewrite rule, mirroring `RegexMatchConfig`. */
 interface RegexMatchConfig {
     match: string;
@@ -228,15 +235,24 @@ 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[];
+    /** `false` keeps remote rulesets as `RULE-SET` references (Surge-family). */
+    expandRulesets: boolean;
     appendProxyType: boolean;
     nodeList: boolean;
     sortFlag: boolean;
@@ -244,6 +260,10 @@ interface ExtraSettings {
     clashNewFieldName: boolean;
     clashScript: boolean;
     clashClassicalRuleset: boolean;
+    /** Target Clash kernel: dropped protocols/fields follow its capabilities. */
+    clashFlavor: ClashFlavor;
+    /** Template variables applied to `{{ var }}` placeholders in base configs. */
+    templateVars: Record<string, string>;
     dedupe: boolean;
     surgeSsrPath: string;
     managedConfigPrefix: string;
@@ -273,6 +293,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;
@@ -288,6 +312,16 @@ interface RequestSettings {
     tls13: TriBool;
     newFieldName: boolean;
     classicalRuleset: boolean;
+    /** Target Clash kernel (`flavor=`): mihomo (default), premium, or stash. */
+    clashFlavor: ClashFlavor;
+    /** `false` keeps remote rulesets as `RULE-SET` references (Surge-family). */
+    expand: boolean;
+    /** Managed-config `strict=` flag for Surge-family `#!MANAGED-CONFIG`. */
+    strict: boolean;
+    /** Download filename override (`filename=`). */
+    filename: string;
+    /** Quantumult X device ID for remote-script signatures (`dev_id=`). */
+    devId: string;
     insert: boolean;
     mixin: string;
     interval: number;
@@ -365,7 +399,7 @@ declare function trim(input: string): string;
 declare function trimLowerCase(input: string): string;
 /** Parse the leading integer of a string; `0` when none is present. */
 declare function toInt(value: string | number | undefined | null): number;
-/** Parse a boolean-ish value ("true"/"false"/"1"/"0"). */
+/** Parse a boolean-ish value ("true"/"yes"/"1"/"on" and the matching negatives). */
 declare function toBool(value: string | undefined | null): boolean;
 /** `true` when `needle` occurs in `haystack`. */
 declare function strFind(haystack: string, needle: string): boolean;
@@ -449,6 +483,13 @@ declare function hasTemplatePlaceholders(content: string): boolean;
 /** Collect the variable names referenced by a template body. */
 declare function templateVariableNames(content: string): string[];
 
+/** `ruleset=` dialect prefixes (`surge:`, `quanx:`, `clash-domain:`, …). */
+declare const RULESET_TYPE_PREFIXES: ReadonlyArray<readonly [string, RulesetType]>;
+/** Split a ruleset source into its dialect prefix plus the bare URL/content. */
+declare function parseRulesetSource(source: string): {
+    url: string;
+    type?: RulesetType;
+};
 /** A parsed subconverter external configuration file. */
 interface ExternalConfig {
     groups: ProxyGroupConfig[];
@@ -459,6 +500,8 @@ interface ExternalConfig {
     nameRemove: string[];
     includeRemarks: string[];
     excludeRemarks: string[];
+    includeCountries: string[];
+    excludeCountries: string[];
     addEmoji: boolean;
     removeEmoji: boolean;
     autoCountry: boolean;
@@ -879,6 +922,12 @@ declare function explodeTrojan(trojan: string, node: Proxy): void;
 declare function explodeHysteria2(link: string, node: Proxy): void;
 /** Parse an `anytls://` link. */
 declare function explodeAnyTls(link: string, node: Proxy): void;
+/** Parse a `snell://psk@host:port?...` link. */
+declare function explodeSnell(link: string, node: Proxy): void;
+/** Parse a `hysteria://host:port?...` (v1) link. */
+declare function explodeHysteria(link: string, node: Proxy): void;
+/** Parse a `wg://` / `wireguard://host:port?...` link. */
+declare function explodeWireguard(link: string, node: Proxy): void;
 /** Parse a `vless://` link. */
 declare function explodeVless(link: string, node: Proxy): void;
 /** Parse a `tuic://` link. */
@@ -967,13 +1016,13 @@ declare function convertRuleset(content: string, type: RulesetType): string;
 /** Rewrite `TYPE,VALUE[,flag]` into `TYPE,VALUE,GROUP[,flag]`. */
 declare function transformRuleToCommon(input: string, group: string, noResolveOnly?: boolean): string;
 /** Convert rulesets into an ordered list of Clash rule strings. */
-declare function rulesetToClashRules(rulesets: RulesetContent[]): string[];
+declare function rulesetToClashRules(rulesets: RulesetContent[], classical?: boolean): string[];
 interface SurgeRulesetResult {
     section: string;
     lines: string[];
 }
 /** Convert rulesets into Surge/QuanX/Quan/Loon rule lines. */
-declare function rulesetToSurgeRules(rulesets: RulesetContent[], surgeVersion: number): SurgeRulesetResult;
+declare function rulesetToSurgeRules(rulesets: RulesetContent[], surgeVersion: number, expand?: boolean): SurgeRulesetResult;
 declare const SING_BOX_RULE_TYPES: string[];
 /** A sing-box `route` fragment produced from rulesets. */
 interface SingBoxRoute {
@@ -1093,6 +1142,13 @@ declare function proxyToSsSub(nodes: Proxy[], baseConf: string): string;
 /** Export Shadowsocks nodes as an `ssd://` document. */
 declare function proxyToSsd(nodes: Proxy[], group: string, userinfo: string): string;
 
+/**
+ * Patterns known to blow up the regex engine (mirrors subconverter-rs
+ * `REGEX_BLACK_LIST`); requests carrying them are rejected outright.
+ */
+declare const REGEX_BLACKLIST: readonly string[];
+/** `true` when `pattern` exactly matches a blacklisted catastrophic pattern. */
+declare function isBlacklistedPattern(pattern: string): boolean;
 /** Does `target` fall within a subconverter range expression like `1-5,8,!3`? */
 declare function matchRange(range: string, target: number): boolean;
 /**
@@ -1128,13 +1184,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 +1208,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 +1224,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 +1245,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, type ClashFlavor, 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, REGEX_BLACKLIST, RULESET_TYPE_PREFIXES, 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, explodeHysteria, explodeHysteria2, explodeKitsunebi, explodeNetch, explodeNetchConf, explodeQuan, explodeShadowrocket, explodeSnell, explodeSocks, explodeSs, explodeSsAndroid, explodeSsConf, explodeSsd, explodeSsr, explodeSsrConf, explodeSstap, explodeStdVmess, explodeSub, explodeSurge, explodeTrojan, explodeTuic, explodeVless, explodeVmess, explodeVmessConf, explodeWireguard, filterNodes, filterNodesByCountry, findSection, fnv1a64, fnv1a64Hex, formatCountryRemark, formatSingBoxInterval, formatSubscriptionUserinfo, generate, generatePeer, getAllUrlArgs, getDefaultProxyGroups, getDefaultRulesetConfigs, getDefaultRulesets, getSectionItems, getUrlArg, groupGenerate, hasRegionName, hasTemplatePlaceholders, httpConstruct, hysteria2Construct, hysteriaConstruct, inferUserinfoProviderFromUrl, isBlacklistedPattern, isBlank, isFlattenableSsr, isIp, isIpv4, isIpv6, isLink, isRegionCode, isSsCipher, matchRange, nextMonthlyResetTimestamp, nodeNameRegex, nodeNameRemove, nodeRename, normalizeCountryCode, normalizeQueryKey, normalizeUserinfoProvider, pad2, parseClashFlavor, parseClashText, parseConfContent, parseCustomProxyGroup, parseExternalConfig, parseGroupTimes, parseIni, parseJmsUserinfo, parseLink, parsePeers, parseProxyGroupType, parseRawIni, parseRegexMatch, parseRequestSettings, parseRulesetConfig, parseRulesetSource, 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 };