@use-voltra/expo-plugin 2.3.1 → 2.4.0

package/build/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.widgetLabelEnglish = exports.isWidgetLocalizedMap = exports.prerenderWidgetState = exports.evaluateWidgetModuleExports = exports.evaluateWidgetModule = exports.createPrerenderWidgetModuleLoader = exports.resolveInstalledPackageVersion = exports.logger = exports.pickLocalizedValue = exports.normalizeLocaleTag = exports.resolveFontPaths = exports.addApplicationGroupsEntitlement = exports.validateWidgetLabel = exports.validateWidgetEntry = exports.validateInitialStatePath = exports.validateHomeScreenWidgetId = exports.normalizeWidgetEntryPath = exports.assertValidLocaleKey = exports.validateWidgetServerUpdate = exports.resolveWidgetServerUpdate = exports.validateServerUpdateRefresh = exports.resolveServerUpdateUrl = exports.resolveServerUpdateInterval = exports.isLocalHttpHost = exports.DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES = exports.getDynamicLiveActivityAttributesType = exports.MAX_IMAGE_SIZE_BYTES = void 0;
+exports.widgetParameterTitleKey = exports.widgetParameterOptionKey = exports.validateWidgetConfigurationCopy = exports.collectWidgetConfigurationStrings = exports.collectLabelLocaleKeys = exports.widgetLabelEnglish = exports.isWidgetLocalizedMap = exports.prerenderWidgetState = exports.evaluateWidgetModuleExports = exports.evaluateWidgetModule = exports.createPrerenderWidgetModuleLoader = exports.resolveInstalledPackageVersion = exports.logger = exports.pickLocalizedValue = exports.normalizeLocaleTag = exports.resolveFontPaths = exports.addApplicationGroupsEntitlement = exports.validateWidgetLabel = exports.validateWidgetEntry = exports.validateInitialStatePath = exports.validateHomeScreenWidgetId = exports.normalizeWidgetEntryPath = exports.assertValidLocaleKey = exports.validateWidgetServerUpdate = exports.resolveWidgetServerUpdate = exports.validateServerUpdateRefresh = exports.resolveServerUpdateUrl = exports.resolveServerUpdateInterval = exports.isLocalHttpHost = exports.DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES = exports.getDynamicLiveActivityAttributesType = exports.MAX_IMAGE_SIZE_BYTES = void 0;
 var constants_1 = require("./constants");
 Object.defineProperty(exports, "MAX_IMAGE_SIZE_BYTES", { enumerable: true, get: function () { return constants_1.MAX_IMAGE_SIZE_BYTES; } });
 var dynamic_live_activity_1 = require("./dynamic-live-activity");
