@communecter/cocolight-api-client 1.0.195 → 1.0.197

package/types/index.d.ts

@@ -39,6 +39,7 @@ declare const cocolightApiClient: {
 export default cocolightApiClient;
 export { batch, computed, effect, getSignals, isReactive, isSignal, reactive, subscribeTo, watch } from "./utils/reactive.js";
 export { toCsv, formatImportTable } from "./utils/adminImportExport.js";
+export { ampliSlug, isUnusableAmpliName } from "./utils/ampliSlug.js";
 export type { default as Api } from "./Api.js";
 export type { default as ApiClient } from "./ApiClient.js";
 export type { default as EndpointApi } from "./api/EndpointApi.js";
@@ -72,6 +73,8 @@ export type * from "./api/serverDataType/Classified.js";
 export type * from "./api/serverDataType/Event.js";
 export type * from "./api/serverDataType/Poi.js";
 export type * from "./api/serverDataType/ToolsCatalog.js";
+export { AMPLI_PARENT_TYPES } from "./api/serverDataType/Ampli.js";
+export type * from "./api/serverDataType/Ampli.js";
 export type * from "./api/serverDataType/CommunInfo.js";
 export type * from "./api/serverDataType/News.js";
 export type * from "./api/serverDataType/Comment.js";
@@ -86,12 +89,12 @@ export type * from "./api/serverDataType/Notification.js";
 export type { Notification, Notifications } from "./api/Notifications.js";
 export type { PaginatorPage, PaginatorState, FundingEnvelopeResult, FundingEnvelopeProjectItem, SearchCostumVariant, SetTypeValue, CostumContextFields, WithCostumContext, EntityType, CoformThematicValue, CoformFilterByPathResult, } from "./api/BaseEntity.js";
 export { UPDATE_PATH_MAGIC } from "./api/BaseEntity.js";
-export type { CostumScope, CostumRuntimeContext, CostumFormDescriptor, CostumFieldDescriptor, CostumFieldType, } from "./costum/runtime.js";
+export type { CostumScope, CostumRuntimeContext, CostumFormDescriptor, CostumFieldDescriptor, CostumFieldType, CostumCreateOptions, CostumContextOptions, } from "./costum/runtime.js";
 export type { Collection, KnownCostumSlug } from "./costum/types.js";
 export { describeCostumForms } from "./costum/runtime.js";
 export { resolveCostumScope, setCostumForceLive, isCostumForceLive } from "./costum/runtime.js";
 export { describeEntityForm } from "./forms/entityForm.js";
 export type { EntityFormDescriptor, BaseFieldDescriptor, EntityFieldType, EntityFieldFormat } from "./forms/entityForm.js";
-export type { AllStepsData, PendingUploadValue, PendingUpload, ProcessUploadsOptions, AnswerGetOptions, UploadAnswerFileOptions, UploadAnswerFileResult, GetFilesOptions, AnswerFileItem, GenerateProjectOptions, GenerateProjectResult, GenerateMilestoneFromDepenseResult, FinancerPaymentStatus, FinancerPaymentLog, FinancerPaymentBlock, AddFinancerResult, PayFinancerResult, ValidateFinancerPaymentResult, DeleteFinancerResult, } from "./api/Answer.js";
+export type { AllStepsData, PendingUploadValue, PendingUpload, ProcessUploadsOptions, AnswerGetOptions, UploadAnswerFileOptions, UploadAnswerFileResult, GetFilesOptions, AnswerFileItem, GenerateProjectOptions, GenerateProjectResult, GenerateMilestoneFromDepenseResult, FinancerPaymentStatus, FinancerPaymentLog, FinancerPaymentBlock, AddFinancerResult, PayFinancerResult, ValidateFinancerPaymentResult, DeleteFinancerResult, AnswerVoteResult, AnswerVotesResult, } from "./api/Answer.js";
 export type * from "./types/index.js";
 export type * from "./api/EndpointApi.types.js";

package/types/utils/ampliSlug.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Slug d'un ampli à partir de son nom — miroir de `InflectorHelper::slugifyLikeJS`, le calcul par
+ * lequel `CreateAmpliAction` (modules/costum@3ef97ef28) dérive la CLÉ de l'entrée dans
+ * `costum.ampli`.
+ *
+ * Le serveur **écrase sans prévenir** une entrée existante de même clé : aucune garde côté legacy.
+ * D'où cet export — un appelant qui a déjà la liste des amplis en mémoire peut détecter la
+ * collision AVANT l'appel.
+ *
+ * ⚠ Ce n'est qu'une garde PRÉALABLE, jamais une source de clé :
+ *  - le slug qui fait foi est celui que renvoie `createAmpli`, puis la clé lue dans `costum.ampli` ;
+ *  - les entrées créées AVANT ce commit legacy ont une clé d'une autre forme
+ *    (`strtolower` + espace → tiret : « Idées d'été » → `idées-d'été`). Pour supprimer un ampli,
+ *    toujours passer la clé lue dans `costum.ampli`, jamais un slug recalculé depuis le nom ;
+ *  - parité exacte sur l'ASCII et sur les caractères de la table `remove_accent` (français et
+ *    langues d'Europe de l'Ouest et centrale), quelle que soit la locale du serveur. Au-delà,
+ *    l'étape `iconv //TRANSLIT` dépend de cette locale (`þ` → `th`, `ŋ` → `n`, `ẞ` → `ss` en
+ *    locale UTF-8 ; supprimés en locale `C`) : ici on suit la décomposition Unicode, qui rejoint
+ *    le plus souvent une locale UTF-8 sans la reproduire pour ces quelques lettres.
+ *
+ * @example
+ * ampliSlug("Idées d'été");                    // "idees-d-ete"
+ * ampliSlug("Cœur de ville");                  // "coeur-de-ville"
+ * amplis.some(a => a.slug === ampliSlug(nom)); // collision → l'entrée serait écrasée
+ */
+export declare function ampliSlug(name: unknown): string;
+/**
+ * `true` si le nom ne produit aucun slug exploitable — exactement les deux valeurs que
+ * `CreateAmpliAction` refuse (`""` et `"n-a"`).
+ */
+export declare function isUnusableAmpliName(name: unknown): boolean;