@fgv/ts-res-browser 1.0.0

package/test-data/config-variations/README.md

@@ -0,0 +1,64 @@
+# Configuration Variations
+
+This directory contains various system configuration files for testing the ts-res browser tool. Each configuration demonstrates different priority schemes and use cases.
+
+## Available Configurations
+
+### high-priority-language.json
+- **Use Case**: Internationalization-focused applications
+- **Priority**: Language (900) > Territory (600/500) > Role (400) > Platform (300)
+- **Features**: Simplified role set, basic platform types
+
+### territory-first.json
+- **Use Case**: Region-specific applications
+- **Priority**: Territory (950/900) > Language (700) > Role (600) > Environment (500)
+- **Features**: Case-sensitive roles, territory context lists enabled, non-optional home territory token
+
+### gaming-app.json
+- **Use Case**: Gaming applications
+- **Priority**: Platform (850) > Language (800) > Territory (750) > Graphics (700) > Player Level (600) > Game Mode (550)
+- **Features**: Gaming-specific qualifiers (graphics quality, player level, game mode), platform-focused hierarchy
+
+### minimal-basic.json
+- **Use Case**: Simple applications with basic requirements
+- **Priority**: Language (600) > Device (500)
+- **Features**: Only two qualifiers, minimal complexity
+
+### qualifier-default-values.json
+- **Use Case**: Demonstrating qualifier default values functionality
+- **Priority**: Language (600) > Territory (500) > Device (400) > Environment (300)
+- **Features**: All qualifiers have default values configured (language with multiple values, territory single value, device with list, environment single value)
+- **Demonstrates**: How default values are defined and used when qualifiers are not specified in context
+
+### enterprise-complex.json
+- **Use Case**: Large enterprise applications with complex permissions and multi-tenancy
+- **Priority**: Tenant (1000) > Environment (950) > Security (900) > Territory (850/800) > Language (750) > Role (700) > Department (650) > Feature Flags (600)
+- **Features**: Multi-tenant support, security levels, department-based access, feature flags, complex role hierarchies
+
+### composition-terminology.json
+- **Use Case**: Demonstrating resource composition with international terminology variations plus full application context
+- **Priority**: Home Territory (850) > Language (800) > Territory (700) > Region (600) > Role (500) > Environment (400) > Platform (300) > Density (200)
+- **Features**: Comprehensive terminology resources showing composition with partial candidates for regional variations, plus full application qualifiers for testing existing resources
+- **Resources**: UI terms with base English/French/Dutch candidates and partial variants for Canadian English, British English, Canadian French, Belgian Dutch; App configuration with territory-specific settings; Feature flags with regional overrides; Plus supports existing sample project resources
+- **Demonstrates**: How partial candidates compose with base candidates to create localized terminology sets while maintaining compatibility with existing test resources
+
+## Usage
+
+These configurations can be loaded into the Configuration Tool to test different system setups and see how they affect resource resolution behavior.
+
+Each configuration includes:
+- **name**: Human-readable name for the configuration
+- **description**: Explanation of the use case and features
+- **qualifierTypes**: Defines the available qualifier types with their configurations
+- **qualifiers**: Defines the actual qualifiers with their priorities and tokens
+- **resourceTypes**: Available resource types (currently just JSON)
+
+## Testing Different Scenarios
+
+Use these configurations to test:
+1. **Priority Effects**: How different priority schemes affect resource resolution
+2. **Context Lists**: Territory and role configurations with `allowContextList` enabled
+3. **Case Sensitivity**: Role configurations with different case sensitivity settings
+4. **Token Usage**: Various token configurations (optional vs required)
+5. **Default Values**: Qualifier default values for fallback behavior (see qualifier-default-values.json)
+6. **Complexity Scaling**: From minimal (2 qualifiers) to complex (9 qualifiers)

package/test-data/config-variations/composition-terminology.json

