@tekkare/romulus 0.1.331 → 0.1.332

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/module.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "compatibility": {
5
5
  "nuxt": ">=3.16.0"
6
6
  },
7
- "version": "0.1.330",
7
+ "version": "0.1.331",
8
8
  "builder": {
9
9
  "@nuxt/module-builder": "0.8.4",
10
10
  "unbuild": "2.0.0"
@@ -38,6 +38,7 @@ import OipPanelStatistics from "./panels/OipPanelStatistics.vue";
38
38
  import OipPanelTopics from "./panels/OipPanelTopics.vue";
39
39
  import OipPanelTutorials from "./panels/OipPanelTutorials.vue";
40
40
  import OipNewsModal from "./layout/newsModal.vue";
41
+ import OipViewLoader from "./layout/viewLoader.vue";
41
42
 
42
43
  // Relatif et non `~/` : dans un layer, `~` designe l'app qui l'etend.
43
44
  import tekkareLogoRaw from "../assets/tekkare_logo.svg?raw";
@@ -666,6 +667,8 @@ const tekkareLogo = tekkareLogoRaw.replaceAll('fill="#2100AD"', 'fill="currentCo
666
667
  <div ref="chatwootLayer" class="oip-chatwoot-layer" />
667
668
  <!-- Nouveautés sur les sujets favoris de cette app, une fois par news. -->
668
669
  <OipNewsModal :lang="en ? 'en' : 'fr'" />
670
+ <!-- « On charge votre vue » : arrivee par un lien de vue (Inbox). -->
671
+ <OipViewLoader :lang="en ? 'en' : 'fr'" />
669
672
  </template>
670
673
  </RmAppShell>
671
674
  </template>
@@ -0,0 +1,115 @@
1
+ <!--
2
+ Modale « On charge votre vue », montee par OipShell.
3
+
4
+ S'ouvre quand on arrive sur une page par un lien de vue (`?oipView=`, cf.
5
+ useOipViewLoader) et reste au moins trois secondes, le temps que la vue
6
+ s'applique et que le lecteur voie ce qui se passe. La barre avance seule
7
+ jusqu'a 90 %, puis finit sa course quand la vue est posee.
8
+ -->
9
+ <script setup lang="ts">
10
+ const props = defineProps<{ lang: "fr" | "en" }>();
11
+ const en = computed(() => props.lang === "en");
12
+
13
+ const loader = useOipViewLoader();
14
+
15
+ const open = computed({
16
+ get: () => !!loader.state.value,
17
+ set: (value: boolean) => {
18
+ if (!value) loader.close();
19
+ },
20
+ });
21
+ </script>
22
+
23
+ <template>
24
+ <RmModal v-model="open" size="sm" mode="free" :label="en ? 'Loading your view' : 'Chargement de votre vue'">
25
+ <template #header>
26
+ <span class="view-loader_title">{{ en ? "Loading your view" : "On charge votre vue" }}</span>
27
+ </template>
28
+ <div class="view-loader">
29
+ <i class="ph ph-bookmark-simple view-loader_icon" aria-hidden="true" />
30
+ <p class="view-loader_name">
31
+ {{
32
+ loader.state.value?.title
33
+ || (en ? "Applying the filters of the shared view…" : "Application des filtres de la vue partagée…")
34
+ }}
35
+ </p>
36
+ <div
37
+ class="view-loader_track"
38
+ role="progressbar"
39
+ :aria-valuetext="en ? 'Loading' : 'Chargement'"
40
+ >
41
+ <div class="view-loader_bar" :class="{ 'is-done': loader.state.value?.done }" />
42
+ </div>
43
+ </div>
44
+ </RmModal>
45
+ </template>
46
+
47
+ <style scoped>
48
+ .view-loader_title {
49
+ font-weight: var(--weight-semibold);
50
+ font-size: var(--font-16);
51
+ }
52
+
53
+ .view-loader {
54
+ display: flex;
55
+ flex-direction: column;
56
+ align-items: center;
57
+ gap: 12px;
58
+ padding: 8px 8px 16px;
59
+ text-align: center;
60
+ }
61
+
62
+ .view-loader_icon {
63
+ font-size: 32px;
64
+ color: var(--color-primary);
65
+ }
66
+
67
+ .view-loader_name {
68
+ margin: 0;
69
+ color: var(--text-secondary);
70
+ }
71
+
72
+ .view-loader_track {
73
+ width: 100%;
74
+ height: 6px;
75
+ border-radius: 999px;
76
+ background: var(--bg-surface-3);
77
+ overflow: hidden;
78
+ }
79
+
80
+ .view-loader_bar {
81
+ height: 100%;
82
+ width: 0;
83
+ border-radius: inherit;
84
+ background: var(--color-primary);
85
+ animation: view-loader-fill 2.8s ease-out forwards;
86
+ }
87
+
88
+ .view-loader_bar.is-done {
89
+ animation: view-loader-finish 0.25s ease-out forwards;
90
+ }
91
+
92
+ @keyframes view-loader-fill {
93
+ from {
94
+ width: 0;
95
+ }
96
+ to {
97
+ width: 90%;
98
+ }
99
+ }
100
+
101
+ @keyframes view-loader-finish {
102
+ from {
103
+ width: 90%;
104
+ }
105
+ to {
106
+ width: 100%;
107
+ }
108
+ }
109
+
110
+ @media (prefers-reduced-motion: reduce) {
111
+ .view-loader_bar {
112
+ animation-duration: 0.01s;
113
+ }
114
+ }
115
+ </style>
@@ -16,6 +16,7 @@
16
16
  <script setup lang="ts">
17
17
  import type { OipInboxItem } from "../../composables/useOipInbox";
18
18
  import { PROJECTS_PATH } from "#oip-projects";
19
+ import { withViewParam } from "../../composables/useOipViewLoader";
19
20
 
20
21
  // Passee par OipShell a tous les panneaux ; l'Inbox n'en depend pas.
21
22
  defineProps<{ appKey?: string; superAdmin?: boolean }>();
@@ -49,10 +50,11 @@ function hostOf(url?: string): string {
49
50
 
50
51
  const localePath = useLocalePath();
51
52
 
52
- /** Un projet s'ouvre sur sa page dans cette app ; une vue a son adresse. */
53
+ /** Un projet s'ouvre sur sa page dans cette app ; une vue a son adresse, appliquee. */
53
54
  function hrefOf(item: OipInboxItem): string {
54
55
  if (item.kind === "project") return localePath(`${PROJECTS_PATH}/${encodeURIComponent(item.id)}`);
55
- return item.url ?? "";
56
+ // L'identifiant fait appliquer la vue a l'arrivee (cf. useOipViewLoader).
57
+ return withViewParam(item.url ?? "", item.id);
56
58
  }
57
59
 
58
60
  /** Fichier ouvert dans l'apercu, ou null. */
@@ -0,0 +1,68 @@
1
+ /**
2
+ * useOipViewLoader - ouvrir une vue depuis un lien, et le montrer.
3
+ *
4
+ * Un lien vers une vue (l'Inbox du rail, celle d'OIP 7) porte son identifiant
5
+ * dans `?oipView=` en plus de l'adresse de sa page. La page, en se declarant
6
+ * (cf. `useViews().declare`), applique la vue au lieu de laisser le lecteur la
7
+ * chercher dans « Mes vues ». Avant, le lien n'amenait que sur la page : il
8
+ * fallait recliquer sur la vue une fois arrive.
9
+ *
10
+ * Pendant ce temps, une modale annonce le chargement. Elle reste ouverte au
11
+ * moins `MIN_MS`, meme quand la vue s'applique tout de suite : sans ce temps,
12
+ * l'ecran change sous les yeux du lecteur sans qu'il comprenne pourquoi.
13
+ *
14
+ * Etat de module, comme `useViews` : pose et retire dans des hooks client,
15
+ * donc rien ne traverse le rendu serveur.
16
+ */
17
+ export const OIP_VIEW_PARAM = "oipView";
18
+
19
+ const MIN_MS = 3000;
20
+
21
+ /** Ajoute l'identifiant de la vue a l'adresse de sa page. */
22
+ export function withViewParam(url: string, id: string): string {
23
+ if (!url || !id) return url;
24
+ try {
25
+ const target = new URL(url, "http://relative.invalid");
26
+ target.searchParams.set(OIP_VIEW_PARAM, id);
27
+ return target.origin === "http://relative.invalid"
28
+ ? `${target.pathname}${target.search}${target.hash}`
29
+ : target.toString();
30
+ } catch {
31
+ return url;
32
+ }
33
+ }
34
+
35
+ interface LoaderState {
36
+ startedAt: number;
37
+ /** Nom de la vue, connu une fois les vues chargees. */
38
+ title: string;
39
+ done: boolean;
40
+ }
41
+
42
+ const state = ref<LoaderState | null>(null);
43
+
44
+ export function useOipViewLoader() {
45
+ return {
46
+ state: readonly(state),
47
+ open() {
48
+ state.value = { startedAt: Date.now(), title: "", done: false };
49
+ },
50
+ name(title: string) {
51
+ if (state.value) state.value = { ...state.value, title };
52
+ },
53
+ /** Ferme apres `MIN_MS` depuis l'ouverture ; la barre finit sa course juste avant. */
54
+ async finish() {
55
+ const current = state.value;
56
+ if (!current) return;
57
+ const left = MIN_MS - (Date.now() - current.startedAt);
58
+ if (left > 0) await new Promise((resolve) => setTimeout(resolve, left));
59
+ if (state.value !== current) return;
60
+ state.value = { ...current, done: true };
61
+ await new Promise((resolve) => setTimeout(resolve, 300));
62
+ if (state.value?.startedAt === current.startedAt) state.value = null;
63
+ },
64
+ close() {
65
+ state.value = null;
66
+ },
67
+ };
68
+ }
@@ -32,6 +32,7 @@ import {
32
32
  // panneau.
33
33
 
34
34
  import { sameViewPage } from "../utils/viewPages";
35
+ import { OIP_VIEW_PARAM, useOipViewLoader } from "./useOipViewLoader";
35
36
 
36
37
  /**
37
38
  * Nom du pseudo-filtre qui porte le « Personnaliser » dans les criteres d'une
@@ -344,8 +345,28 @@ export function useViews(scopes: ViewsScopes = useDefaultScopes) {
344
345
  // Lu dans le `setup` : dans un hook de cycle de vie, l'injection du
345
346
  // routeur n'a plus d'instance a interroger.
346
347
  const route = useRoute();
348
+ const router = useRouter();
349
+ const loader = useOipViewLoader();
347
350
 
348
351
  onMounted(async () => {
352
+ // Un lien de vue (Inbox, cf. useOipViewLoader) : la modale s'ouvre tout
353
+ // de suite et se ferme quoi qu'il arrive, vue trouvee ou non.
354
+ const raw = route.query[OIP_VIEW_PARAM];
355
+ const wantedId = typeof raw === "string" && raw ? raw : null;
356
+ if (!wantedId) return run(null);
357
+ loader.open();
358
+ try {
359
+ await run(wantedId);
360
+ } finally {
361
+ await loader.finish();
362
+ // Le parametre a fait son office : le garder rappliquerait la vue a
363
+ // chaque rechargement, par-dessus ce que le lecteur a change depuis.
364
+ const { [OIP_VIEW_PARAM]: _, ...query } = route.query;
365
+ router.replace({ query });
366
+ }
367
+ });
368
+
369
+ async function run(wantedId: string | null) {
349
370
  registry.value = { build, scopes };
350
371
 
351
372
  const store = scopes();
@@ -357,6 +378,22 @@ export function useViews(scopes: ViewsScopes = useDefaultScopes) {
357
378
  const source = build();
358
379
  if (!source) return;
359
380
 
381
+ // La vue demandee par le lien passe avant tout le reste : c'est
382
+ // exactement ce que le lecteur a clique. Introuvable (supprimee, plus
383
+ // partagee), la page suit son cours normal.
384
+ if (wantedId) {
385
+ const wanted = store.scopeList.value.find((scope: any) => scope.id === wantedId);
386
+ if (wanted) {
387
+ loader.name(wanted.title ?? "");
388
+ defaultApplied.add(source.page);
389
+ // Copie volontaire, comme pour la vue par defaut plus bas.
390
+ store.setSelectedScope({ ...wanted });
391
+ applyPrefs(wanted, source.prefsScope);
392
+ source.onApply?.(wanted);
393
+ return;
394
+ }
395
+ }
396
+
360
397
  // Un lien partage porte les filtres de l'expediteur (cf. usePermalink) :
361
398
  // ils gagnent sur la vue par defaut du destinataire, sinon le lien
362
399
  // ouvrirait un autre ecran que celui qui a ete partage. La vue posee n'a
@@ -422,7 +459,7 @@ export function useViews(scopes: ViewsScopes = useDefaultScopes) {
422
459
  applyPrefs(wanted, source.prefsScope);
423
460
  source.onApply?.(wanted);
424
461
  }
425
- });
462
+ }
426
463
 
427
464
  onBeforeUnmount(() => {
428
465
  if (registry.value?.build === build) registry.value = null;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tekkare/romulus",
3
- "version": "0.1.331",
3
+ "version": "0.1.332",
4
4
  "description": "Romulus Design System - Nuxt module by Tekkare",
5
5
  "license": "MIT",
6
6
  "type": "module",