@ac-base/ac-demo-content 0.1.1 → 0.2.0

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/README.md CHANGED
@@ -52,14 +52,57 @@ Siempre presentes, sin atributo que los active:
52
52
 
53
53
  ## Eventos
54
54
 
55
- | Evento | Cuándo | `detail` |
56
- | ---------------------- | ------------------------------------------ | ------------------ |
57
- | `ac-demo-content-copy` | El usuario copió un comando de instalación | `{ text: string }` |
55
+ | Evento | Cuándo | `detail` |
56
+ | ------------------------------ | -------------------------------------------------------------------------------------- | ------------------------------------------- |
57
+ | `ac-demo-content-copy` | El usuario copió un comando de instalación (solo si el copiado tuvo éxito) | `{ text: string }` |
58
+ | `ac-demo-content-state-change` | Cambió el caso, idioma, tema, dispositivo, vista, el log de eventos o el modo embebido | El mismo objeto que `demoState` (ver abajo) |
58
59
 
59
- Es `bubbles` y `composed`. Solo se dispara si el copiado tuvo éxito.
60
+ Ambos son `bubbles` y `composed`.
60
61
 
61
62
  Todos los controles de 2+ opciones (idioma, tema, tamaño de dispositivo, vista) comparten el mismo patrón visual: un contenedor con borde redondeado, opciones separadas por un divisor vertical, y la opción activa resaltada — nunca un switch deslizante ni texto plano de estado ("Modo claro"/"Modo oscuro").
62
63
 
64
+ ## Modo embebido
65
+
66
+ Para incrustar una demo dentro de otra página que dibuja sus propios controles (por ejemplo el catálogo visual, que carga cada demo en un `<iframe>` del mismo origen), activa `embedded`:
67
+
68
+ ```js
69
+ const demo = iframe.contentDocument.querySelector('ac-demo-content');
70
+ demo.embedded = true; // o el atributo `embedded` en el HTML
71
+ ```
72
+
73
+ Con `embedded`, `ac-demo-content` **no dibuja la cabecera ni el toolbar** — solo el escenario (marco de dispositivo o vista de código) y el panel de eventos cuando está abierto. Quien lo incrusta maneja el mismo estado desde afuera:
74
+
75
+ | Método | Efecto |
76
+ | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
77
+ | `selectCase(index)` | Activa el caso de ese índice. Ignora índices fuera de rango. |
78
+ | `selectLanguage(index)` | Activa el idioma `0` o `1` de `language`. Se ignora si no hay exactamente 2 idiomas o el índice no existe. |
79
+ | `selectAmbient(value)` | Setea `ambient` en los elementos del caso activo que tengan esa propiedad. |
80
+ | `selectTheme(theme)` | `'light'` o `'dark'` — togglea `data-theme` en el `<html>` de la demo. Otros valores se ignoran. |
81
+ | `selectDevice(key)` | `'mobile'`, `'tablet'` o `'desktop'`. Otros valores se ignoran. |
82
+ | `selectViewMode(mode)` | `'visual'` o `'code'`. Otros valores se ignoran. |
83
+ | `openEventsPanel()` / `closeEventsPanel()` | Abre/cierra el panel lateral de eventos (se dibuja dentro de la propia demo). |
84
+
85
+ El getter `demoState` devuelve una foto del estado actual, con todo lo necesario para dibujar los controles afuera:
86
+
87
+ ```js
88
+ {
89
+ cases: [{ index: 0, header: 'Básico' }], // `header` cae a "Caso N" si el caso no lo define
90
+ activeCase: 0,
91
+ languages: ['es-PE', 'en-EN'],
92
+ activeLanguage: 0,
93
+ ambients: ['primary', 'secondary'],
94
+ darkMode: true, // si la demo declara `dark-mode`
95
+ theme: 'light',
96
+ devices: [{ key: 'mobile', label: 'Móvil' } /* tablet, desktop */],
97
+ device: 'mobile',
98
+ viewMode: 'visual',
99
+ eventNames: ['ac-mi-componente-click'],
100
+ eventCount: 0,
101
+ }
102
+ ```
103
+
104
+ Para mantenerse sincronizado (por ejemplo el contador de eventos), escucha `ac-demo-content-state-change`: su `detail` es ese mismo objeto. Los métodos y `demoState` funcionan también sin `embedded` — los controles propios del toolbar usan exactamente los mismos métodos.
105
+
63
106
  ## `<ac-demo-case>`
