mon-entreprise/site/source/sitePaths.ts

346 lines
9.4 KiB
TypeScript
Raw Normal View History

2022-07-25 09:02:08 +00:00
import { useTranslation } from 'react-i18next'
2023-02-01 00:28:35 +00:00
import { MetadataSrc } from '@/pages/Simulateurs/metadata-src'
2022-11-03 16:32:04 +00:00
import { LegalStatus } from '@/selectors/companyStatusSelectors'
export const LANDING_LEGAL_STATUS_LIST: Array<LegalStatus> = [
'EI',
'EIRL',
'EURL',
'SAS',
'SARL',
'SASU',
'auto-entrepreneur',
'auto-entrepreneur-EIRL',
'SA',
]
2022-07-25 09:02:08 +00:00
const status = Object.fromEntries(
LANDING_LEGAL_STATUS_LIST.map((statut) => [statut, statut])
) as { [statut in LegalStatus]: statut }
const rawSitePathsFr = {
2020-04-26 17:18:18 +00:00
index: '',
créer: {
2022-07-25 09:02:08 +00:00
index: 'créer',
...status,
après: 'après-la-création',
2020-04-26 17:18:18 +00:00
guideStatut: {
2022-07-25 09:02:08 +00:00
index: 'statut-juridique',
liste: 'liste',
soleProprietorship: 'responsabilité',
directorStatus: 'dirigeant',
autoEntrepreneur: 'auto-entrepreneur-ou-entreprise-individuelle',
multipleAssociates: 'nombre-associés',
minorityDirector: 'gérant-majoritaire-ou-minoritaire',
},
2020-04-26 17:18:18 +00:00
},
gérer: {
2022-07-25 09:02:08 +00:00
index: 'gérer',
entreprise: ':entreprise',
embaucher: 'embaucher',
sécuritéSociale: 'sécurité-sociale',
'déclaration-charges-sociales-indépendant':
2022-07-25 09:02:08 +00:00
'declaration-charges-sociales-independant',
déclarationIndépendant: {
2022-07-25 09:02:08 +00:00
index: 'aide-declaration-independants',
beta: {
index: 'beta',
entreprise: 'entreprise',
imposition: 'imposition',
déclaration: 'declaration',
cotisations: 'cotisations',
},
},
2022-07-25 09:02:08 +00:00
formulaireMobilité: 'demande-mobilité',
2020-04-26 17:18:18 +00:00
},
simulateurs: {
2022-07-25 09:02:08 +00:00
index: 'simulateurs',
2023-01-18 17:03:31 +00:00
'coût-création-entreprise': 'coût-création-entreprise',
2022-07-25 09:02:08 +00:00
'auto-entrepreneur': 'auto-entrepreneur',
'entreprise-individuelle': 'entreprise-individuelle',
eirl: 'eirl',
sasu: 'sasu',
eurl: 'eurl',
indépendant: 'indépendant',
comparaison: 'comparaison-régimes-sociaux',
pamc: 'pamc',
salarié: 'salaire-brut-net',
'artiste-auteur': 'artiste-auteur',
'profession-libérale': {
2022-07-25 09:02:08 +00:00
index: 'profession-liberale',
médecin: 'medecin',
pharmacien: 'pharmacien',
auxiliaire: 'auxiliaire-medical',
'chirurgien-dentiste': 'chirurgien-dentiste',
'sage-femme': 'sage-femme',
avocat: 'avocat',
'expert-comptable': 'expert-comptable',
},
2022-07-25 09:02:08 +00:00
'chômage-partiel': 'chômage-partiel',
économieCollaborative: {
2022-07-25 09:02:08 +00:00
index: 'économie-collaborative',
votreSituation: 'votre-situation',
},
2022-07-25 09:02:08 +00:00
is: 'impot-societe',
dividendes: 'dividendes',
'exonération-covid': 'exonération-covid',
2020-04-26 17:18:18 +00:00
},
2022-07-25 09:02:08 +00:00
nouveautés: 'nouveautés',
stats: 'stats',
accessibilité: 'accessibilité',
budget: 'budget',
développeur: {
2022-07-25 09:02:08 +00:00
index: 'développeur',
iframe: 'iframe',
library: 'bibliothèque-de-calcul',
api: 'api',
spreadsheet: 'tableur',
2020-04-26 17:18:18 +00:00
},
documentation: {
2022-07-25 09:02:08 +00:00
index: 'documentation',
},
plan: 'plan-de-site',
2020-04-26 17:18:18 +00:00
} as const
🔥 Migration vers TypeScript Outils ====== Ce commit retire le tooling de Flow, et ajoute le support de TypeScript pour les fichiers .ts et .tsx. Il n'est pas nécessaire de tout migrer d'un coup ce qui facilite la transition. On garde en effet le compilateur Babel avec un preset TypeScript (ce qui permet donc de retirer à la fois les types Flow et TypeScript) plutôt que d'utiliser le compilateur standard pour la conversion du code. Cela permet aussi de mieux s'intégrer avec d'autres outils, notamment les test-runners. Ajout d'une nouvelle commande `yarn run type-check`, intégrée dans CircleCI. Par ailleurs ajout du support de l'opérateur ?? pour donner des valeurs par défaut (nullish-coalescing-operator). Typage des libraires tierces ============================ Les principales libraires que nous utilisons ont un typage TypeScript de bon niveau, ce qui facilite l'intégration. J'ai mis à jour react-i18next et i18next afin de corriger un problème de typage. Typage du code ============== Le typage est loin d'être complet dans ce commit, en particulier il manque les types relatifs au state Redux, ainsi qu'au moteur (règle, explication). Néanmoins le typage des contextes fonctionne, en particulier sitePaths (avec un type récursif non trivial !) qui a déjà permis de détecter un lien mort. Le typage des "paths" (Components/, Règles/, etc.) fonctionne bien, y compris avec l'auto-complétion automatique des import par Typescript. TypeScript se révèle déjà bien agréable dans VSCode (auto-complétion, refacto, etc.) ! Reste à migrer progressivement le reste du code !
2019-10-26 16:21:09 +00:00
const rawSitePathsEn = {
...rawSitePathsFr,
2020-04-26 17:18:18 +00:00
créer: {
...rawSitePathsFr.créer,
2022-07-25 09:02:08 +00:00
index: 'create',
après: 'after-registration',
2020-04-26 17:18:18 +00:00
guideStatut: {
2022-07-25 09:02:08 +00:00
index: 'legal-status',
liste: 'list',
soleProprietorship: 'liability',
directorStatus: 'director',
autoEntrepreneur: 'auto-entrepreneur',
multipleAssociates: 'multiple-associates',
minorityDirector: 'chairman-or-managing-director',
},
2020-04-26 17:18:18 +00:00
},
gérer: {
2022-07-25 09:02:08 +00:00
index: 'manage',
entreprise: ':entreprise',
embaucher: 'hiring',
sécuritéSociale: 'social-security',
2022-04-04 11:10:02 +00:00
'déclaration-charges-sociales-indépendant':
2022-07-25 09:02:08 +00:00
'declaration-social-charges-independent',
déclarationIndépendant: {
2022-07-25 09:02:08 +00:00
index: 'declaration-aid-independent',
beta: {
index: 'beta',
imposition: 'taxation',
entreprise: 'company',
déclaration: 'declaration',
cotisations: 'contributions',
},
},
2022-07-25 09:02:08 +00:00
formulaireMobilité: 'posting-demand',
2020-04-26 17:18:18 +00:00
},
simulateurs: {
2022-07-25 09:02:08 +00:00
index: 'calculators',
2023-01-18 17:03:31 +00:00
'coût-création-entreprise': 'coût-création-entreprise',
2022-07-25 09:02:08 +00:00
indépendant: 'independant',
'entreprise-individuelle': 'sole-proprietorship',
'auto-entrepreneur': 'auto-entrepreneur',
eirl: 'eirl',
sasu: 'sasu',
eurl: 'eurl',
pamc: 'pamc',
comparaison: 'social-scheme-comparaison',
salarié: 'salary',
'artiste-auteur': 'artist-author',
'chômage-partiel': 'partial-unemployement',
'profession-libérale': {
2022-07-25 09:02:08 +00:00
index: 'liberal-profession',
médecin: 'doctor',
pharmacien: 'pharmacist',
auxiliaire: 'medical-auxiliary',
'chirurgien-dentiste': 'dental-surgeon',
'sage-femme': 'midwife',
avocat: 'lawyer',
'expert-comptable': 'accountant',
},
économieCollaborative: {
2022-07-25 09:02:08 +00:00
index: 'sharing-economy',
votreSituation: 'your-situation',
},
2022-07-25 09:02:08 +00:00
is: 'corporate-tax',
dividendes: 'dividends',
'exonération-covid': 'exoneration-covid',
2020-04-26 17:18:18 +00:00
},
2022-07-25 09:02:08 +00:00
nouveautés: 'news',
accessibilité: 'accessibility',
développeur: {
...rawSitePathsFr.développeur,
2022-07-25 09:02:08 +00:00
index: 'developer',
library: 'library',
api: 'api',
spreadsheet: 'spreadsheet',
},
plan: 'site-map',
2020-04-26 17:18:18 +00:00
} as const
/**
* Le but des types suivants est d'obtenir un typage statique des chaînes de caractères
2022-07-25 09:02:08 +00:00
* comme "simulateurs.auto-entrepreneur" utilisés comme identifiants des routes (via les pathId dans metadata-src.ts).
* Cela permet de ne pas avoir de faute dans les clés comme 'aide-embauche' au lieu de 'aides-embauche'
*/
// Transfrom string type like PathToType<'simulateurs.auto-entrepreneur', number>
// into { simulateurs : { auto-entrepreneur: number }}
type PathToType<T extends string, W> = T extends `${infer U}.${infer V}`
? { [key in U]: V extends string ? PathToType<V, W> : never }
: { [key in T]: W }
// Transform type A | B into A & B
type UnionToIntersection<T> = (
T extends unknown ? (x: T) => void : never
) extends (x: infer R) => void
? R
: never
// Union of pathId
type PathIds = MetadataSrc[keyof MetadataSrc]['pathId']
type RequiredPath = Required<UnionToIntersection<PathToType<PathIds, string>>>
// If there is a type error here, check rawSitePathsFr object matches the metadata-src.ts pathId
const checkedSitePathsFr: RequiredPath & typeof rawSitePathsFr = rawSitePathsFr
// If there is a type error here, check rawSitePathsEn object matches the metadata-src.ts pathId
const checkedSitePathsEn: RequiredPath & typeof rawSitePathsEn = rawSitePathsEn
type SitePathsFr = typeof checkedSitePathsFr
type SitePathsEn = typeof checkedSitePathsEn
2022-07-25 09:02:08 +00:00
type GenericSitePath = { [key: string]: string | GenericSitePath }
const encodeRelativeSitePaths = <T extends GenericSitePath>(base: T): T => {
const sitepaths = Object.entries(base).reduce(
(obj, [key, val]) => ({
...obj,
[key]: typeof val === 'string' ? val : encodeRelativeSitePaths(val),
2022-07-25 09:02:08 +00:00
}),
{} as T
)
return sitepaths
}
const encodedRelativeSitePaths = encodeRelativeSitePaths({
fr: rawSitePathsFr,
en: rawSitePathsEn,
})
2022-07-28 18:04:44 +00:00
const encodedAbsoluteSitePaths = {
fr: constructAbsoluteSitePaths(rawSitePathsFr),
en: constructAbsoluteSitePaths(rawSitePathsEn),
}
export const relativeSitePaths = encodedRelativeSitePaths
export const absoluteSitePaths = encodedAbsoluteSitePaths
export type RelativeSitePaths =
2023-01-31 17:52:10 +00:00
(typeof relativeSitePaths)[keyof typeof relativeSitePaths]
2022-07-28 18:04:44 +00:00
export type AbsoluteSitePaths =
2023-01-31 17:52:10 +00:00
(typeof absoluteSitePaths)[keyof typeof absoluteSitePaths]
2022-07-28 18:04:44 +00:00
export const useSitePaths = <T extends 'fr' | 'en'>(lang?: T) => {
2022-07-25 09:02:08 +00:00
const { language } = useTranslation().i18n
2022-07-28 18:04:44 +00:00
lang ??= language as T
2022-07-25 09:02:08 +00:00
2022-07-28 18:04:44 +00:00
return {
relativeSitePaths: relativeSitePaths[lang],
absoluteSitePaths: absoluteSitePaths[lang],
}
2022-07-25 09:02:08 +00:00
}
type SitePath = { [key: string]: string | SitePath } & { index: string }
type SitePathBuilt<T extends SitePath, Root extends string = ''> = {
[K in keyof T]: T[K] extends string
? K extends 'index'
2022-07-25 09:02:08 +00:00
? `${Root}${T[K]}` extends ''
? '/'
: `${Root}${T[K]}`
: T extends { index: string }
2022-07-25 09:02:08 +00:00
? `${Root}${T['index']}/${T[K]}`
: `${Root}${T[K]}`
: SitePathBuilt<
T[K] extends SitePath ? T[K] : never,
2022-07-25 09:02:08 +00:00
T extends { index: string } ? `${Root}${T['index']}/` : `${Root}`
>
🔥 Migration vers TypeScript Outils ====== Ce commit retire le tooling de Flow, et ajoute le support de TypeScript pour les fichiers .ts et .tsx. Il n'est pas nécessaire de tout migrer d'un coup ce qui facilite la transition. On garde en effet le compilateur Babel avec un preset TypeScript (ce qui permet donc de retirer à la fois les types Flow et TypeScript) plutôt que d'utiliser le compilateur standard pour la conversion du code. Cela permet aussi de mieux s'intégrer avec d'autres outils, notamment les test-runners. Ajout d'une nouvelle commande `yarn run type-check`, intégrée dans CircleCI. Par ailleurs ajout du support de l'opérateur ?? pour donner des valeurs par défaut (nullish-coalescing-operator). Typage des libraires tierces ============================ Les principales libraires que nous utilisons ont un typage TypeScript de bon niveau, ce qui facilite l'intégration. J'ai mis à jour react-i18next et i18next afin de corriger un problème de typage. Typage du code ============== Le typage est loin d'être complet dans ce commit, en particulier il manque les types relatifs au state Redux, ainsi qu'au moteur (règle, explication). Néanmoins le typage des contextes fonctionne, en particulier sitePaths (avec un type récursif non trivial !) qui a déjà permis de détecter un lien mort. Le typage des "paths" (Components/, Règles/, etc.) fonctionne bien, y compris avec l'auto-complétion automatique des import par Typescript. TypeScript se révèle déjà bien agréable dans VSCode (auto-complétion, refacto, etc.) ! Reste à migrer progressivement le reste du code !
2019-10-26 16:21:09 +00:00
}
2022-07-28 18:04:44 +00:00
function constructAbsoluteSitePaths<T extends SitePath>(
obj: T,
root = ''
): SitePathBuilt<T> {
const { index } = obj
const entries = Object.entries(obj)
2022-03-28 12:57:11 +00:00
return Object.fromEntries(
entries.map(([k, value]) => [
k,
typeof value === 'string'
? root + (k === 'index' ? value : index + '/' + value) || '/'
2022-07-28 18:04:44 +00:00
: constructAbsoluteSitePaths(value, root + index + '/'),
])
) as SitePathBuilt<T>
}
2022-06-13 11:07:46 +00:00
type Obj = { [k: string]: string | Obj }
const deepReduce = (
fn: (acc: string[], val: string, key: string) => string[],
initialValue: string[],
object: Obj
): string[] =>
Object.entries(object).reduce(
(acc, [key, value]) =>
typeof value === 'object'
? deepReduce(fn, acc, value)
: fn(acc, value, key),
initialValue
)
type SiteMap = Array<string>
2022-03-28 12:57:11 +00:00
2022-07-28 18:04:44 +00:00
export const generateSiteMap = (sitePaths: AbsoluteSitePaths): SiteMap =>
deepReduce(
2022-06-13 11:07:46 +00:00
(paths: Array<string>, path: string) =>
/\/:/.test(path) ? paths : [...paths, ...[path]],
[],
sitePaths
)
2022-06-13 11:07:46 +00:00
export const alternateLinks = () => {
const basePathFr =
import.meta.env.DEV && typeof window !== 'undefined'
? `http://${window.location.host}/mon-entreprise`
: import.meta.env.VITE_FR_BASE_URL ?? ''
2022-01-26 08:53:15 +00:00
2022-06-13 11:07:46 +00:00
const basePathEn =
import.meta.env.DEV && typeof window !== 'undefined'
? `http://${window.location.host}/infrance`
: import.meta.env.VITE_EN_BASE_URL ?? ''
2022-07-28 18:04:44 +00:00
const enSiteMap = generateSiteMap(absoluteSitePaths.en).map(
(path) => basePathEn + encodeURI(path)
2022-06-13 11:07:46 +00:00
)
2022-07-28 18:04:44 +00:00
const frSiteMap = generateSiteMap(absoluteSitePaths.fr).map(
(path) => basePathFr + encodeURI(path)
2022-06-13 11:07:46 +00:00
)
2022-06-13 11:07:46 +00:00
return {
en: Object.fromEntries(
enSiteMap.map((key, i) => [key, { href: frSiteMap[i], hrefLang: 'fr' }])
),
fr: Object.fromEntries(
frSiteMap.map((key, i) => [key, { href: enSiteMap[i], hrefLang: 'en' }])
),
}
}