@@ -0,0 +1,112 @@
+{
+  "name": "Composition Terminology Configuration",
+  "description": "Configuration demonstrating composition with international terminology variations plus full application context",
+  "qualifierTypes": [
+    {
+      "name": "language",
+      "systemType": "language"
+    },
+    {
+      "name": "territory",
+      "systemType": "territory",
+      "configuration": {
+        "allowContextList": true
+      }
+    },
+    {
+      "name": "role",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": false,
+        "enumeratedValues": ["admin", "user", "guest", "anonymous"]
+      }
+    },
+    {
+      "name": "environment",
+      "systemType": "literal",
+      "configuration": {
+        "enumeratedValues": ["development", "integration", "production", "test"]
+      }
+    },
+    {
+      "name": "platform",
+      "systemType": "literal",
+      "configuration": {
+        "enumeratedValues": ["ios", "android", "web", "mobile", "tv", "desktop"]
+      },
+      "hierarchy": {
+        "ios": "mobile",
+        "android": "mobile"
+      }
+    },
+    {
+      "name": "density",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": false,
+        "enumeratedValues": ["hdpi", "mdpi", "ldpi"]
+      }
+    },
+    {
+      "name": "region",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": false,
+        "enumeratedValues": ["north-america", "europe", "asia-pacific", "latin-america"]
+      }
+    }
+  ],
+  "qualifiers": [
+    {
+      "name": "language",
+      "typeName": "language",
+      "defaultPriority": 800
+    },
+    {
+      "name": "homeTerritory",
+      "typeName": "territory",
+      "defaultPriority": 850,
+      "token": "home",
+      "tokenIsOptional": true
+    },
+    {
+      "name": "territory",
+      "typeName": "territory",
+      "defaultPriority": 700
+    },
+    {
+      "name": "role",
+      "typeName": "role",
+      "defaultPriority": 500
+    },
+    {
+      "name": "env",
+      "typeName": "environment",
+      "defaultPriority": 400
+    },
+    {
+      "name": "platform",
+      "typeName": "platform",
+      "defaultPriority": 300
+    },
+    {
+      "name": "density",
+      "typeName": "density",
+      "defaultPriority": 200
+    },
+    {
+      "name": "region",
+      "typeName": "region",
+      "defaultPriority": 600
+    }
+  ],
+  "resourceTypes": [
+    {
+      "name": "json",
+      "typeName": "json"
+    }
+  ]
+}

package/test-data/config-variations/enterprise-complex.json

@@ -0,0 +1,129 @@
+{
+  "name": "Enterprise Complex Configuration",
+  "description": "Comprehensive configuration for enterprise applications with many conditional dimensions",
+  "qualifierTypes": [
+    {
+      "name": "language",
+      "systemType": "language"
+    },
+    {
+      "name": "territory",
+      "systemType": "territory",
+      "configuration": {
+        "allowContextList": true
+      }
+    },
+    {
+      "name": "role",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": true,
+        "caseSensitive": false,
+        "enumeratedValues": ["admin", "manager", "employee", "contractor", "guest", "api", "service"]
+      }
+    },
+    {
+      "name": "department",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": false,
+        "enumeratedValues": ["hr", "finance", "engineering", "sales", "marketing", "support", "legal"]
+      }
+    },
+    {
+      "name": "environment",
+      "systemType": "literal",
+      "configuration": {
+        "enumeratedValues": ["development", "testing", "staging", "production", "dr"]
+      }
+    },
+    {
+      "name": "tenant",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": true,
+        "enumeratedValues": ["corp", "subsidiary1", "subsidiary2", "partner1", "partner2"]
+      }
+    },
+    {
+      "name": "feature-flag",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": true,
+        "caseSensitive": false,
+        "enumeratedValues": ["enabled", "disabled", "beta", "alpha"]
+      }
+    },
+    {
+      "name": "security-level",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": false,
+        "enumeratedValues": ["public", "internal", "confidential", "restricted"]
+      }
+    }
+  ],
+  "qualifiers": [
+    {
+      "name": "tenant",
+      "typeName": "tenant",
+      "defaultPriority": 1000
+    },
+    {
+      "name": "environment",
+      "typeName": "environment",
+      "defaultPriority": 950,
+      "token": "env"
+    },
+    {
+      "name": "securityLevel",
+      "typeName": "security-level",
+      "defaultPriority": 900,
+      "token": "security"
+    },
+    {
+      "name": "homeTerritory",
+      "typeName": "territory",
+      "defaultPriority": 850,
+      "token": "home",
+      "tokenIsOptional": true
+    },
+    {
+      "name": "currentTerritory",
+      "typeName": "territory",
+      "defaultPriority": 800
+    },
+    {
+      "name": "language",
+      "typeName": "language",
+      "defaultPriority": 750
+    },
+    {
+      "name": "role",
+      "typeName": "role",
+      "defaultPriority": 700
+    },
+    {
+      "name": "department",
+      "typeName": "department",
+      "defaultPriority": 650,
+      "token": "dept"
+    },
+    {
+      "name": "featureFlag",
+      "typeName": "feature-flag",
+      "defaultPriority": 600,
+      "token": "feature",
+      "tokenIsOptional": true
+    }
+  ],
+  "resourceTypes": [
+    {
+      "name": "json",
+      "typeName": "json"
+    }
+  ]
+}

