@tekkare/romulus 0.1.330 → 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.329",
7
+ "version": "0.1.331",
8
8
  "builder": {
9
9
  "@nuxt/module-builder": "0.8.4",
10
10
  "unbuild": "2.0.0"
@@ -47,6 +47,13 @@ const props = withDefaults(
47
47
  views?: RmViewPillItem[]
48
48
  /** Titre de la section des vues du menu. */
49
49
  viewsLabel?: string
50
+ /**
51
+ * Templates proposes sous les vues, apres un separateur : un point de
52
+ * depart pret a l'emploi, a portee sans ouvrir le rail.
53
+ */
54
+ templates?: RmViewPillItem[]
55
+ /** Titre de la section des templates. */
56
+ templatesLabel?: string
50
57
  /** L'ecran ne correspond plus a la vue active. */
51
58
  dirty?: boolean
52
59
  /**
@@ -66,6 +73,8 @@ const props = withDefaults(
66
73
  viewName: null,
67
74
  views: () => [],
68
75
  viewsLabel: undefined,
76
+ templates: () => [],
77
+ templatesLabel: undefined,
69
78
  dirty: false,
70
79
  temporary: false,
71
80
  actions: () => [],
@@ -76,6 +85,8 @@ const props = withDefaults(
76
85
  const emit = defineEmits<{
77
86
  /** Une vue du menu est demandee. */
78
87
  select: [id: string]
88
+ /** Un template du menu est demande. */
89
+ template: [id: string]
79
90
  /** Enregistrer l'ecran dans la vue active. */
80
91
  save: []
81
92
  /** Une action de bas de menu. */
@@ -87,6 +98,7 @@ const WORDS = {
87
98
  key: 'Changer vue :',
88
99
  none: 'Aucune vue',
89
100
  favorites: 'Favoris',
101
+ templates: 'Templates Tekkare',
90
102
  actions: 'Actions',
91
103
  unsaved: 'Modifications non enregistrées',
92
104
  modified: 'modifiée',
@@ -99,6 +111,7 @@ const WORDS = {
99
111
  key: 'Change view:',
100
112
  none: 'No view',
101
113
  favorites: 'Favorites',
114
+ templates: 'Tekkare templates',
102
115
  actions: 'Actions',
103
116
  unsaved: 'Unsaved changes',
104
117
  modified: 'edited',
@@ -129,6 +142,11 @@ function choose(id: string) {
129
142
  emit('select', id)
130
143
  }
131
144
 
145
+ function chooseTemplate(id: string) {
146
+ open.value = false
147
+ emit('template', id)
148
+ }
149
+
132
150
  function run(key: string) {
133
151
  open.value = false
134
152
  emit('action', key)
@@ -213,6 +231,23 @@ onBeforeUnmount(() => {
213
231
  <RmIcon class="rm-vpill__check" name="Check" :size="14" />
214
232
  <span class="rm-vpill__name">{{ view.title }}</span>
215
233
  </button>
234
+ <div v-if="templates.length > 0 || actions.length > 0" class="rm-vpill__divider" />
235
+ </template>
236
+
237
+ <template v-if="templates.length > 0">
238
+ <p class="rm-vpill__section">{{ templatesLabel || t.templates }}</p>
239
+ <button
240
+ v-for="template in templates"
241
+ :key="template.id"
242
+ type="button"
243
+ role="menuitem"
244
+ class="rm-vpill__item rm-vpill__item--view"
245
+ :class="{ 'is-active': template.active }"
246
+ @click="chooseTemplate(template.id)"
247
+ >
248
+ <RmIcon class="rm-vpill__check" name="Check" :size="14" />
249
+ <span class="rm-vpill__name">{{ template.title }}</span>
250
+ </button>
216
251
  <div v-if="actions.length > 0" class="rm-vpill__divider" />
217
252
  </template>
218
253
 
@@ -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>
@@ -19,11 +19,13 @@
19
19
  :view-name="viewName"
20
20
  :views="views"
21
21
  :views-label="viewsLabel"
22
+ :templates="templateItems"
22
23
  :dirty="dirty"
23
24
  :temporary="!namedActive?.id"
24
25
  :actions="actions"
25
26
  :lang="locale === 'en' ? 'en' : 'fr'"
26
27
  @select="apply"
28
+ @template="templates.start"
27
29
  @save="saveCurrent"
28
30
  @action="run"
29
31
  />
@@ -234,17 +236,70 @@ const viewName = computed(() => {
234
236
  });
235
237
 
236
238
  /**
237
- * Les autres vues de la page, favorites d'abord : la pastille sert a basculer.
238
- * La vue affichee n'y figure pas, son nom est deja sur la pastille.
239
+ * Les vues appliquees en dernier, les plus recentes d'abord. L'API ne date pas
240
+ * l'usage d'une vue : la liste se tient dans le navigateur, c'est un confort
241
+ * du lecteur, pas une donnee a partager. Toutes pages confondues ; le tri par
242
+ * page se fait a la lecture.
239
243
  */
240
- const views = computed(() =>
241
- pageViews.value
242
- .filter((scope: any) => scope.id !== namedActive.value?.id)
243
- .sort((a: any, b: any) => Number(b.starred === true) - Number(a.starred === true))
244
- .slice(0, 10)
245
- .map((scope: any) => ({ id: String(scope.id), title: String(scope.title) })),
244
+ const RECENT_KEY = "oip:recentViews";
245
+ const RECENT_MAX = 30;
246
+ const recentIds = useState<string[]>("views:recent", () => []);
247
+
248
+ onMounted(() => {
249
+ try {
250
+ const stored = JSON.parse(localStorage.getItem(RECENT_KEY) ?? "[]");
251
+ if (Array.isArray(stored)) recentIds.value = stored.map(String);
252
+ } catch {
253
+ // Stockage indisponible (navigation privee) : la liste reste vide.
254
+ }
255
+ });
256
+
257
+ watch(
258
+ () => namedActive.value?.id,
259
+ (id) => {
260
+ if (!id) return;
261
+ const key = String(id);
262
+ recentIds.value = [key, ...recentIds.value.filter((item) => item !== key)].slice(0, RECENT_MAX);
263
+ try {
264
+ localStorage.setItem(RECENT_KEY, JSON.stringify(recentIds.value));
265
+ } catch {
266
+ // Rien a faire : la liste vaut pour la session.
267
+ }
268
+ },
269
+ );
270
+
271
+ /**
272
+ * Trois vues de la page, la vue affichee exclue (son nom est deja sur la
273
+ * pastille) : les dernieres utilisees, puis, faute d'historique, les
274
+ * favorites. Le reste se trouve dans le panneau « Mes vues ».
275
+ */
276
+ const views = computed(() => {
277
+ const others = pageViews.value.filter((scope: any) => scope.id !== namedActive.value?.id);
278
+ const rank = (scope: any) => {
279
+ const index = recentIds.value.indexOf(String(scope.id));
280
+ return index === -1 ? Number.POSITIVE_INFINITY : index;
281
+ };
282
+ return [...others]
283
+ .sort(
284
+ (a: any, b: any) =>
285
+ rank(a) - rank(b) || Number(b.starred === true) - Number(a.starred === true),
286
+ )
287
+ .slice(0, 3)
288
+ .map((scope: any) => ({ id: String(scope.id), title: String(scope.title) }));
289
+ });
290
+ const viewsLabel = computed(() => (fr.value ? "Vues récentes" : "Recent views"));
291
+
292
+ /**
293
+ * Trois templates de la page, dans l'ordre du panneau (ceux publies pour cet
294
+ * espace d'abord). Le template affiche porte la coche.
295
+ */
296
+ const templateItems = computed(() =>
297
+ templates.templates.value.slice(0, 3).map((template) => ({
298
+ id: template.id,
299
+ title: template.title[fr.value ? "fr" : "en"],
300
+ active: !namedActive.value?.id && active.value?.template === template.id,
301
+ })),
246
302
  );
247
- const viewsLabel = computed(() => (fr.value ? "Autres vues" : "Other views"));
248
303
 
249
304
  /**
250
305
  * Trois gestes sous la liste. « Nouvelle vue » cree une vue (cf. `startNew`). Tout
@@ -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.330",
3
+ "version": "0.1.332",
4
4
  "description": "Romulus Design System - Nuxt module by Tekkare",
5
5
  "license": "MIT",
6
6
  "type": "module",