64
107
 
65
108
  | Atributo | Descripción |
package/package.json CHANGED
@@ -1,6 +1,11 @@
1
1
  {
2
2
  "name": "@ac-base/ac-demo-content",
3
- "version": "0.1.1",
3
+ "version": "0.2.0",
4
+ "repository": {
5
+ "type": "git",
6
+ "url": "https://github.com/RenzoCordovaDev/ac-lit.git",
7
+ "directory": "packages/base/ac-demo-content"
8
+ },
4
9
  "description": "Contenedor centralizado para demos de componentes ac-lit (casos, idioma, ambient, modo oscuro, tamaños, panel de eventos)",
5
10
  "license": "MIT",
6
11
  "type": "module",
@@ -23,15 +28,15 @@
23
28
  "lit": "^3.0.0"
24
29
  },
25
30
  "devDependencies": {
26
- "@ac-base/ac-core": "^0.1.0",
27
- "@ac-base/ac-e2e-testing": "^0.1.0",
28
- "@ac-base/cli": "^0.2.0",
29
31
  "@open-wc/testing": "^4.0.0",
30
32
  "@web/test-runner": "^0.18.0",
31
33
  "concurrently": "^9.1.0",
32
34
  "lit": "^3.0.0",
33
35
  "sass": "^1.79.4",
34
- "vite": "^5.4.8"
36
+ "vite": "^5.4.8",
37
+ "@ac-base/ac-core": "^0.1.0",
38
+ "@ac-base/cli": "^0.2.1",
39
+ "@ac-base/ac-e2e-testing": "^0.1.0"
35
40
  },