package/test-data/config-variations/gaming-app.json

@@ -0,0 +1,87 @@
+{
+  "name": "Gaming Application Configuration",
+  "description": "Configuration tailored for gaming applications with device and graphics quality considerations",
+  "qualifierTypes": [
+    {
+      "name": "language",
+      "systemType": "language"
+    },
+    {
+      "name": "territory",
+      "systemType": "territory"
+    },
+    {
+      "name": "platform",
+      "systemType": "literal",
+      "configuration": {
+        "enumeratedValues": ["pc", "console", "mobile", "vr", "ar"]
+      }
+    },
+    {
+      "name": "graphics-quality",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": false,
+        "enumeratedValues": ["low", "medium", "high", "ultra", "rtx"]
+      }
+    },
+    {
+      "name": "player-level",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": false,
+        "enumeratedValues": ["beginner", "intermediate", "advanced", "expert", "pro"]
+      }
+    },
+    {
+      "name": "game-mode",
+      "systemType": "literal",
+      "configuration": {
+        "enumeratedValues": ["single", "multiplayer", "cooperative", "competitive", "tutorial"]
+      }
+    }
+  ],
+  "qualifiers": [
+    {
+      "name": "platform",
+      "typeName": "platform",
+      "defaultPriority": 850
+    },
+    {
+      "name": "language",
+      "typeName": "language",
+      "defaultPriority": 800
+    },
+    {
+      "name": "territory",
+      "typeName": "territory",
+      "defaultPriority": 750
+    },
+    {
+      "name": "graphics",
+      "typeName": "graphics-quality",
+      "defaultPriority": 700,
+      "token": "gfx"
+    },
+    {
+      "name": "playerLevel",
+      "typeName": "player-level",
+      "defaultPriority": 600,
+      "token": "level"
+    },
+    {
+      "name": "gameMode",
+      "typeName": "game-mode",
+      "defaultPriority": 550,
+      "token": "mode"
+    }
+  ],
+  "resourceTypes": [
+    {
+      "name": "json",
+      "typeName": "json"
+    }
+  ]
+}

package/test-data/config-variations/high-priority-language.json

@@ -0,0 +1,65 @@
+{
+  "name": "High Priority Language Configuration",
+  "description": "Configuration that prioritizes language over territory, useful for internationalization-focused applications",
+  "qualifierTypes": [
+    {
+      "name": "language",
+      "systemType": "language"
+    },
+    {
+      "name": "territory",
+      "systemType": "territory"
+    },
+    {
+      "name": "role",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": false,
+        "enumeratedValues": ["admin", "user", "guest"]
+      }
+    },
+    {
+      "name": "platform",
+      "systemType": "literal",
+      "configuration": {
+        "enumeratedValues": ["web", "mobile", "desktop"]
+      }
+    }
+  ],
+  "qualifiers": [
+    {
+      "name": "language",
+      "typeName": "language",
+      "defaultPriority": 900
+    },
+    {
+      "name": "homeTerritory",
+      "typeName": "territory",
+      "defaultPriority": 600,
+      "token": "home",
+      "tokenIsOptional": true
+    },
+    {
+      "name": "currentTerritory",
+      "typeName": "territory",
+      "defaultPriority": 500
+    },
+    {
+      "name": "role",
+      "typeName": "role",
+      "defaultPriority": 400
+    },
+    {
+      "name": "platform",
+      "typeName": "platform",
+      "defaultPriority": 300
+    }
+  ],
+  "resourceTypes": [
+    {
+      "name": "json",
+      "typeName": "json"
+    }
+  ]
+}

package/test-data/config-variations/minimal-basic.json

@@ -0,0 +1,37 @@
+{
+  "name": "Minimal Basic Configuration",
+  "description": "Simplified configuration with only essential qualifiers for basic applications",
+  "qualifierTypes": [
+    {
+      "name": "language",
+      "systemType": "language"
+    },
+    {
+      "name": "device",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": false,
+        "enumeratedValues": ["phone", "tablet", "desktop"]
+      }
+    }
+  ],
+  "qualifiers": [
+    {
+      "name": "language",
+      "typeName": "language",
+      "defaultPriority": 600
+    },
+    {
+      "name": "device",
+      "typeName": "device",
+      "defaultPriority": 500
+    }
+  ],
+  "resourceTypes": [
+    {
+      "name": "json",
+      "typeName": "json"
+    }
+  ]
+}