@@ -40,4 +40,10 @@ Object.defineProperty(exports, "prerenderWidgetState", { enumerable: true, get:
 var widgetLabel_1 = require("./utils/widgetLabel");
 Object.defineProperty(exports, "isWidgetLocalizedMap", { enumerable: true, get: function () { return widgetLabel_1.isWidgetLocalizedMap; } });
 Object.defineProperty(exports, "widgetLabelEnglish", { enumerable: true, get: function () { return widgetLabel_1.widgetLabelEnglish; } });
+var widgetConfiguration_1 = require("./widgetConfiguration");
+Object.defineProperty(exports, "collectLabelLocaleKeys", { enumerable: true, get: function () { return widgetConfiguration_1.collectLabelLocaleKeys; } });
+Object.defineProperty(exports, "collectWidgetConfigurationStrings", { enumerable: true, get: function () { return widgetConfiguration_1.collectWidgetConfigurationStrings; } });
+Object.defineProperty(exports, "validateWidgetConfigurationCopy", { enumerable: true, get: function () { return widgetConfiguration_1.validateWidgetConfigurationCopy; } });
+Object.defineProperty(exports, "widgetParameterOptionKey", { enumerable: true, get: function () { return widgetConfiguration_1.widgetParameterOptionKey; } });
+Object.defineProperty(exports, "widgetParameterTitleKey", { enumerable: true, get: function () { return widgetConfiguration_1.widgetParameterTitleKey; } });
 //# sourceMappingURL=index.js.map

package/build/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAkD;AAAzC,iHAAA,oBAAoB,OAAA;AAC7B,iEAA8E;AAArE,6IAAA,oCAAoC,OAAA;AAc7C,+CAMuB;AALrB,6IAAA,6CAA6C,OAAA;AAC7C,+GAAA,eAAe,OAAA;AACf,2HAAA,2BAA2B,OAAA;AAC3B,sHAAA,sBAAsB,OAAA;AACtB,2HAAA,2BAA2B,OAAA;AAO7B,2DAA4F;AAAnF,+HAAA,yBAAyB,OAAA;AAAE,gIAAA,0BAA0B,OAAA;AAC9D,2CAOqB;AANnB,kHAAA,oBAAoB,OAAA;AACpB,sHAAA,wBAAwB,OAAA;AACxB,wHAAA,0BAA0B,OAAA;AAC1B,sHAAA,wBAAwB,OAAA;AACxB,iHAAA,mBAAmB,OAAA;AACnB,iHAAA,mBAAmB,OAAA;AAErB,qDAAsE;AAA7D,+HAAA,+BAA+B,OAAA;AACxC,uCAAgD;AAAvC,yGAAA,gBAAgB,OAAA;AACzB,iDAA2E;AAAlE,gHAAA,kBAAkB,OAAA;AAAE,gHAAA,kBAAkB,OAAA;AAC/C,yCAAuC;AAA9B,gGAAA,MAAM,OAAA;AACf,yDAAuE;AAA9D,gIAAA,8BAA8B,OAAA;AAOvC,+CAK0B;AAJxB,8HAAA,iCAAiC,OAAA;AACjC,iHAAA,oBAAoB,OAAA;AACpB,wHAAA,2BAA2B,OAAA;AAC3B,iHAAA,oBAAoB,OAAA;AAGtB,mDAA8E;AAArE,mHAAA,oBAAoB,OAAA;AAAE,iHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAkD;AAAzC,iHAAA,oBAAoB,OAAA;AAC7B,iEAA8E;AAArE,6IAAA,oCAAoC,OAAA;AAiB7C,+CAMuB;AALrB,6IAAA,6CAA6C,OAAA;AAC7C,+GAAA,eAAe,OAAA;AACf,2HAAA,2BAA2B,OAAA;AAC3B,sHAAA,sBAAsB,OAAA;AACtB,2HAAA,2BAA2B,OAAA;AAO7B,2DAA4F;AAAnF,+HAAA,yBAAyB,OAAA;AAAE,gIAAA,0BAA0B,OAAA;AAC9D,2CAOqB;AANnB,kHAAA,oBAAoB,OAAA;AACpB,sHAAA,wBAAwB,OAAA;AACxB,wHAAA,0BAA0B,OAAA;AAC1B,sHAAA,wBAAwB,OAAA;AACxB,iHAAA,mBAAmB,OAAA;AACnB,iHAAA,mBAAmB,OAAA;AAErB,qDAAsE;AAA7D,+HAAA,+BAA+B,OAAA;AACxC,uCAAgD;AAAvC,yGAAA,gBAAgB,OAAA;AACzB,iDAA2E;AAAlE,gHAAA,kBAAkB,OAAA;AAAE,gHAAA,kBAAkB,OAAA;AAC/C,yCAAuC;AAA9B,gGAAA,MAAM,OAAA;AACf,yDAAuE;AAA9D,gIAAA,8BAA8B,OAAA;AAOvC,+CAK0B;AAJxB,8HAAA,iCAAiC,OAAA;AACjC,iHAAA,oBAAoB,OAAA;AACpB,wHAAA,2BAA2B,OAAA;AAC3B,iHAAA,oBAAoB,OAAA;AAGtB,mDAA8E;AAArE,mHAAA,oBAAoB,OAAA;AAAE,iHAAA,kBAAkB,OAAA;AAEjD,6DAM8B;AAL5B,6HAAA,sBAAsB,OAAA;AACtB,wIAAA,iCAAiC,OAAA;AACjC,sIAAA,+BAA+B,OAAA;AAC/B,+HAAA,wBAAwB,OAAA;AACxB,8HAAA,uBAAuB,OAAA"}

package/build/cjs/utils/localePick.js

@@ -1,48 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeLocaleTag = normalizeLocaleTag;
-exports.pickLocalizedValue = pickLocalizedValue;
+exports.pickLocalizedValue = exports.normalizeLocaleTag = void 0;
 /**
- * Picks a localized string value from a locale-keyed map using the same fallback rules as iOS/Android runtimes:
- * preferred language tags (full match, then language-only), then `en`, then `__default`, then first value.
+ * Locale picking now lives in `@use-voltra/core` so widget code can use the same fallback rules
+ * at render time (`resolveLocale`). Re-exported here so existing imports keep working.
  */
-function normalizeLocaleTag(tag) {
-    return tag.trim().toLowerCase().replace(/_/g, '-');
-}
-function pickLocalizedValue(perLocale, preferredLanguages) {
-    const entries = Object.entries(perLocale).filter(([, v]) => typeof v === 'string' && v.length > 0);
-    if (entries.length === 0) {
-        return undefined;
-    }
-    const byNorm = new Map();
-    for (const [k, v] of entries) {
-        byNorm.set(normalizeLocaleTag(k), v);
-    }
-    const DEFAULT_KEY = '__default';
-    for (const pref of preferredLanguages) {
-        const n = normalizeLocaleTag(pref);
-        const direct = byNorm.get(n);
-        if (direct !== undefined) {
-            return direct;
-        }
-        const lang = n.split('-')[0] ?? n;
-        for (const [key, val] of entries) {
-            const kn = normalizeLocaleTag(key);
-            const keyLang = kn.split('-')[0] ?? kn;
-            if (keyLang === lang) {
-                return val;
-            }
-        }
-    }
-    const en = byNorm.get('en') ?? entries.find(([k]) => normalizeLocaleTag(k) === 'en')?.[1];
-    if (en !== undefined) {
-        return en;
-    }
-    const defaultVal = byNorm.get(DEFAULT_KEY) ?? entries.find(([k]) => k === DEFAULT_KEY)?.[1];
-    if (defaultVal !== undefined) {
-        return defaultVal;
-    }
-    const sorted = [...entries].sort(([a], [b]) => a.localeCompare(b));
-    return sorted[0]?.[1];
-}
+var locale_1 = require("@use-voltra/core/locale");
+Object.defineProperty(exports, "normalizeLocaleTag", { enumerable: true, get: function () { return locale_1.normalizeLocaleTag; } });
+Object.defineProperty(exports, "pickLocalizedValue", { enumerable: true, get: function () { return locale_1.pickLocalizedValue; } });
 //# sourceMappingURL=localePick.js.map

package/build/cjs/utils/localePick.js.map

@@ -1 +1 @@
-{"version":3,"file":"localePick.js","sourceRoot":"","sources":["../../../src/utils/localePick.ts"],"names":[],"mappings":";;AAIA,gDAEC;AAED,gDA4CC;AApDD;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AACpD,CAAC;AAED,SAAgB,kBAAkB,CAChC,SAAiC,EACjC,kBAA4B;IAE5B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAClG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACtC,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAA;IAE/B,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAC5B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAA;QACf,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACjC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;YACjC,MAAM,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;YAClC,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;YACtC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,GAAG,CAAA;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACzF,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC3F,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;IAClE,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AACvB,CAAC"}
+{"version":3,"file":"localePick.js","sourceRoot":"","sources":["../../../src/utils/localePick.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,kDAAgF;AAAvE,4GAAA,kBAAkB,OAAA;AAAE,4GAAA,kBAAkB,OAAA"}

package/build/cjs/widgetConfiguration.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.widgetParameterTitleKey = widgetParameterTitleKey;
+exports.widgetParameterOptionKey = widgetParameterOptionKey;
+exports.collectWidgetConfigurationStrings = collectWidgetConfigurationStrings;
+exports.collectLabelLocaleKeys = collectLabelLocaleKeys;
+exports.validateWidgetConfigurationCopy = validateWidgetConfigurationCopy;
+const widgetLabel_1 = require("./utils/widgetLabel");
+const validation_1 = require("./validation");
+/** Swift property / Kotlin-safe identifier, also the key under `env.configuration`. */
+const PARAMETER_NAME_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+const identity = (value) => value;
+function widgetParameterTitleKey(widgetId, parameterName, part = identity) {
+    return `voltra_widget_${part(widgetId)}_param_${part(parameterName)}_title`;
+}
+function widgetParameterOptionKey(widgetId, parameterName, optionValue, part = identity) {
+    return `voltra_widget_${part(widgetId)}_param_${part(parameterName)}_option_${part(optionValue)}`;
+}
+/**
+ * Every configuration-sheet string a widget declares, in declaration order. `part` sanitises each
+ * key segment (Android resource names allow only `[a-z0-9_]`).
+ */
+function collectWidgetConfigurationStrings(widget, part = identity) {
+    const strings = [];
+    for (const parameter of widget.appIntent?.parameters ?? []) {
+        if (parameter.title !== undefined) {
+            strings.push({ key: widgetParameterTitleKey(widget.id, parameter.name, part), label: parameter.title });
+        }
+        for (const option of parameter.options ?? []) {
+            strings.push({
+                key: widgetParameterOptionKey(widget.id, parameter.name, option.value, part),
+                label: option.title,
+            });
+        }
+    }
+    return strings;
+}
+/** Locale keys used by any locale map among `labels`, `__default` excluded. */
+function collectLabelLocaleKeys(labels) {
+    const keys = new Set();
+    for (const label of labels) {
+        if (label === undefined || !(0, widgetLabel_1.isWidgetLocalizedMap)(label)) {
+            continue;
+        }
+        for (const [locale, value] of Object.entries(label)) {
+            if (locale !== '__default' && typeof value === 'string' && value.trim()) {
+                keys.add(locale);
+            }
+        }
+    }
+    return [...keys];
+}
+/**
+ * Validates `appIntent.parameters[]` (titles as plain strings or locale maps, and static
+ * `options`).
+ */
+function validateWidgetConfigurationCopy(widget, options) {
+    const widgetId = widget.id;
+    const appIntent = widget.appIntent;
+    if (appIntent === undefined) {
+        return;
+    }
+    if (typeof appIntent !== 'object' || appIntent === null || !Array.isArray(appIntent.parameters)) {
+        throw new Error(`Widget '${widgetId}': appIntent.parameters must be an array`);
+    }
+    const names = new Set();
+    for (const [index, parameter] of appIntent.parameters.entries()) {
+        const context = `appIntent.parameters[${index}]`;
+        if (typeof parameter !== 'object' || parameter === null) {
+            throw new Error(`Widget '${widgetId}': ${context} must be an object`);
+        }
+        const { name, title, default: defaultValue, options: parameterOptions } = parameter;
+        if (typeof name !== 'string' || !name) {
+            throw new Error(`Widget '${widgetId}': ${context}.name must be a non-empty string`);
+        }
+        if ((options.requireIdentifierName ?? true) && !PARAMETER_NAME_PATTERN.test(name)) {
+            throw new Error(`Widget '${widgetId}': ${context}.name must start with a letter or underscore and contain only letters, digits and underscores`);
+        }
+        if (names.has(name)) {
+            throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' is declared more than once`);
+        }
+        names.add(name);
+        if (title === undefined) {
+            if (options.requireParameterTitle) {
+                throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' needs a title`);
+            }
+        }
+        else {
+            (0, validation_1.validateWidgetLabel)(title, widgetId, `appIntent parameter '${name}' title`);
+        }
+        if (defaultValue !== undefined && typeof defaultValue !== 'string') {
+            throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' default must be a string`);
+        }
+        if (parameterOptions === undefined) {
+            continue;
+        }
+        if (!Array.isArray(parameterOptions) || parameterOptions.length === 0) {
+            throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' options must be a non-empty array`);
+        }
+        const values = new Set();
+        for (const option of parameterOptions) {
+            const value = option?.value;
+            if (typeof value !== 'string' || !value) {
+                throw new Error(`Widget '${widgetId}': every option of appIntent parameter '${name}' needs a string value`);
+            }
+            if (values.has(value)) {
+                throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' lists option '${value}' twice`);
+            }
+            values.add(value);
+            (0, validation_1.validateWidgetLabel)(option.title, widgetId, `appIntent parameter '${name}' option '${value}' title`);
+        }
+        if (defaultValue !== undefined && !values.has(defaultValue)) {
+            throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' default '${defaultValue}' is not one of its options`);
+        }
+    }
+}
+//# sourceMappingURL=widgetConfiguration.js.map

package/build/cjs/widgetConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgetConfiguration.js","sourceRoot":"","sources":["../../src/widgetConfiguration.ts"],"names":[],"mappings":"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"}

package/build/esm/index.js

@@ -10,4 +10,5 @@ export { logger } from './utils/logger';
 export { resolveInstalledPackageVersion } from './utils/packageVersion';
 export { createPrerenderWidgetModuleLoader, evaluateWidgetModule, evaluateWidgetModuleExports, prerenderWidgetState, } from './utils/prerender';
 export { isWidgetLocalizedMap, widgetLabelEnglish } from './utils/widgetLabel';
+export { collectLabelLocaleKeys, collectWidgetConfigurationStrings, validateWidgetConfigurationCopy, widgetParameterOptionKey, widgetParameterTitleKey, } from './widgetConfiguration';
 //# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAA;AAc9E,OAAO,EACL,6CAA6C,EAC7C,eAAe,EACf,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAA;AAMvB,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AAC5F,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAA;AAOvE,OAAO,EACL,iCAAiC,EACjC,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAA;AAiB9E,OAAO,EACL,6CAA6C,EAC7C,eAAe,EACf,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAA;AAMvB,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AAC5F,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAA;AAOvE,OAAO,EACL,iCAAiC,EACjC,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAE9E,OAAO,EACL,sBAAsB,EACtB,iCAAiC,EACjC,+BAA+B,EAC/B,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,uBAAuB,CAAA"}

package/build/esm/utils/localePick.js

@@ -1,44 +1,6 @@
 /**
- * Picks a localized string value from a locale-keyed map using the same fallback rules as iOS/Android runtimes:
- * preferred language tags (full match, then language-only), then `en`, then `__default`, then first value.
+ * Locale picking now lives in `@use-voltra/core` so widget code can use the same fallback rules
+ * at render time (`resolveLocale`). Re-exported here so existing imports keep working.
  */
-export function normalizeLocaleTag(tag) {
-    return tag.trim().toLowerCase().replace(/_/g, '-');
-}
-export function pickLocalizedValue(perLocale, preferredLanguages) {
-    const entries = Object.entries(perLocale).filter(([, v]) => typeof v === 'string' && v.length > 0);
-    if (entries.length === 0) {
-        return undefined;
-    }
-    const byNorm = new Map();
-    for (const [k, v] of entries) {
-        byNorm.set(normalizeLocaleTag(k), v);
-    }
-    const DEFAULT_KEY = '__default';
-    for (const pref of preferredLanguages) {
-        const n = normalizeLocaleTag(pref);
-        const direct = byNorm.get(n);
-        if (direct !== undefined) {
-            return direct;
-        }
-        const lang = n.split('-')[0] ?? n;
-        for (const [key, val] of entries) {
-            const kn = normalizeLocaleTag(key);
-            const keyLang = kn.split('-')[0] ?? kn;
-            if (keyLang === lang) {
-                return val;
-            }
-        }
-    }
-    const en = byNorm.get('en') ?? entries.find(([k]) => normalizeLocaleTag(k) === 'en')?.[1];
-    if (en !== undefined) {
-        return en;
-    }
-    const defaultVal = byNorm.get(DEFAULT_KEY) ?? entries.find(([k]) => k === DEFAULT_KEY)?.[1];
-    if (defaultVal !== undefined) {
-        return defaultVal;
-    }
-    const sorted = [...entries].sort(([a], [b]) => a.localeCompare(b));
-    return sorted[0]?.[1];
-}
+export { normalizeLocaleTag, pickLocalizedValue } from '@use-voltra/core/locale';
 //# sourceMappingURL=localePick.js.map

package/build/esm/utils/localePick.js.map

@@ -1 +1 @@
-{"version":3,"file":"localePick.js","sourceRoot":"","sources":["../../../src/utils/localePick.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,SAAiC,EACjC,kBAA4B;IAE5B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAClG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACtC,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAA;IAE/B,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAC5B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAA;QACf,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACjC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;YACjC,MAAM,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;YAClC,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;YACtC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,GAAG,CAAA;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACzF,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC3F,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;IAClE,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AACvB,CAAC"}
+{"version":3,"file":"localePick.js","sourceRoot":"","sources":["../../../src/utils/localePick.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA"}

package/build/esm/widgetConfiguration.js

@@ -0,0 +1,110 @@
+import { isWidgetLocalizedMap } from './utils/widgetLabel';
+import { validateWidgetLabel } from './validation';
+/** Swift property / Kotlin-safe identifier, also the key under `env.configuration`. */
+const PARAMETER_NAME_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+const identity = (value) => value;
+export function widgetParameterTitleKey(widgetId, parameterName, part = identity) {
+    return `voltra_widget_${part(widgetId)}_param_${part(parameterName)}_title`;
+}
+export function widgetParameterOptionKey(widgetId, parameterName, optionValue, part = identity) {
+    return `voltra_widget_${part(widgetId)}_param_${part(parameterName)}_option_${part(optionValue)}`;
+}
+/**
+ * Every configuration-sheet string a widget declares, in declaration order. `part` sanitises each
+ * key segment (Android resource names allow only `[a-z0-9_]`).
+ */
+export function collectWidgetConfigurationStrings(widget, part = identity) {
+    const strings = [];
+    for (const parameter of widget.appIntent?.parameters ?? []) {
+        if (parameter.title !== undefined) {
+            strings.push({ key: widgetParameterTitleKey(widget.id, parameter.name, part), label: parameter.title });
+        }
+        for (const option of parameter.options ?? []) {
+            strings.push({
+                key: widgetParameterOptionKey(widget.id, parameter.name, option.value, part),
+                label: option.title,
+            });
+        }
+    }
+    return strings;
+}
+/** Locale keys used by any locale map among `labels`, `__default` excluded. */
+export function collectLabelLocaleKeys(labels) {
+    const keys = new Set();
+    for (const label of labels) {
+        if (label === undefined || !isWidgetLocalizedMap(label)) {
+            continue;
+        }
+        for (const [locale, value] of Object.entries(label)) {
+            if (locale !== '__default' && typeof value === 'string' && value.trim()) {
+                keys.add(locale);
+            }
+        }
+    }
+    return [...keys];
+}
+/**
+ * Validates `appIntent.parameters[]` (titles as plain strings or locale maps, and static
+ * `options`).
+ */
+export function validateWidgetConfigurationCopy(widget, options) {
+    const widgetId = widget.id;
+    const appIntent = widget.appIntent;
+    if (appIntent === undefined) {
+        return;
+    }
+    if (typeof appIntent !== 'object' || appIntent === null || !Array.isArray(appIntent.parameters)) {
+        throw new Error(`Widget '${widgetId}': appIntent.parameters must be an array`);
+    }
+    const names = new Set();
+    for (const [index, parameter] of appIntent.parameters.entries()) {
+        const context = `appIntent.parameters[${index}]`;
+        if (typeof parameter !== 'object' || parameter === null) {
+            throw new Error(`Widget '${widgetId}': ${context} must be an object`);
+        }
+        const { name, title, default: defaultValue, options: parameterOptions } = parameter;
+        if (typeof name !== 'string' || !name) {
+            throw new Error(`Widget '${widgetId}': ${context}.name must be a non-empty string`);
+        }
+        if ((options.requireIdentifierName ?? true) && !PARAMETER_NAME_PATTERN.test(name)) {
+            throw new Error(`Widget '${widgetId}': ${context}.name must start with a letter or underscore and contain only letters, digits and underscores`);
+        }
+        if (names.has(name)) {
+            throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' is declared more than once`);
+        }
+        names.add(name);
+        if (title === undefined) {
+            if (options.requireParameterTitle) {
+                throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' needs a title`);
+            }
+        }
+        else {
+            validateWidgetLabel(title, widgetId, `appIntent parameter '${name}' title`);
+        }
+        if (defaultValue !== undefined && typeof defaultValue !== 'string') {
+            throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' default must be a string`);
+        }
+        if (parameterOptions === undefined) {
+            continue;
+        }
+        if (!Array.isArray(parameterOptions) || parameterOptions.length === 0) {
+            throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' options must be a non-empty array`);
+        }
+        const values = new Set();
+        for (const option of parameterOptions) {
+            const value = option?.value;
+            if (typeof value !== 'string' || !value) {
+                throw new Error(`Widget '${widgetId}': every option of appIntent parameter '${name}' needs a string value`);
+            }
+            if (values.has(value)) {
+                throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' lists option '${value}' twice`);
+            }
+            values.add(value);
+            validateWidgetLabel(option.title, widgetId, `appIntent parameter '${name}' option '${value}' title`);
+        }
+        if (defaultValue !== undefined && !values.has(defaultValue)) {
+            throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' default '${defaultValue}' is not one of its options`);
+        }
+    }
+}
+//# sourceMappingURL=widgetConfiguration.js.map

package/build/esm/widgetConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgetConfiguration.js","sourceRoot":"","sources":["../../src/widgetConfiguration.ts"],"names":[],"mappings":"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"}

package/build/types/index.d.ts

@@ -1,6 +1,6 @@
 export { MAX_IMAGE_SIZE_BYTES } from './constants';
 export { getDynamicLiveActivityAttributesType } from './dynamic-live-activity';
-export type { DynamicWidgetEntryConfig, DynamicLiveActivityEntryConfig, DynamicLiveActivityManifest, DynamicLiveActivityManifestDefinition, DynamicWidgetManifest, DynamicWidgetManifestWidget, DynamicWidgetPlatform, WidgetInitialStatePath, WidgetLabel, WidgetLocalizedCopy, } from './types';
+export type { DynamicWidgetEntryConfig, DynamicLiveActivityEntryConfig, DynamicLiveActivityManifest, DynamicLiveActivityManifestDefinition, DynamicWidgetManifest, DynamicWidgetManifestWidget, DynamicWidgetPlatform, WidgetInitialStatePath, WidgetConfigurationCopySource, WidgetConfigurationOption, WidgetConfigurationParameter, WidgetLabel, WidgetLocalizedCopy, } from './types';
 export type { ServerUpdateIntervalResolution, ServerUpdateUrlResolution } from './serverUpdate';
 export { DYNAMIC_WIDGET_SERVER_UPDATE_INTERVAL_MINUTES, isLocalHttpHost, resolveServerUpdateInterval, resolveServerUpdateUrl, validateServerUpdateRefresh, } from './serverUpdate';
 export type { ResolvedWidgetServerUpdateConfig, WidgetServerUpdateConfig, WidgetServerUpdateRules, } from './widgetServerUpdate';
@@ -15,4 +15,6 @@ export type { PrerenderableWidget, PrerenderedWidgetStates, WidgetModuleEvaluati
 export { createPrerenderWidgetModuleLoader, evaluateWidgetModule, evaluateWidgetModuleExports, prerenderWidgetState, } from './utils/prerender';
 export type { WidgetModuleLoader, WidgetModulePlatform } from '@use-voltra/compiler';
 export { isWidgetLocalizedMap, widgetLabelEnglish } from './utils/widgetLabel';
+export type { WidgetConfigurationString } from './widgetConfiguration';
+export { collectLabelLocaleKeys, collectWidgetConfigurationStrings, validateWidgetConfigurationCopy, widgetParameterOptionKey, widgetParameterTitleKey, } from './widgetConfiguration';
 //# sourceMappingURL=index.d.ts.map

package/build/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAA;AAC9E,YAAY,EACV,wBAAwB,EACxB,8BAA8B,EAC9B,2BAA2B,EAC3B,qCAAqC,EACrC,qBAAqB,EACrB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAA;AAC/F,OAAO,EACL,6CAA6C,EAC7C,eAAe,EACf,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,gCAAgC,EAChC,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AAC5F,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAA;AACvE,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,EAC7B,cAAc,GACf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,iCAAiC,EACjC,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AACpF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAA;AAC9E,YAAY,EACV,wBAAwB,EACxB,8BAA8B,EAC9B,2BAA2B,EAC3B,qCAAqC,EACrC,qBAAqB,EACrB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,6BAA6B,EAC7B,yBAAyB,EACzB,4BAA4B,EAC5B,WAAW,EACX,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAA;AAC/F,OAAO,EACL,6CAA6C,EAC7C,eAAe,EACf,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,gCAAgC,EAChC,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AAC5F,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAA;AACvE,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,EAC7B,cAAc,GACf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,iCAAiC,EACjC,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AACpF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC9E,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AACtE,OAAO,EACL,sBAAsB,EACtB,iCAAiC,EACjC,+BAA+B,EAC/B,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,uBAAuB,CAAA"}

package/build/types/types.d.ts

@@ -49,6 +49,30 @@ export interface DynamicLiveActivityEntryConfig {
  */
 export type WidgetLocalizedCopy = Record<string, string>;
 export type WidgetLabel = string | WidgetLocalizedCopy;
+/**
+ * One value a configuration parameter offers. iOS shows `title` in a picker on the Edit Widget
+ * sheet; `env.configuration` receives `value`.
+ */
+export interface WidgetConfigurationOption {
+    value: string;
+    title: WidgetLabel;
+}
+/**
+ * The shape of `appIntent.parameters[]` both platform plugins share. iOS requires `title`.
+ */
+export interface WidgetConfigurationParameter {
+    name: string;
+    title?: WidgetLabel;
+    default?: string;
+    options?: WidgetConfigurationOption[];
+}
+/** The widget fields that carry configuration-sheet copy. */
+export interface WidgetConfigurationCopySource {
+    id: string;
+    appIntent?: {
+        parameters: WidgetConfigurationParameter[];
+    };
+}
 /**
  * Build-time widget initial state source: a single file path, or per-locale paths (same key rules as `WidgetLocalizedCopy`).
  * Each path must point to a module that exports the widget variants / default export for prerendering.

package/build/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,SAAS,CAAA;AAErD;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,CAAA;IACV,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,OAAO,EAAE,2BAA2B,EAAE,CAAA;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,qCAAqC;IACpD,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,CAAC,CAAA;IACV,QAAQ,EAAE,KAAK,CAAA;IACf,cAAc,EAAE,qCAAqC,EAAE,CAAA;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAExD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,mBAAmB,CAAA;AAEtD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,mBAAmB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,SAAS,CAAA;AAErD;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,CAAA;IACV,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,OAAO,EAAE,2BAA2B,EAAE,CAAA;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,qCAAqC;IACpD,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,CAAC,CAAA;IACV,QAAQ,EAAE,KAAK,CAAA;IACf,cAAc,EAAE,qCAAqC,EAAE,CAAA;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAExD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,mBAAmB,CAAA;AAEtD;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,WAAW,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,yBAAyB,EAAE,CAAA;CACtC;AAED,6DAA6D;AAC7D,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,CAAC,EAAE;QAAE,UAAU,EAAE,4BAA4B,EAAE,CAAA;KAAE,CAAA;CAC3D;AAED;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,mBAAmB,CAAA"}

package/build/types/utils/localePick.d.ts

@@ -1,7 +1,6 @@
 /**
- * Picks a localized string value from a locale-keyed map using the same fallback rules as iOS/Android runtimes:
- * preferred language tags (full match, then language-only), then `en`, then `__default`, then first value.
+ * Locale picking now lives in `@use-voltra/core` so widget code can use the same fallback rules
+ * at render time (`resolveLocale`). Re-exported here so existing imports keep working.
  */
-export declare function normalizeLocaleTag(tag: string): string;
-export declare function pickLocalizedValue(perLocale: Record<string, string>, preferredLanguages: string[]): string | undefined;
+export { normalizeLocaleTag, pickLocalizedValue } from '@use-voltra/core/locale';
 //# sourceMappingURL=localePick.d.ts.map

package/build/types/utils/localePick.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localePick.d.ts","sourceRoot":"","sources":["../../../src/utils/localePick.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,kBAAkB,EAAE,MAAM,EAAE,GAC3B,MAAM,GAAG,SAAS,CAyCpB"}
+{"version":3,"file":"localePick.d.ts","sourceRoot":"","sources":["../../../src/utils/localePick.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA"}

package/build/types/widgetConfiguration.d.ts

@@ -0,0 +1,31 @@
+import type { WidgetConfigurationCopySource, WidgetLabel } from './types';
+/**
+ * A string the operating system shows while the user configures a widget (ADR 0009 §6): a
+ * parameter title or an option label. `key` is the same on both platforms, apart from the
+ * resource-name sanitising Android needs.
+ */
+export interface WidgetConfigurationString {
+    key: string;
+    label: WidgetLabel;
+}
+type KeyPart = (value: string) => string;
+export declare function widgetParameterTitleKey(widgetId: string, parameterName: string, part?: KeyPart): string;
+export declare function widgetParameterOptionKey(widgetId: string, parameterName: string, optionValue: string, part?: KeyPart): string;
+/**
+ * Every configuration-sheet string a widget declares, in declaration order. `part` sanitises each
+ * key segment (Android resource names allow only `[a-z0-9_]`).
+ */
+export declare function collectWidgetConfigurationStrings(widget: WidgetConfigurationCopySource, part?: KeyPart): WidgetConfigurationString[];
+/** Locale keys used by any locale map among `labels`, `__default` excluded. */
+export declare function collectLabelLocaleKeys(labels: Iterable<WidgetLabel | undefined>): string[];
+/**
+ * Validates `appIntent.parameters[]` (titles as plain strings or locale maps, and static
+ * `options`).
+ */
+export declare function validateWidgetConfigurationCopy(widget: WidgetConfigurationCopySource, options: {
+    requireParameterTitle: boolean;
+    /** iOS compiles names into Swift properties; Android only uses them as keys. Default `true`. */
+    requireIdentifierName?: boolean;
+}): void;
+export {};
+//# sourceMappingURL=widgetConfiguration.d.ts.map

package/build/types/widgetConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgetConfiguration.d.ts","sourceRoot":"","sources":["../../src/widgetConfiguration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAOzE;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,WAAW,CAAA;CACnB;AAED,KAAK,OAAO,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;AAIxC,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,GAAE,OAAkB,GAAG,MAAM,CAEjH;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,OAAkB,GACvB,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,6BAA6B,EACrC,IAAI,GAAE,OAAkB,GACvB,yBAAyB,EAAE,CAgB7B;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,CAa1F;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,6BAA6B,EACrC,OAAO,EAAE;IACP,qBAAqB,EAAE,OAAO,CAAA;IAC9B,gGAAgG;IAChG,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,GACA,IAAI,CAwEN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@use-voltra/expo-plugin",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "Shared utilities for Voltra Expo config plugins",
   "main": "build/cjs/index.js",
   "module": "build/esm/index.js",
@@ -20,8 +20,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@use-voltra/compiler": "^2.3.1",
-    "@use-voltra/core": "^2.3.1"
+    "@use-voltra/compiler": "^2.4.0",
+    "@use-voltra/core": "^2.4.0"
   },
   "keywords": [
     "voltra",

package/src/index.ts

@@ -9,6 +9,9 @@ export type {
   DynamicWidgetManifestWidget,
   DynamicWidgetPlatform,
   WidgetInitialStatePath,
+  WidgetConfigurationCopySource,
+  WidgetConfigurationOption,
+  WidgetConfigurationParameter,
   WidgetLabel,
   WidgetLocalizedCopy,
 } from './types'
@@ -53,3 +56,11 @@ export {
 } from './utils/prerender'
 export type { WidgetModuleLoader, WidgetModulePlatform } from '@use-voltra/compiler'
 export { isWidgetLocalizedMap, widgetLabelEnglish } from './utils/widgetLabel'
+export type { WidgetConfigurationString } from './widgetConfiguration'
+export {
+  collectLabelLocaleKeys,
+  collectWidgetConfigurationStrings,
+  validateWidgetConfigurationCopy,
+  widgetParameterOptionKey,
+  widgetParameterTitleKey,
+} from './widgetConfiguration'

package/src/types.ts

@@ -59,6 +59,31 @@ export type WidgetLocalizedCopy = Record<string, string>
 
 export type WidgetLabel = string | WidgetLocalizedCopy
 
+/**
+ * One value a configuration parameter offers. iOS shows `title` in a picker on the Edit Widget
+ * sheet; `env.configuration` receives `value`.
+ */
+export interface WidgetConfigurationOption {
+  value: string
+  title: WidgetLabel
+}
+
+/**
+ * The shape of `appIntent.parameters[]` both platform plugins share. iOS requires `title`.
+ */
+export interface WidgetConfigurationParameter {
+  name: string
+  title?: WidgetLabel
+  default?: string
+  options?: WidgetConfigurationOption[]
+}
+
+/** The widget fields that carry configuration-sheet copy. */
+export interface WidgetConfigurationCopySource {
+  id: string
+  appIntent?: { parameters: WidgetConfigurationParameter[] }
+}
+
 /**
  * Build-time widget initial state source: a single file path, or per-locale paths (same key rules as `WidgetLocalizedCopy`).
  * Each path must point to a module that exports the widget variants / default export for prerendering.

package/src/utils/localePick.ts

@@ -1,53 +1,5 @@
 /**
- * Picks a localized string value from a locale-keyed map using the same fallback rules as iOS/Android runtimes:
- * preferred language tags (full match, then language-only), then `en`, then `__default`, then first value.
+ * Locale picking now lives in `@use-voltra/core` so widget code can use the same fallback rules
+ * at render time (`resolveLocale`). Re-exported here so existing imports keep working.
  */
-export function normalizeLocaleTag(tag: string): string {
-  return tag.trim().toLowerCase().replace(/_/g, '-')
-}
-
-export function pickLocalizedValue(
-  perLocale: Record<string, string>,
-  preferredLanguages: string[]
-): string | undefined {
-  const entries = Object.entries(perLocale).filter(([, v]) => typeof v === 'string' && v.length > 0)
-  if (entries.length === 0) {
-    return undefined
-  }
-
-  const byNorm = new Map<string, string>()
-  for (const [k, v] of entries) {
-    byNorm.set(normalizeLocaleTag(k), v)
-  }
-
-  const DEFAULT_KEY = '__default'
-
-  for (const pref of preferredLanguages) {
-    const n = normalizeLocaleTag(pref)
-    const direct = byNorm.get(n)
-    if (direct !== undefined) {
-      return direct
-    }
-    const lang = n.split('-')[0] ?? n
-    for (const [key, val] of entries) {
-      const kn = normalizeLocaleTag(key)
-      const keyLang = kn.split('-')[0] ?? kn
-      if (keyLang === lang) {
-        return val
-      }
-    }
-  }
-
-  const en = byNorm.get('en') ?? entries.find(([k]) => normalizeLocaleTag(k) === 'en')?.[1]
-  if (en !== undefined) {
-    return en
-  }
-
-  const defaultVal = byNorm.get(DEFAULT_KEY) ?? entries.find(([k]) => k === DEFAULT_KEY)?.[1]
-  if (defaultVal !== undefined) {
-    return defaultVal
-  }
-
-  const sorted = [...entries].sort(([a], [b]) => a.localeCompare(b))
-  return sorted[0]?.[1]
-}
+export { normalizeLocaleTag, pickLocalizedValue } from '@use-voltra/core/locale'

package/src/widgetConfiguration.node.test.ts

@@ -0,0 +1,96 @@
+import { collectWidgetConfigurationStrings, validateWidgetConfigurationCopy } from './widgetConfiguration'
+
+const widget = {
+  id: 'Weather',
+  appIntent: {
+    parameters: [
+      {
+        name: 'units',
+        title: { en: 'Units', pl: 'Jednostki' },
+        default: 'metric',
+        options: [
+          { value: 'metric', title: { en: 'Metric', pl: 'Metryczne' } },
+          { value: 'us-customary', title: 'US customary' },
+        ],
+      },
+      { name: 'city', default: 'Warsaw' },
+    ],
+  },
+}
+
+describe('collectWidgetConfigurationStrings', () => {
+  it('lists parameter titles and option labels under stable keys', () => {
+    expect(collectWidgetConfigurationStrings(widget).map(({ key }) => key)).toEqual([
+      'voltra_widget_Weather_param_units_title',
+      'voltra_widget_Weather_param_units_option_metric',
+      'voltra_widget_Weather_param_units_option_us-customary',
+    ])
+  })
+
+  it('sanitises every key segment with the given function', () => {
+    const android = (value: string) => value.toLowerCase().replace(/[^a-z0-9_]/g, '_')
+    expect(collectWidgetConfigurationStrings(widget, android).map(({ key }) => key)).toContain(
+      'voltra_widget_weather_param_units_option_us_customary'
+    )
+  })
+})
+
+describe('validateWidgetConfigurationCopy', () => {
+  it('accepts locale-map titles and static options', () => {
+    expect(() => validateWidgetConfigurationCopy(widget, { requireParameterTitle: false })).not.toThrow()
+  })
+
+  it('requires a title on iOS', () => {
+    expect(() => validateWidgetConfigurationCopy(widget, { requireParameterTitle: true })).toThrow(
+      "appIntent parameter 'city' needs a title"
+    )
+  })
+
+  it('rejects a default that is not one of the options', () => {
+    const invalid = {
+      id: 'w',
+      appIntent: {
+        parameters: [{ name: 'units', title: 'Units', default: 'kelvin', options: [{ value: 'metric', title: 'M' }] }],
+      },
+    }
+    expect(() => validateWidgetConfigurationCopy(invalid, { requireParameterTitle: true })).toThrow(
+      "default 'kelvin' is not one of its options"
+    )
+  })
+
+  it('rejects duplicate option values, invalid names and bad locale maps', () => {
+    const base = { id: 'w' }
+    expect(() =>
+      validateWidgetConfigurationCopy(
+        {
+          ...base,
+          appIntent: {
+            parameters: [
+              {
+                name: 'units',
+                title: 'Units',
+                options: [
+                  { value: 'a', title: 'A' },
+                  { value: 'a', title: 'B' },
+                ],
+              },
+            ],
+          },
+        },
+        { requireParameterTitle: true }
+      )
+    ).toThrow("lists option 'a' twice")
+    expect(() =>
+      validateWidgetConfigurationCopy(
+        { ...base, appIntent: { parameters: [{ name: 'my-param', title: 'x' }] } },
+        { requireParameterTitle: true }
+      )
+    ).toThrow('.name must start with a letter')
+    expect(() =>
+      validateWidgetConfigurationCopy(
+        { ...base, appIntent: { parameters: [{ name: 'units', title: {} }] } },
+        { requireParameterTitle: true }
+      )
+    ).toThrow("appIntent parameter 'units' title locale map must not be empty")
+  })
+})

package/src/widgetConfiguration.ts

@@ -0,0 +1,159 @@
+import type { WidgetConfigurationCopySource, WidgetLabel } from './types'
+import { isWidgetLocalizedMap } from './utils/widgetLabel'
+import { validateWidgetLabel } from './validation'
+
+/** Swift property / Kotlin-safe identifier, also the key under `env.configuration`. */
+const PARAMETER_NAME_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/
+
+/**
+ * A string the operating system shows while the user configures a widget (ADR 0009 §6): a
+ * parameter title or an option label. `key` is the same on both platforms, apart from the
+ * resource-name sanitising Android needs.
+ */
+export interface WidgetConfigurationString {
+  key: string
+  label: WidgetLabel
+}
+
+type KeyPart = (value: string) => string
+
+const identity: KeyPart = (value) => value
+
+export function widgetParameterTitleKey(widgetId: string, parameterName: string, part: KeyPart = identity): string {
+  return `voltra_widget_${part(widgetId)}_param_${part(parameterName)}_title`
+}
+
+export function widgetParameterOptionKey(
+  widgetId: string,
+  parameterName: string,
+  optionValue: string,
+  part: KeyPart = identity
+): string {
+  return `voltra_widget_${part(widgetId)}_param_${part(parameterName)}_option_${part(optionValue)}`
+}
+
+/**
+ * Every configuration-sheet string a widget declares, in declaration order. `part` sanitises each
+ * key segment (Android resource names allow only `[a-z0-9_]`).
+ */
+export function collectWidgetConfigurationStrings(
+  widget: WidgetConfigurationCopySource,
+  part: KeyPart = identity
+): WidgetConfigurationString[] {
+  const strings: WidgetConfigurationString[] = []
+
+  for (const parameter of widget.appIntent?.parameters ?? []) {
+    if (parameter.title !== undefined) {
+      strings.push({ key: widgetParameterTitleKey(widget.id, parameter.name, part), label: parameter.title })
+    }
+    for (const option of parameter.options ?? []) {
+      strings.push({
+        key: widgetParameterOptionKey(widget.id, parameter.name, option.value, part),
+        label: option.title,
+      })
+    }
+  }
+
+  return strings
+}
+
+/** Locale keys used by any locale map among `labels`, `__default` excluded. */
+export function collectLabelLocaleKeys(labels: Iterable<WidgetLabel | undefined>): string[] {
+  const keys = new Set<string>()
+  for (const label of labels) {
+    if (label === undefined || !isWidgetLocalizedMap(label)) {
+      continue
+    }
+    for (const [locale, value] of Object.entries(label)) {
+      if (locale !== '__default' && typeof value === 'string' && value.trim()) {
+        keys.add(locale)
+      }
+    }
+  }
+  return [...keys]
+}
+
+/**
+ * Validates `appIntent.parameters[]` (titles as plain strings or locale maps, and static
+ * `options`).
+ */
+export function validateWidgetConfigurationCopy(
+  widget: WidgetConfigurationCopySource,
+  options: {
+    requireParameterTitle: boolean
+    /** iOS compiles names into Swift properties; Android only uses them as keys. Default `true`. */
+    requireIdentifierName?: boolean
+  }
+): void {
+  const widgetId = widget.id
+
+  const appIntent = widget.appIntent as unknown
+  if (appIntent === undefined) {
+    return
+  }
+  if (typeof appIntent !== 'object' || appIntent === null || !Array.isArray((appIntent as any).parameters)) {
+    throw new Error(`Widget '${widgetId}': appIntent.parameters must be an array`)
+  }
+
+  const names = new Set<string>()
+  for (const [index, parameter] of (appIntent as { parameters: unknown[] }).parameters.entries()) {
+    const context = `appIntent.parameters[${index}]`
+    if (typeof parameter !== 'object' || parameter === null) {
+      throw new Error(`Widget '${widgetId}': ${context} must be an object`)
+    }
+    const { name, title, default: defaultValue, options: parameterOptions } = parameter as Record<string, unknown>
+
+    if (typeof name !== 'string' || !name) {
+      throw new Error(`Widget '${widgetId}': ${context}.name must be a non-empty string`)
+    }
+    if ((options.requireIdentifierName ?? true) && !PARAMETER_NAME_PATTERN.test(name)) {
+      throw new Error(
+        `Widget '${widgetId}': ${context}.name must start with a letter or underscore and contain only letters, digits and underscores`
+      )
+    }
+    if (names.has(name)) {
+      throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' is declared more than once`)
+    }
+    names.add(name)
+
+    if (title === undefined) {
+      if (options.requireParameterTitle) {
+        throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' needs a title`)
+      }
+    } else {
+      validateWidgetLabel(title, widgetId, `appIntent parameter '${name}' title`)
+    }
+
+    if (defaultValue !== undefined && typeof defaultValue !== 'string') {
+      throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' default must be a string`)
+    }
+
+    if (parameterOptions === undefined) {
+      continue
+    }
+    if (!Array.isArray(parameterOptions) || parameterOptions.length === 0) {
+      throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' options must be a non-empty array`)
+    }
+    const values = new Set<string>()
+    for (const option of parameterOptions) {
+      const value = (option as Record<string, unknown> | null)?.value
+      if (typeof value !== 'string' || !value) {
+        throw new Error(`Widget '${widgetId}': every option of appIntent parameter '${name}' needs a string value`)
+      }
+      if (values.has(value)) {
+        throw new Error(`Widget '${widgetId}': appIntent parameter '${name}' lists option '${value}' twice`)
+      }
+      values.add(value)
+      validateWidgetLabel(
+        (option as Record<string, unknown>).title,
+        widgetId,
+        `appIntent parameter '${name}' option '${value}' title`
+      )
+    }
+    if (defaultValue !== undefined && !values.has(defaultValue)) {
+      throw new Error(
+        `Widget '${widgetId}': appIntent parameter '${name}' default '${defaultValue}' is not one of its options`
+      )
+    }
+  }
+}