36
41
  "scripts": {
37
42
  "component:lint": "eslint .",
@@ -14,6 +14,17 @@ const DEVICE_PRESETS = [
14
14
  { key: 'desktop', label: 'Desktop', width: 1280, height: 800 },
15
15
  ];
16
16
  const MAX_EVENT_LOG_ENTRIES = 50;
17
+ const THEMES = ['light', 'dark'];
18
+ const VIEW_MODES = ['visual', 'code'];
19
+ const STATE_PROPERTIES = [
20
+ '_activeCaseIndex',
21
+ '_activeDevice',
22
+ '_viewMode',
23
+ '_langIndex',
24
+ '_theme',
25
+ '_eventLog',
26
+ 'embedded',
27
+ ];
17
28
  const COPIED_FEEDBACK_MS = 1600;
18
29
 
19
30
  const COPY_ICON = html`<svg
@@ -108,6 +119,9 @@ function renderToken(token) {
108
119
  * y ALTURA fijos por preset — el contenido scrollea adentro, no empuja el
109
120
  * marco), vista visual/código (código muestra el HTML fuente del caso
110
121
  * activo) y un panel lateral de eventos con el detalle de cada uno.
122
+ *
123
+ * Con `embedded` no dibuja cabecera ni toolbar: quien lo incrusta maneja los
124
+ * mismos controles desde afuera con los métodos `select*()` y lee `demoState`.
111
125
  */
112
126
  export class DemoContent extends ComponentMixin(LitElement) {
113
127
  static get is() {
@@ -128,6 +142,7 @@ export class DemoContent extends ComponentMixin(LitElement) {
128
142
  ambients: { type: String },
129
143
  events: { type: String },
130
144
  darkMode: { type: Boolean, reflect: true, attribute: 'dark-mode' },
145
+ embedded: { type: Boolean, reflect: true },
131
146
  _activeCaseIndex: { state: true },
132
147
  _activeDevice: { state: true },
133
148
  _viewMode: { state: true },
@@ -149,6 +164,7 @@ export class DemoContent extends ComponentMixin(LitElement) {
149
164
  this.ambients = '';
150
165
  this.events = '';
151
166
  this.darkMode = false;
167
+ this.embedded = false;
152
168
  this._activeCaseIndex = 0;
153
169
  this._activeDevice = 'mobile';
154
170
  this._viewMode = 'visual';
@@ -179,6 +195,26 @@ export class DemoContent extends ComponentMixin(LitElement) {
179
195
  return Array.from(this.querySelectorAll(':scope > ac-demo-case'));
180
196
  }
181
197
 
198
+ get demoState() {
199
+ return {
200
+ cases: this._cases.map((caseEl, index) => ({
201
+ index,
202
+ header: caseEl.header || `Caso ${index + 1}`,
203
+ })),
204
+ activeCase: this._activeCaseIndex,
205
+ languages: this._languages,
206
+ activeLanguage: this._langIndex,
207
+ ambients: this._ambientOptions,
208
+ darkMode: this.darkMode,
209
+ theme: this._theme,
210
+ devices: DEVICE_PRESETS.map(({ key, label }) => ({ key, label })),
211
+ device: this._activeDevice,
212
+ viewMode: this._viewMode,
213
+ eventNames: this._eventNames,
214
+ eventCount: this._eventLog.length,
215
+ };
216
+ }
217
+
182
218
  connectedCallback() {
183
219
  super.connectedCallback();
184
220
  for (const name of this._eventNames) {
@@ -205,6 +241,18 @@ export class DemoContent extends ComponentMixin(LitElement) {
205
241
  }
206
242
  }
207
243
 
244
+ updated(changedProperties) {
245
+ if (STATE_PROPERTIES.some(property => changedProperties.has(property))) {
246
+ this.dispatchEvent(
247
+ new CustomEvent('ac-demo-content-state-change', {
248
+ detail: this.demoState,
249
+ bubbles: true,
250
+ composed: true,
251
+ }),
252
+ );
253
+ }
254
+ }
255
+
208
256
  _onEvent(event) {
209
257
  const entry = { time: new Date().toLocaleTimeString(), name: event.type, detail: event.detail };
210
258
  this._eventLog = [entry, ...this._eventLog].slice(0, MAX_EVENT_LOG_ENTRIES);
@@ -218,17 +266,18 @@ export class DemoContent extends ComponentMixin(LitElement) {
218
266
  this._activeCaseIndex = index;
219
267
  }
220
268
 
221
- _onCaseChange(event) {
222
- this._activateCase(Number(event.target.value));
269
+ selectCase(index) {
270
+ if (!Number.isInteger(index) || index < 0 || index >= this._cases.length) return;
271
+ this._activateCase(index);
223
272
  }
224
273
 
225
- _onLanguageSelect(index) {
274
+ selectLanguage(index) {
275
+ if (this._languages.length !== 2 || (index !== 0 && index !== 1)) return;
226
276
  this._langIndex = index;
227
277
  setGlobalLocale(this._languages[index]);
228
278
  }
229
279
 
230
- _onAmbientChange(event) {
231
- const value = event.target.value;
280
+ selectAmbient(value) {
232
281
  const activeCase = this._cases[this._activeCaseIndex];
233
282
  if (!activeCase) return;
234
283
 
@@ -239,6 +288,44 @@ export class DemoContent extends ComponentMixin(LitElement) {
239
288
  }
240
289
  }
241
290
 
291
+ selectTheme(theme) {
292
+ if (!THEMES.includes(theme)) return;
293
+ this._theme = theme;
294
+ document.documentElement.setAttribute('data-theme', theme);
295
+ }
296
+
297
+ selectDevice(key) {
298
+ if (!DEVICE_PRESETS.some(preset => preset.key === key)) return;
299
+ this._activeDevice = key;
300
+ }
301
+
302
+ selectViewMode(mode) {
303
+ if (!VIEW_MODES.includes(mode)) return;
304
+ this._viewMode = mode;
305
+ }
306
+
307
+ openEventsPanel() {
308
+ this._eventsPanelOpen = true;
309
+ document.addEventListener('keydown', this._onPanelKeydown);
310
+ }
311
+
312
+ closeEventsPanel() {
313
+ this._eventsPanelOpen = false;
314
+ document.removeEventListener('keydown', this._onPanelKeydown);
315
+ }
316
+
317
+ _onCaseChange(event) {
318
+ this.selectCase(Number(event.target.value));
319
+ }
320
+
321
+ _onLanguageSelect(index) {
322
+ this.selectLanguage(index);
323
+ }
324
+
325
+ _onAmbientChange(event) {
326
+ this.selectAmbient(event.target.value);
327
+ }
328
+
242
329
  // Un modal/toast/transition "contenido" de un caso renuncia a la capa
243
330
  // superior nativa (`showModal()`/`popover` SIEMPRE bloquean toda la página
244
331
  // real e ignoran cualquier ancestro para medirse — ver "Superposiciones" en
@@ -265,16 +352,15 @@ export class DemoContent extends ComponentMixin(LitElement) {
265
352
  }
266
353
 
267
354
  _onThemeSelect(theme) {
268
- this._theme = theme;
269
- document.documentElement.setAttribute('data-theme', theme);
355
+ this.selectTheme(theme);
270
356
  }
271
357
 
272
358
  _onDeviceSelect(key) {
273
- this._activeDevice = key;
359
+ this.selectDevice(key);
274
360
  }
275
361
 
276
362
  _onViewModeSelect(mode) {
277
- this._viewMode = mode;
363
+ this.selectViewMode(mode);
278
364
  }
279
365
 
280
366
  async _onInstallCommandClick(command) {
@@ -296,18 +382,16 @@ export class DemoContent extends ComponentMixin(LitElement) {
296
382
  }
297
383
 
298
384
  _onEventsButtonClick() {
299
- this._eventsPanelOpen = true;
300
- document.addEventListener('keydown', this._onPanelKeydown);
385
+ this.openEventsPanel();
301
386
  }
302
387
 
303
388
  _onEventsPanelClose() {
304
- this._eventsPanelOpen = false;
305
- document.removeEventListener('keydown', this._onPanelKeydown);
389
+ this.closeEventsPanel();
306
390
  }
307
391
 
308
392
  _onPanelKeydown(event) {
309
393
  if (event.key === 'Escape') {
310
- this._onEventsPanelClose();
394
+ this.closeEventsPanel();
311
395
  }
312
396
  }
313
397
 
@@ -316,8 +400,19 @@ export class DemoContent extends ComponentMixin(LitElement) {
316
400
  const devicePreset = DEVICE_PRESETS.find(preset => preset.key === this._activeDevice);
317
401
 
318
402
  return html`
319
- ${hasHeader ? this._renderHeader() : ''}
403
+ ${hasHeader && !this.embedded ? this._renderHeader() : ''}
404
+ ${this.embedded ? '' : this._renderToolbar()}
320
405
 
406
+ <div class="ac-demo-content__stage">
407
+ ${this._viewMode === 'code' ? this._renderCodeView() : this._renderDeviceStage(devicePreset)}
408
+ </div>
409
+
410
+ ${this._eventsPanelOpen ? this._renderEventsPanel() : ''}
411
+ `;
412
+ }
413
+
414
+ _renderToolbar() {
415
+ return html`
321
416
  <div part="toolbar" class="ac-demo-content__toolbar">
322
417
  <div class="ac-demo-content__toolbar-cases">${this._renderCaseSwitcher(this._cases)}</div>
323
418
  <div class="ac-demo-content__toolbar-controls">
@@ -328,12 +423,6 @@ export class DemoContent extends ComponentMixin(LitElement) {
328
423
  ${this._eventNames.length ? this._renderEventsButton() : ''}
329
424
  </div>
330
425
  </div>
331
-
332
- <div class="ac-demo-content__stage">
333
- ${this._viewMode === 'code' ? this._renderCodeView() : this._renderDeviceStage(devicePreset)}
334
- </div>
335
-
336
- ${this._eventsPanelOpen ? this._renderEventsPanel() : ''}
337
426
  `;
338
427
  }
339
428