@aidc-toolkit/app-extension 1.0.32-beta → 1.0.33-beta

package/src/gs1/prefix-manager-proxy.ts

@@ -1,8 +1,14 @@
 import type { Nullishable } from "@aidc-toolkit/core";
-import { type GCPLengthData, PrefixManager, type PrefixType, RemoteGCPLengthCache } from "@aidc-toolkit/gs1";
-import type { AppData } from "../app-data.js";
-import { AppExtension } from "../app-extension.js";
-import { type ExtendsParameterDescriptor, type ParameterDescriptor, Types } from "../descriptor.js";
+import {
+    type GCPLengthCache,
+    type GCPLengthData,
+    PrefixManager,
+    type PrefixType,
+    RemoteGCPLengthCache
+} from "@aidc-toolkit/gs1";
+import type { Logger } from "tslog";
+import type { AppExtension } from "../app-extension.js";
+import { type ExtendsParameterDescriptor, Multiplicities, type ParameterDescriptor, Types } from "../descriptor.js";
 import { LibProxy } from "../lib-proxy.js";
 import { proxy } from "../proxy.js";
 import type { ErrorExtends, Matrix, MatrixResult, SingletonResult } from "../type.js";
@@ -12,21 +18,21 @@ import { validateIdentifierType } from "./identifier-type.js";
 const prefixParameterDescriptor: ParameterDescriptor = {
     name: "prefix",
     type: Types.String,
-    isMatrix: false,
+    multiplicity: Multiplicities.Singleton,
     isRequired: true
 };
 
 const prefixTypeParameterDescriptor: ParameterDescriptor = {
     name: "prefixType",
     type: Types.Number,
-    isMatrix: false,
+    multiplicity: Multiplicities.Singleton,
     isRequired: false
 };
 
 const tweakFactorParameterDescriptor: ParameterDescriptor = {
     name: "tweakFactor",
     type: Types.Number,
-    isMatrix: false,
+    multiplicity: Multiplicities.Singleton,
     isRequired: false
 };
 
@@ -35,50 +41,14 @@ const gcpLengthIdentifierParameterDescriptor: ExtendsParameterDescriptor = {
     name: "gcpLengthIdentifier"
 };
 
-/**
- * GS1 Company Prefix length application data.
- */
-interface GCPLengthAppData {
-    /**
-     * Next check date/time.
-     */
-    nextCheckDateTime: Date | undefined;
-
-    /**
-     * GS1 Company Prefix length data.
-     */
-    gcpLengthData: GCPLengthData | undefined;
-}
-
-/**
- * Determine if data object is GS1 Company Prefix length application data.
- *
- * @param data
- * Data object.
- *
- * @returns
- * True if data object is GS1 Company Prefix length application data.
- */
-function isGCPLengthAppData(data: AppData | undefined): data is GCPLengthAppData {
-    // Property type check is necessary to guard against data corruption or changes in format.
-    return typeof data === "object" && "nextCheckDateTime" in data && data.nextCheckDateTime instanceof Date;
-}
-
 /**
  * Application extension GCP length cache. Data is stored in application extension shared data.
  */
 class AppExtensionGCPLengthCache<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TStreamingInvocationContext, TBigInt> extends RemoteGCPLengthCache {
     /**
-     * GS1 Company Prefix length data property name.
+     * Logger.
      */
-    static readonly #GCP_LENGTH_DATA_NAME = `${AppExtension.APPLICATION_NAME_PREFIX}gcpLength`;
-
-    /**
-     * Application extension.
-     */
-    readonly #appExtension: AppExtension<ThrowError, TError, TInvocationContext, TStreamingInvocationContext, TBigInt>;
-
-    #gcpLengthAppData?: GCPLengthAppData | undefined;
+    readonly #logger: Logger<object>;
 
     /**
      * Constructor.
@@ -87,61 +57,58 @@ class AppExtensionGCPLengthCache<ThrowError extends boolean, TError extends Erro
      * Application extension.
      */
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TStreamingInvocationContext, TBigInt>) {
-        super();
-
-        this.#appExtension = appExtension;
-    }
-    
-    async initialize(): Promise<void> {
-        const gcpLengthAppData = await this.#appExtension.getSharedData(AppExtensionGCPLengthCache.#GCP_LENGTH_DATA_NAME);
-
-        if (isGCPLengthAppData(gcpLengthAppData)) {
-            this.#gcpLengthAppData = gcpLengthAppData;
+        super(appExtension.sharedAppDataStorage);
 
-            this.#appExtension.logger.trace("GS1 Company Prefix length data loaded from shared data");
-        }
+        this.#logger = appExtension.logger;
     }
 