package/test-data/config-variations/qualifier-default-values.json

@@ -0,0 +1,71 @@
+{
+  "name": "Qualifier Default Values Demo",
+  "description": "Configuration demonstrating qualifier default values functionality with language, territory, and device qualifiers",
+  "qualifierTypes": [
+    {
+      "name": "language",
+      "systemType": "language",
+      "configuration": {
+        "allowContextList": true
+      }
+    },
+    {
+      "name": "territory",
+      "systemType": "territory",
+      "configuration": {
+        "allowContextList": false,
+        "acceptLowercase": true
+      }
+    },
+    {
+      "name": "device",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": true,
+        "caseSensitive": false,
+        "enumeratedValues": ["phone", "tablet", "desktop", "watch", "tv"]
+      }
+    },
+    {
+      "name": "environment",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": true,
+        "enumeratedValues": ["development", "staging", "production"]
+      }
+    }
+  ],
+  "qualifiers": [
+    {
+      "name": "language",
+      "typeName": "language",
+      "defaultPriority": 600,
+      "defaultValue": "en-US, en-CA, en-GB"
+    },
+    {
+      "name": "territory",
+      "typeName": "territory",
+      "defaultPriority": 500,
+      "defaultValue": "US"
+    },
+    {
+      "name": "device",
+      "typeName": "device",
+      "defaultPriority": 400,
+      "defaultValue": "desktop, tablet"
+    },
+    {
+      "name": "environment",
+      "typeName": "environment",
+      "defaultPriority": 300,
+      "defaultValue": "production"
+    }
+  ],
+  "resourceTypes": [
+    {
+      "name": "json",
+      "typeName": "json"
+    }
+  ]
+}

package/test-data/config-variations/territory-first.json

@@ -0,0 +1,68 @@
+{
+  "name": "Territory-First Configuration",
+  "description": "Configuration that prioritizes territory/region over language, useful for region-specific applications",
+  "qualifierTypes": [
+    {
+      "name": "language",
+      "systemType": "language"
+    },
+    {
+      "name": "territory",
+      "systemType": "territory",
+      "configuration": {
+        "allowContextList": true
+      }
+    },
+    {
+      "name": "role",
+      "systemType": "literal",
+      "configuration": {
+        "allowContextList": false,
+        "caseSensitive": true,
+        "enumeratedValues": ["ADMIN", "USER", "GUEST", "MODERATOR"]
+      }
+    },
+    {
+      "name": "environment",
+      "systemType": "literal",
+      "configuration": {
+        "enumeratedValues": ["development", "staging", "production"]
+      }
+    }
+  ],
+  "qualifiers": [
+    {
+      "name": "homeTerritory",
+      "typeName": "territory",
+      "defaultPriority": 950,
+      "token": "home",
+      "tokenIsOptional": false
+    },
+    {
+      "name": "currentTerritory",
+      "typeName": "territory",
+      "defaultPriority": 900
+    },
+    {
+      "name": "language",
+      "typeName": "language",
+      "defaultPriority": 700
+    },
+    {
+      "name": "role",
+      "typeName": "role",
+      "defaultPriority": 600
+    },
+    {
+      "name": "env",
+      "typeName": "environment",
+      "defaultPriority": 500
+    }
+  ],
+  "resourceTypes": [
+    {
+      "name": "json",
+      "typeName": "json"
+    }
+  ]
+}

package/test-data/config-variations/territory-hierarchy-test.json

@@ -0,0 +1,31 @@
+{
+  "name": "territory-hierarchy-test",
+  "description": "Test configuration for territory qualifier type hierarchy support",
+  "qualifierTypes": [
+    {
+      "name": "territory",
+      "systemType": "territory",
+      "configuration": {
+        "allowContextList": true,
+        "acceptLowercase": true,
+        "allowedTerritories": ["US", "PR", "VI", "CA", "GB", "DE"],
+        "hierarchy": {
+          "PR": "US",
+          "VI": "US"
+        }
+      }
+    }
+  ],
+  "qualifiers": [
+    {
+      "name": "territory",
+      "type": "territory"
+    }
+  ],
+  "resourceTypes": [
+    {
+      "name": "message",
+      "qualifiers": ["territory"]
+    }
+  ]
+}