-    get nextCheckDateTime(): Date | undefined {
-        const nextCheckDateTime = this.#gcpLengthAppData?.nextCheckDateTime;
-
-        this.#appExtension.logger.debug(`GS1 Company Prefix length next check date/time ${nextCheckDateTime?.toISOString()}`);
+    /**
+     * @inheritDoc
+     */
+    override get nextCheckDateTime(): Promise<Date | undefined> {
+        return super.nextCheckDateTime.then((nextCheckDateTime) => {
+            this.#logger.debug(`GS1 Company Prefix length next check date/time ${nextCheckDateTime?.toISOString()}`);
 
-        return nextCheckDateTime;
+            return nextCheckDateTime;
+        });
     }
 
-    get cacheDateTime(): Date | undefined {
-        const cacheDateTime = this.#gcpLengthAppData?.gcpLengthData?.dateTime;
-
-        this.#appExtension.logger.debug(`GS1 Company Prefix length cache date/time ${cacheDateTime?.toISOString()}`);
+    /**
+     * @inheritDoc
+     */
+    override get cacheDateTime(): Promise<Date | undefined> {
+        return super.cacheDateTime.then((cacheDateTime) => {
+            this.#logger.debug(`GS1 Company Prefix length cache date/time ${cacheDateTime?.toISOString()}`);
 
-        return cacheDateTime;
+            return cacheDateTime;
+        });
     }
 
-    get cacheData(): GCPLengthData {
-        this.#appExtension.logger.debug("GS1 Company Prefix length cache data retrieved");
-
-        const gcpLengthData = this.#gcpLengthAppData?.gcpLengthData;
+    override get cacheData(): Promise<GCPLengthData> {
+        return super.cacheData.then((cacheData) => {
+            this.#logger.debug("GS1 Company Prefix length cache data retrieved");
 
-        if (gcpLengthData === undefined) {
-            // Application bug; localization not necessary.
-            throw new Error("Cache data not defined");
-        }
-
-        return gcpLengthData;
+            return cacheData;
+        });
     }
 
+    /**
+     * @inheritDoc
+     */
     override get sourceDateTime(): Promise<Date> {
         return super.sourceDateTime.then((sourceDateTime) => {
-            this.#appExtension.logger.debug(`GS1 Company Prefix source date/time ${sourceDateTime.toISOString()}`);
+            this.#logger.debug(`GS1 Company Prefix source date/time ${sourceDateTime.toISOString()}`);
 
             return sourceDateTime;
         });
     }
 
+    /**
+     * @inheritDoc
+     */
     override get sourceData(): Promise<GCPLengthData> {
         return super.sourceData.then((sourceData) => {
-            this.#appExtension.logger.debug("GS1 Company Prefix length source data retrieved");
+            this.#logger.debug("GS1 Company Prefix length source data retrieved");
 
             return sourceData;
         });
@@ -150,27 +117,29 @@ class AppExtensionGCPLengthCache<ThrowError extends boolean, TError extends Erro
     /**
      * @inheritDoc
      */
-    async update(nextCheckDateTime: Date, _cacheDateTime?: Date, cacheData?: GCPLengthData): Promise<void> {
-        this.#gcpLengthAppData = {
-            nextCheckDateTime,
-            gcpLengthData: cacheData ?? this.#gcpLengthAppData?.gcpLengthData
-        };
-
-        await this.#appExtension.setSharedData(AppExtensionGCPLengthCache.#GCP_LENGTH_DATA_NAME, this.#gcpLengthAppData);
-
-        this.#appExtension.logger.trace(`GS1 Company Prefix length saved to shared data with next check date/time ${nextCheckDateTime.toISOString()}`);
+    override async update(nextCheckDateTime: Date, cacheDateTime?: Date, cacheData?: GCPLengthData): Promise<void> {
+        return super.update(nextCheckDateTime, cacheDateTime, cacheData).then(() => {
+            this.#logger.trace(`GS1 Company Prefix length saved to shared data with next check date/time ${nextCheckDateTime.toISOString()}`);
+        });
     }
 }
 
 @proxy.describeClass(false, {
-    namespace: "GS1"
+    namespace: "GS1",
+    category: "prefix"
 })
 export class PrefixManagerProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TStreamingInvocationContext, TBigInt> extends LibProxy<ThrowError, TError, TInvocationContext, TStreamingInvocationContext, TBigInt> {
-    #gcpLengthCache?: AppExtensionGCPLengthCache<ThrowError, TError, TInvocationContext, TStreamingInvocationContext, TBigInt>;
+    readonly #gcpLengthCache: GCPLengthCache;
     
+    constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TStreamingInvocationContext, TBigInt>) {
+        super(appExtension);
+        
+        this.#gcpLengthCache = new AppExtensionGCPLengthCache(appExtension);
+    }
+
     @proxy.describeMethod({
         type: Types.Any,
-        isMatrix: true,
+        multiplicity: Multiplicities.SingletonArray,
         parameterDescriptors: [prefixParameterDescriptor, prefixTypeParameterDescriptor, tweakFactorParameterDescriptor]
     })
     definePrefix(prefix: string, prefixType: Nullishable<PrefixType>, tweakFactor: Nullishable<number>): Matrix<unknown> {
@@ -180,58 +149,49 @@ export class PrefixManagerProxy<ThrowError extends boolean, TError extends Error
 
     /**
      * Load GS1 Company Prefix length data.
+     *
+     * @returns
+     * Void promise.
      */
     async #loadGCPLengthData(): Promise<void> {
-        const appExtension = this.appExtension;
-
-        if (this.#gcpLengthCache === undefined) {
-            this.#gcpLengthCache = new AppExtensionGCPLengthCache(this.appExtension);
-
-            await this.#gcpLengthCache.initialize();
-        }
-
-        const gcpLengthCache = this.#gcpLengthCache;
-
-        await PrefixManager.loadGCPLengthData(gcpLengthCache).catch((e: unknown) => {
-            // Swallow error and log it.
-            appExtension.logger.error("Load GS1 Company Prefix length data failed", e);
+        return PrefixManager.loadGCPLengthData(this.#gcpLengthCache).catch((e: unknown) => {
+            // Log and swallow error.
+            this.appExtension.logger.error("Load GS1 Company Prefix length data failed", e);
         });
     }
 
     @proxy.describeMethod({
         type: Types.Number,
-        isMatrix: true,
+        multiplicity: Multiplicities.Matrix,
         parameterDescriptors: [identifierTypeParameterDescriptor, gcpLengthIdentifierParameterDescriptor]
     })
     async gcpLength(identifierType: string, matrixIdentifiers: Matrix<string>): Promise<MatrixResult<number, ThrowError, TError>> {
-        await this.#loadGCPLengthData();
-
-        return this.setUpMatrixResult(() =>
-            validateIdentifierType(identifierType),
-        matrixIdentifiers, (validatedIdentifierType, identifier) =>
-            PrefixManager.gcpLength(validatedIdentifierType, identifier)
-        );
+        return this.#loadGCPLengthData().then(() => this.setUpMatrixResult(
+            () => validateIdentifierType(identifierType),
+            matrixIdentifiers,
+            (validatedIdentifierType, identifier) => PrefixManager.gcpLength(validatedIdentifierType, identifier)
+        ));
     }
 
     @proxy.describeMethod({
         type: Types.String,
-        isMatrix: false,
+        multiplicity: Multiplicities.Singleton,
         parameterDescriptors: []
     })
     async gcpLengthDateTime(): Promise<SingletonResult<string, ThrowError, TError>> {
-        await this.#loadGCPLengthData();
-
-        return this.singletonResult(() => PrefixManager.gcpLengthDateTime().toISOString());
+        return this.#loadGCPLengthData().then(() =>
+            this.singletonResult(() => PrefixManager.gcpLengthDateTime().toISOString())
+        );
     }
 
     @proxy.describeMethod({
         type: Types.String,
-        isMatrix: false,
+        multiplicity: Multiplicities.Singleton,
         parameterDescriptors: []
     })
     async gcpLengthDisclaimer(): Promise<SingletonResult<string, ThrowError, TError>> {
-        await this.#loadGCPLengthData();
-
-        return this.singletonResult(() => PrefixManager.gcpLengthDisclaimer());
+        return this.#loadGCPLengthData().then(() =>
+            this.singletonResult(() => PrefixManager.gcpLengthDisclaimer())
+        );
     }
 }

package/src/gs1/service-proxy.ts

@@ -1,6 +1,6 @@
 import { isNullish, type Nullishable } from "@aidc-toolkit/core";
 import { verifiedByGS1 } from "@aidc-toolkit/gs1";
-import { type ExtendsParameterDescriptor, type ParameterDescriptor, Types } from "../descriptor.js";
+import { type ExtendsParameterDescriptor, Multiplicities, type ParameterDescriptor, Types } from "../descriptor.js";
 import { LibProxy } from "../lib-proxy.js";
 import { proxy } from "../proxy.js";
 import type { ErrorExtends, Matrix, MatrixResult } from "../type.js";
@@ -15,24 +15,25 @@ const hyperlinkIdentifierParameterDescriptor: ExtendsParameterDescriptor = {
 const hyperlinkTextParameterDescriptor: ParameterDescriptor = {
     name: "hyperlinkText",
     type: Types.String,
-    isMatrix: false,
+    multiplicity: Multiplicities.Singleton,
     isRequired: false
 };
 
 const hyperlinkDetailsParameterDescriptor: ParameterDescriptor = {
     name: "hyperlinkDetails",
     type: Types.String,
-    isMatrix: false,
+    multiplicity: Multiplicities.Singleton,
     isRequired: false
 };
 
 @proxy.describeClass(false, {
-    namespace: "GS1"
+    namespace: "GS1",
+    category: "service"
 })
 export class ServiceProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TStreamingInvocationContext, TBigInt> extends LibProxy<ThrowError, TError, TInvocationContext, TStreamingInvocationContext, TBigInt> {
     @proxy.describeMethod({
         type: Types.Any,
-        isMatrix: true,
+        multiplicity: Multiplicities.Matrix,
         requiresContext: true,
         parameterDescriptors: [
             identifierTypeParameterDescriptor,

package/src/gs1/variable-measure-proxy.ts

@@ -1,5 +1,5 @@
 import { VariableMeasure } from "@aidc-toolkit/gs1";
-import { type ParameterDescriptor, Types } from "../descriptor.js";
+import { Multiplicities, type ParameterDescriptor, Types } from "../descriptor.js";
 import { LibProxy } from "../lib-proxy.js";
 import { proxy } from "../proxy.js";
 import type { ErrorExtends, Matrix, MatrixResult } from "../type.js";
@@ -7,38 +7,39 @@ import type { ErrorExtends, Matrix, MatrixResult } from "../type.js";
 const rcnFormatParameterDescriptor: ParameterDescriptor = {
     name: "rcnFormat",
     type: Types.String,
-    isMatrix: false,
+    multiplicity: Multiplicities.Singleton,
     isRequired: true
 };
 
 const rcnParameterDescriptor: ParameterDescriptor = {
     name: "rcn",
     type: Types.String,
-    isMatrix: true,
+    multiplicity: Multiplicities.Array,
     isRequired: true
 };
 
 const rcnItemReferenceParameterDescriptor: ParameterDescriptor = {
     name: "rcnItemReference",
     type: Types.Number,
-    isMatrix: false,
+    multiplicity: Multiplicities.Singleton,
     isRequired: true
 };
 
 const rcnPriceOrWeightParameterDescriptor: ParameterDescriptor = {
     name: "rcnPriceOrWeight",
     type: Types.Number,
-    isMatrix: true,
+    multiplicity: Multiplicities.Matrix,
     isRequired: true
 };
 
 @proxy.describeClass(false, {
-    namespace: "GS1"
+    namespace: "GS1",
+    category: "variableMeasure"
 })
 export class VariableMeasureProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TStreamingInvocationContext, TBigInt> extends LibProxy<ThrowError, TError, TInvocationContext, TStreamingInvocationContext, TBigInt> {
     @proxy.describeMethod({
         type: Types.Number,
-        isMatrix: true,
+        multiplicity: Multiplicities.Matrix,
         parameterDescriptors: [rcnFormatParameterDescriptor, rcnParameterDescriptor]
     })
     parseVariableMeasureRCN(format: string, matrixRCNs: Matrix<string>): MatrixResult<number, ThrowError, TError> {
@@ -51,7 +52,7 @@ export class VariableMeasureProxy<ThrowError extends boolean, TError extends Err
 
     @proxy.describeMethod({
         type: Types.String,
-        isMatrix: true,
+        multiplicity: Multiplicities.Matrix,
         ignoreInfix: true,
         parameterDescriptors: [rcnFormatParameterDescriptor, rcnItemReferenceParameterDescriptor, rcnPriceOrWeightParameterDescriptor]
     })

package/src/index.ts

@@ -17,14 +17,13 @@
 export * from "./locale/i18n.js";
 
 export type * from "./type.js";
-export * from "./app-data.js";
 
 export type * from "./streaming.js";
 export * from "./app-extension.js";
 export * from "./lib-proxy.js";
 
 export * from "./descriptor.js";
-export * from "./app-utility-proxy.js";
+export * from "./app-helper-proxy.js";
 export * from "./utility/index.js";
 export * as GS1 from "./gs1/index.js";
 

package/src/locale/en/locale-resources.ts

@@ -5,6 +5,19 @@ export default {
     Proxy: {
         matrixMustBeArray: "Input matrix must be one-dimensional"
     },
+    Categories: {
+        helper: "Helper",
+        transformation: "Transformation",
+        string: "String",
+        GS1: {
+            checkCharacter: "Check character",
+            identifierValidation: "Identifier validation",
+            identifierCreation: "Identifier creation",
+            variableMeasure: "Variable measure",
+            prefix: "Prefix",
+            service: "Service"
+        }
+    },
     IdentifierCreatorProxy: {
         prefixDefinitionMustBeOneDimensional: "Prefix definition must be a one-dimensional matrix",
         prefixDefinitionMustHaveMaximumThreeElements: "Prefix definition must have a maximum of 3 elements",
@@ -17,21 +30,21 @@ export default {
         invalidIdentifierType: "Invalid identifier type \"{{identifierType}}\""
     },
     Parameters: {
-        spillMatrix: {
-            name: "matrix",
-            description: "One-dimensional matrix to spill."
+        spillArray: {
+            name: "array",
+            description: "Array to spill."
         },
         spillMaximumWidth: {
             name: "maximumWidth",
-            description: "Maximum width into which to spill the matrix. If not provided, the remaining sheet width is used."
+            description: "Maximum width into which to spill the array. If not provided, the remaining sheet width is used."
         },
         spillMaximumHeight: {
             name: "maximumHeight",
-            description: "Maximum height into which to spill the matrix. If not provided, the remaining sheet height is used."
+            description: "Maximum height into which to spill the array. If not provided, the remaining sheet height is used."
         },
         domain: {
             name: "domain",
-            description: "Transformation domain. Valid input values are from zero to domain-1."
+            description: "Transformation domain. Valid input values are from *0* to *domain-1*."
         },
         value: {
             name: "value",
@@ -43,7 +56,7 @@ export default {
         },
         count: {
             name: "count",
-            description: "Count of values to transform. If positive, values transformed are startValue to startValue+count-1. If negative, values transformed are startValue down to startValue+count+1."
+            description: "Count of values to transform. If positive, values transformed are *startValue* to *startValue+count-1*. If negative, values transformed are *startValue* down to *startValue+count+1*."
         },
         transformedValue: {
             name: "transformedValue",
@@ -71,19 +84,19 @@ export default {
         },
         exclusionNone: {
             name: "exclusion",
-            description: "String values to exclude. The only valid value is 0 (no exclusions)."
+            description: "String values to exclude. The only valid value is *0* (no exclusions)."
         },
         exclusionFirstZero: {
             name: "exclusion",
-            description: "String values to exclude. Valid values are 0 (no exclusions) and 1 (strings starting with 0 excluded)."
+            description: "String values to exclude. Valid values are *0* (no exclusions) and *1* (strings starting with 0 excluded)."
         },
         exclusionAllNumeric: {
             name: "exclusion",
-            description: "String values to exclude. Valid values are 0 (no exclusions) and 2 (strings that are all numeric excluded)."
+            description: "String values to exclude. Valid values are *0* (no exclusions) and *2* (strings that are all numeric excluded)."
         },
         exclusionAny: {
             name: "exclusion",
-            description: "String values to exclude. Valid values are 0 (no exclusions), 1 (strings starting with 0 excluded), and 2 (strings that are all numeric excluded)."
+            description: "String values to exclude. Valid values are *0* (no exclusions), *1* (strings starting with 0 excluded), and *2* (strings that are all numeric excluded)."
         },
         length: {
             name: "length",
@@ -163,7 +176,7 @@ export default {
         },
         gtinLevel: {
             name: "level",
-            description: "Level at which to validate the GTIN. Valid values are 0 (any), 1 (retail consumer trade item), and 2 (other than retail consumer trade item level)."
+            description: "Level at which to validate the GTIN. Valid values are *0* (any), *1* (retail consumer trade item), and *2* (other than retail consumer trade item level)."
         },
         prefix: {
             name: "prefix",
@@ -171,7 +184,7 @@ export default {
         },
         prefixType: {
             name: "prefixType",
-            description: "Prefix type. Valid values are 0 (GS1 Company Prefix), 1 (U.P.C. Company Prefix), and 2 (GS1 Prefix)."
+            description: "Prefix type. Valid values are *0* (GS1 Company Prefix), *1* (U.P.C. Company Prefix), and *2* (GS1 Prefix)."
         },
         tweakFactor: {
             name: "tweakFactor",
@@ -183,11 +196,11 @@ export default {
         },
         prefixDefinitionAny: {
             name: "prefixDefinition",
-            description: "Prefix definition, either a simple GS1 Company Prefix (as a string) or the result of a call to definePrefix. Any prefix type is supported."
+            description: "Prefix definition, either a simple GS1 Company Prefix (as a string) or the result of a call to *definePrefix*. Any prefix type is supported."
         },
         prefixDefinitionGS1UPC: {
             name: "prefixDefinition",
-            description: "Prefix definition, either a simple GS1 Company Prefix (as a string) or the result of a call to definePrefix. Only prefix types 0 (GS1 Company Prefix) and 1 (U.P.C. Company Prefix) are supported."
+            description: "Prefix definition, either a simple GS1 Company Prefix (as a string) or the result of a call to *definePrefix*. Only prefix types *0* (GS1 Company Prefix) and *1* (U.P.C. Company Prefix) are supported."
         },
         sparse: {
             name: "sparse",

package/src/locale/fr/locale-resources.ts

@@ -5,6 +5,19 @@ export default {
     Proxy: {
         matrixMustBeArray: "La matrice d'entrée doit être unidimensionnelle"
     },
+    Categories: {
+        helper: "Auxiliaire",
+        transformation: "Transformation",
+        string: "Chaîne de caractères",
+        GS1: {
+            checkCharacter: "Caractère de contrôle",
+            identifierValidation: "Validation d'identifiants",
+            identifierCreation: "Création d'identifiants",
+            variableMeasure: "Mesure variable",
+            prefix: "Préfixe",
+            service: "Service"
+        }
+    },
     IdentifierCreatorProxy: {
         prefixDefinitionMustBeOneDimensional: "La définition du préfixe doit être une matrice unidimensionnelle",
         prefixDefinitionMustHaveMaximumThreeElements: "La définition du préfixe doit comporter un maximum de 3 éléments",
@@ -17,21 +30,21 @@ export default {
         invalidIdentifierType: "Type d'identifiant invalide «{{identifierType}}»"
     },
     Parameters: {
-        spillMatrix: {
-            name: "matrice",
-            description: "Matrice unidimensionnelle à renverser."
+        spillArray: {
+            name: "tableau",
+            description: "Tableau à renverser."
         },
         spillMaximumWidth: {
             name: "largeurMaximale",
-            description: "Largeur maximale dans laquelle déverser la matrice. Si non fournie, la largeur restante de la feuille est utilisée."
+            description: "Largeur maximale dans laquelle déverser le tableau. Si non fournie, la largeur restante de la feuille est utilisée."
         },
         spillMaximumHeight: {
             name: "hauteurMaximale",
-            description: "Hauteur maximale dans laquelle déverser la matrice. Si non fournie, la hauteur restante de la feuille est utilisée."
+            description: "Hauteur maximale dans laquelle déverser le tableau. Si non fournie, la hauteur restante de la feuille est utilisée."
         },
         domain: {
             name: "domaine",
-            description: "Domaine de transformation. Les valeurs d'entrée valides vont de zéro au domaine-1."
+            description: "Domaine de transformation. Les valeurs d'entrée valides vont de *0* au *domaine-1*."
         },
         value: {
             name: "valeur",
@@ -43,7 +56,7 @@ export default {
         },
         count: {
             name: "compte",
-            description: "Nombre de valeurs à transformer. Si positive, les valeurs transformées vont de valeurInitiale ascendante à valeurInitiale+compte-1. Si négative, les valeurs transformées vont de valeurInitiale descendant à valeurInitiale+compte+1."
+            description: "Nombre de valeurs à transformer. Si positive, les valeurs transformées vont de *valeurInitiale* ascendante à *valeurInitiale+compte-1*. Si négative, les valeurs transformées vont de *valeurInitiale* descendant à *valeurInitiale+compte+1*."
         },
         transformedValue: {
             name: "valeurTransformee",
@@ -71,19 +84,19 @@ export default {
         },
         exclusionNone: {
             name: "exclusion",
-            description: "Valeurs de chaîne à exclure. La seule valeur valide est 0 (aucune exclusion)."
+            description: "Valeurs de chaîne à exclure. La seule valeur valide est *0* (aucune exclusion)."
         },
         exclusionFirstZero: {
             name: "exclusion",
-            description: "Valeurs de chaîne à exclure. Les valeurs valides sont 0 (aucune exclusion) et 1 (chaînes commençant par 0 exclues)."
+            description: "Valeurs de chaîne à exclure. Les valeurs valides sont *0* (aucune exclusion) et *1* (chaînes commençant par 0 exclues)."
         },
         exclusionAllNumeric: {
             name: "exclusion",
-            description: "Valeurs de chaîne à exclure. Les valeurs valides sont 0 (aucune exclusion) et 2 (chaînes entièrement numériques exclues)."
+            description: "Valeurs de chaîne à exclure. Les valeurs valides sont *0* (aucune exclusion) et *2* (chaînes entièrement numériques exclues)."
         },
         exclusionAny: {
             name: "exclusion",
-            description: "Valeurs de chaîne à exclure. Les valeurs valides sont 0 (aucune exclusion), 1 (chaînes commençant par 0 exclues) et 2 (chaînes toutes numériques exclues)."
+            description: "Valeurs de chaîne à exclure. Les valeurs valides sont *0* (aucune exclusion), *1* (chaînes commençant par 0 exclues) et *2* (chaînes toutes numériques exclues)."
         },
         length: {
             name: "longueur",
@@ -163,7 +176,7 @@ export default {
         },
         gtinLevel: {
             name: "niveau",
-            description: "Niveau auquel valider le GTIN. Les valeurs valides sont 0 (n'importe lequel), 1 (article commercial de consommation au détail) et 2 (autre que le niveau de l'article commercial de consommation au détail)."
+            description: "Niveau auquel valider le GTIN. Les valeurs valides sont *0* (n'importe lequel), *1* (article commercial de consommation au détail) et *2* (autre que le niveau de l'article commercial de consommation au détail)."
         },
         prefix: {
             name: "prefixe",
@@ -171,7 +184,7 @@ export default {
         },
         prefixType: {
             name: "typeDePréfixe",
-            description: "Type de préfixe. Les valeurs valides sont 0 (préfixe d'entreprise GS1), 1 (préfixe d'entreprise U.P.C.) et 2 (préfixe GS1)."
+            description: "Type de préfixe. Les valeurs valides sont *0* (préfixe d'entreprise GS1), *1* (préfixe d'entreprise U.P.C.) et *2* (préfixe GS1)."
         },
         tweakFactor: {
             name: "facteurDeReglage",
@@ -183,11 +196,11 @@ export default {
         },
         prefixDefinitionAny: {
             name: "prefixeDefinition",
-            description: "Définition de préfixe, soit un préfixe d'entreprise simple GS1 (sous forme de chaîne), soit le résultat d'un appel à definePrefix. Tout type de préfixe est pris en charge."
+            description: "Définition de préfixe, soit un préfixe d'entreprise simple GS1 (sous forme de chaîne), soit le résultat d'un appel à *definisserPrefixe*. Tout type de préfixe est pris en charge."
         },
         prefixDefinitionGS1UPC: {
             name: "prefixeDefinition",
-            description: "Définition de préfixe, soit un préfixe d'entreprise simple GS1 (sous forme de chaîne), soit le résultat d'un appel à definePrefix. Seuls les types de préfixes 0 (préfixe d'entreprise GS1) et 1 (préfixe d'entreprise U.P.C.) sont pris en charge."
+            description: "Définition de préfixe, soit un préfixe d'entreprise simple GS1 (sous forme de chaîne), soit le résultat d'un appel à *definisserPrefixe*. Seuls les types de préfixes *0* (préfixe d'entreprise GS1) et *1* (préfixe d'entreprise U.P.C.) sont pris en charge."
         },
         sparse: {
             name: "clairsemee",