@govbr-ds/playground 0.0.0-stage → 5.2.1

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.
Files changed (81) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +30 -2
  3. package/dist/Playground.d.ts +7 -0
  4. package/dist/Playground.d.ts.map +1 -0
  5. package/dist/browser/chunks/babel-PXSNAHUX.js +16 -0
  6. package/dist/browser/chunks/chunk-3JEV5GFZ.js +1 -0
  7. package/dist/browser/chunks/chunk-5A3ZKBRD.js +11 -0
  8. package/dist/browser/chunks/chunk-6DHFEWGX.js +1 -0
  9. package/dist/browser/chunks/chunk-7G6EEGZ4.js +25 -0
  10. package/dist/browser/chunks/chunk-EP7B2XPY.js +13 -0
  11. package/dist/browser/chunks/chunk-TFWQIFOZ.js +1 -0
  12. package/dist/browser/chunks/chunk-UVFYWQD2.js +1 -0
  13. package/dist/browser/chunks/chunk-WUR2JRNJ.js +1 -0
  14. package/dist/browser/chunks/chunk-ZIL2IWZ3.js +1 -0
  15. package/dist/browser/chunks/dist-H5E3DUQZ.js +1 -0
  16. package/dist/browser/chunks/dist-HT72W6BH.js +1 -0
  17. package/dist/browser/chunks/dist-MALZEIQI.js +1 -0
  18. package/dist/browser/chunks/esm-3ZNLC56K.js +2 -0
  19. package/dist/browser/chunks/esm-6SLZNXJD.js +1 -0
  20. package/dist/browser/chunks/estree-EALESNBX.js +44 -0
  21. package/dist/browser/chunks/html-C5MOHUJO.js +25 -0
  22. package/dist/browser/chunks/postcss-RXMLIASD.js +62 -0
  23. package/dist/browser/chunks/standalone-G7AM3SII.js +29 -0
  24. package/dist/browser/index.d.ts +8 -0
  25. package/dist/browser/index.d.ts.map +1 -0
  26. package/dist/browser/index.js +397 -0
  27. package/dist/components/CodeMirrorEditor.d.ts +22 -0
  28. package/dist/components/CodeMirrorEditor.d.ts.map +1 -0
  29. package/dist/components/ControlsPanel.d.ts +17 -0
  30. package/dist/components/ControlsPanel.d.ts.map +1 -0
  31. package/dist/components/Workbench.d.ts +21 -0
  32. package/dist/components/Workbench.d.ts.map +1 -0
  33. package/dist/core/index.d.ts +233 -0
  34. package/dist/core/index.d.ts.map +1 -0
  35. package/dist/core/index.js +410 -0
  36. package/dist/index.d.ts +6 -0
  37. package/dist/index.d.ts.map +1 -0
  38. package/dist/library/components.d.ts +36 -0
  39. package/dist/library/components.d.ts.map +1 -0
  40. package/dist/library/profile.d.ts +23 -0
  41. package/dist/library/profile.d.ts.map +1 -0
  42. package/dist/react/chunks/babel-PXSNAHUX.js +16 -0
  43. package/dist/react/chunks/chunk-3JEV5GFZ.js +1 -0
  44. package/dist/react/chunks/chunk-5A3ZKBRD.js +11 -0
  45. package/dist/react/chunks/chunk-6DHFEWGX.js +1 -0
  46. package/dist/react/chunks/chunk-EP7B2XPY.js +13 -0
  47. package/dist/react/chunks/chunk-TFWQIFOZ.js +1 -0
  48. package/dist/react/chunks/chunk-UVFYWQD2.js +1 -0
  49. package/dist/react/chunks/chunk-WUR2JRNJ.js +1 -0
  50. package/dist/react/chunks/chunk-ZIL2IWZ3.js +1 -0
  51. package/dist/react/chunks/dist-H5E3DUQZ.js +1 -0
  52. package/dist/react/chunks/dist-HT72W6BH.js +1 -0
  53. package/dist/react/chunks/dist-MALZEIQI.js +1 -0
  54. package/dist/react/chunks/esm-6SLZNXJD.js +1 -0
  55. package/dist/react/chunks/esm-YAO6K4CU.js +2 -0
  56. package/dist/react/chunks/estree-EALESNBX.js +44 -0
  57. package/dist/react/chunks/html-C5MOHUJO.js +25 -0
  58. package/dist/react/chunks/postcss-RXMLIASD.js +62 -0
  59. package/dist/react/chunks/standalone-G7AM3SII.js +29 -0
  60. package/dist/react/index.js +354 -0
  61. package/dist/sources.d.ts +47 -0
  62. package/dist/sources.d.ts.map +1 -0
  63. package/dist/styles.css +2086 -0
  64. package/dist/utils/drafts.d.ts +9 -0
  65. package/dist/utils/drafts.d.ts.map +1 -0
  66. package/dist/utils/editorHistory.d.ts +14 -0
  67. package/dist/utils/editorHistory.d.ts.map +1 -0
  68. package/dist/utils/encoders.d.ts +43 -0
  69. package/dist/utils/encoders.d.ts.map +1 -0
  70. package/dist/utils/formatters.d.ts +6 -0
  71. package/dist/utils/formatters.d.ts.map +1 -0
  72. package/dist/utils/frameworks.d.ts +15 -0
  73. package/dist/utils/frameworks.d.ts.map +1 -0
  74. package/dist/utils/previewLocale.d.ts +19 -0
  75. package/dist/utils/previewLocale.d.ts.map +1 -0
  76. package/dist/utils/sourceModel.d.ts +52 -0
  77. package/dist/utils/sourceModel.d.ts.map +1 -0
  78. package/dist/utils/visibility.d.ts +3 -0
  79. package/dist/utils/visibility.d.ts.map +1 -0
  80. package/docs/configuration.md +400 -0
  81. package/package.json +59 -3
@@ -0,0 +1,9 @@
1
+ import type { PlaygroundExample } from '../core/index.js';
2
+ type Draft = Pick<PlaygroundExample, 'html' | 'css' | 'javascript' | 'id'> & {
3
+ updatedAt: number;
4
+ };
5
+ export declare function readDraft(runtimeId: string, exampleId?: string): Draft | null;
6
+ export declare function writeDraft(runtimeId: string, example: PlaygroundExample, exampleKey?: string | undefined): boolean;
7
+ export declare function clearDraft(runtimeId: string, exampleId?: string): void;
8
+ export {};
9
+ //# sourceMappingURL=drafts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drafts.d.ts","sourceRoot":"","sources":["../../src/utils/drafts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGzD,KAAK,KAAK,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,IAAI,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAMlG,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAmB7E;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,UAAU,qBAAa,WAgBhG;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,QAM/D"}
@@ -0,0 +1,14 @@
1
+ export declare const EDITOR_HISTORY_LIMIT = 50;
2
+ export type EditorHistory = {
3
+ entries: string[];
4
+ index: number;
5
+ };
6
+ export type EditorHistoryMove = {
7
+ changed: boolean;
8
+ history: EditorHistory;
9
+ value: string;
10
+ };
11
+ export declare function createEditorHistory(initialValue: string): EditorHistory;
12
+ export declare function recordEditorHistory(history: EditorHistory, value: string, limit?: number): EditorHistory;
13
+ export declare function moveEditorHistory(history: EditorHistory, offset: number): EditorHistoryMove;
14
+ //# sourceMappingURL=editorHistory.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"editorHistory.d.ts","sourceRoot":"","sources":["../../src/utils/editorHistory.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,aAAa,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CAEvE;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,SAAuB,GAC3B,aAAa,CAQf;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAe3F"}
@@ -0,0 +1,43 @@
1
+ /** Limites defensivos para links compartilháveis (estado não confiável). */
2
+ export declare const MAX_ENCODED_STATE_LENGTH: number;
3
+ export declare const MAX_DECOMPRESSED_STATE_LENGTH: number;
4
+ export declare const MAX_SOURCE_LENGTH: number;
5
+ export declare const MAX_PLAYGROUND_STATES = 32;
6
+ export type EncodedPlaygroundState = {
7
+ h: string;
8
+ j: string | null;
9
+ c: string;
10
+ s?: string;
11
+ exampleId?: string;
12
+ environment?: {
13
+ theme: 'light' | 'dark';
14
+ contrast: boolean;
15
+ skeleton: boolean;
16
+ reducedMotion: boolean;
17
+ locale: 'pt-BR' | 'en-US';
18
+ direction: 'ltr' | 'rtl';
19
+ width: number | '100%';
20
+ height: number;
21
+ };
22
+ };
23
+ /** Valida um estado antes que ele seja aplicado ao DOM ou executado no iframe. */
24
+ export declare function isEncodedPlaygroundState(value: unknown): value is EncodedPlaygroundState;
25
+ /**
26
+ * @file Playground Encoders
27
+ * @description Utilitários para codificação, decodificação e compressão de estado para links compartilháveis.
28
+ */
29
+ /**
30
+ * Codifica e comprime o estado do playground para uma string segura para URL.
31
+ * Utiliza LZString para reduzir drasticamente o tamanho da URL.
32
+ */
33
+ export declare function encodePlaygroundState(currentHtml: string, currentJs: string | null, currentCss: string, src?: string): string | null;
34
+ /** Codifica os estados modificados de todos os Playgrounds da página atual. */
35
+ export declare function encodePlaygroundStates(states: EncodedPlaygroundState[]): string | null;
36
+ /** Retorna os estados individuais de um link antigo ou do formato agregado. */
37
+ export declare function getEncodedPlaygroundStates(value: unknown): EncodedPlaygroundState[];
38
+ export declare function buildPlaygroundShareUrl(href: string, states: EncodedPlaygroundState[]): string;
39
+ /**
40
+ * Descomprime e decodifica o estado a partir de uma string codificada na URL.
41
+ */
42
+ export declare function decodePlaygroundState(encoded: string): unknown;
43
+ //# sourceMappingURL=encoders.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"encoders.d.ts","sourceRoot":"","sources":["../../src/utils/encoders.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,QAAa,CAAA;AAClD,eAAO,MAAM,6BAA6B,QAAc,CAAA;AACxD,eAAO,MAAM,iBAAiB,QAAa,CAAA;AAC3C,eAAO,MAAM,qBAAqB,KAAK,CAAA;AAEvC,MAAM,MAAM,sBAAsB,GAAG;IACnC,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;QACvB,QAAQ,EAAE,OAAO,CAAA;QACjB,QAAQ,EAAE,OAAO,CAAA;QACjB,aAAa,EAAE,OAAO,CAAA;QACtB,MAAM,EAAE,OAAO,GAAG,OAAO,CAAA;QACzB,SAAS,EAAE,KAAK,GAAG,KAAK,CAAA;QACxB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;QACtB,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF,CAAA;AAMD,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAqCxF;AAED;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAEf;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,GAAG,IAAI,CAetF;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,EAAE,CAKnF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,CAO9F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA6B9D"}
@@ -0,0 +1,6 @@
1
+ import type { PlaygroundConfig, PlaygroundExample } from '../core/index.js';
2
+ /** Formats sources without splitting HTML tag brackets to preserve inline whitespace. */
3
+ export declare function formatWithPrettier(code: string, parser: 'html' | 'babel' | 'css' | 'babel-ts'): Promise<string>;
4
+ export declare function formatExampleSource(example: PlaygroundExample): Promise<PlaygroundExample>;
5
+ export declare function formatPlaygroundConfig(config: PlaygroundConfig): Promise<PlaygroundConfig>;
6
+ //# sourceMappingURL=formatters.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAa3E,yFAAyF;AACzF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBrH;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAOhG;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYhG"}
@@ -0,0 +1,15 @@
1
+ import type { PlaygroundExample, PlaygroundResource } from '../core/index.js';
2
+ export type FrameworkName = 'angular' | 'react' | 'vue';
3
+ export type FrameworkFile = {
4
+ filename: string;
5
+ language: string;
6
+ code: string;
7
+ };
8
+ export type FrameworkSnippet = {
9
+ files: FrameworkFile[];
10
+ clipboardText?: string;
11
+ };
12
+ export type FrameworkPackages = Partial<Record<FrameworkName, string>>;
13
+ export declare function createFrameworkSnippets(example: PlaygroundExample, packages?: FrameworkPackages, resources?: PlaygroundResource[]): Partial<Record<FrameworkName | 'html', FrameworkSnippet>>;
14
+ export declare function snippetText(snippet: FrameworkSnippet): string;
15
+ //# sourceMappingURL=frameworks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frameworks.d.ts","sourceRoot":"","sources":["../../src/utils/frameworks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE7E,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,CAAA;AACvD,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAChF,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AACjF,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAA;AAkDtE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,GAAE,iBAAsB,EAChC,SAAS,GAAE,kBAAkB,EAAO,GACnC,OAAO,CAAC,MAAM,CAAC,aAAa,GAAG,MAAM,EAAE,gBAAgB,CAAC,CAAC,CA8D3D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,UAQpD"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Idiomas oferecidos na barra do preview para testar a internacionalização
3
+ * dos Web Components. A direção é configurada separadamente no preview.
4
+ */
5
+ export declare const PREVIEW_LOCALE_OPTIONS: readonly [{
6
+ readonly value: 'pt-BR';
7
+ readonly lang: 'pt-BR';
8
+ readonly label: 'Português (Brasil)';
9
+ }, {
10
+ readonly value: 'en-US';
11
+ readonly lang: 'en-US';
12
+ readonly label: 'English (US)';
13
+ }];
14
+ export type PreviewLocale = (typeof PREVIEW_LOCALE_OPTIONS)[number]['value'];
15
+ export type PreviewLocaleOption = (typeof PREVIEW_LOCALE_OPTIONS)[number];
16
+ export declare const DEFAULT_PREVIEW_LOCALE: PreviewLocale;
17
+ /** Retorna a opção de idioma; valores desconhecidos usam o idioma oficial. */
18
+ export declare function getPreviewLocaleOption(value: string): PreviewLocaleOption;
19
+ //# sourceMappingURL=previewLocale.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"previewLocale.d.ts","sourceRoot":"","sources":["../../src/utils/previewLocale.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,sBAAsB;aAC/B,KAAK,EAAE,OAAO;aAAE,IAAI,EAAE,OAAO;aAAE,KAAK,EAAE,oBAAoB;;aAC1D,KAAK,EAAE,OAAO;aAAE,IAAI,EAAE,OAAO;aAAE,KAAK,EAAE,cAAc;EAC9C,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAA;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzE,eAAO,MAAM,sBAAsB,EAAE,aAAuB,CAAA;AAE5D,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAEzE"}
@@ -0,0 +1,52 @@
1
+ export type SourceIssue = {
2
+ message: string;
3
+ from: number;
4
+ line: number;
5
+ column: number;
6
+ };
7
+ export type SourceAttribute = {
8
+ name: string;
9
+ from: number;
10
+ to: number;
11
+ valueFrom?: number;
12
+ valueTo?: number;
13
+ quote: string;
14
+ raw: string;
15
+ dynamic: boolean;
16
+ };
17
+ export type SourceElement = {
18
+ tag: string;
19
+ index: number;
20
+ id?: string;
21
+ from: number;
22
+ to: number;
23
+ openEnd: number;
24
+ contentFrom: number;
25
+ contentTo: number;
26
+ attributes: SourceAttribute[];
27
+ children: SourceElement[];
28
+ };
29
+ export type SourceModel = {
30
+ source: string;
31
+ elements: SourceElement[];
32
+ issues: SourceIssue[];
33
+ };
34
+ export declare function parseHtmlSource(source: string): SourceModel;
35
+ export declare function dynamicAttribute(element: SourceElement, name: string): boolean;
36
+ /** Edits only one authored attribute range; all other bytes remain untouched. */
37
+ export declare function changeSourceAttribute(source: string, target: {
38
+ tag: string;
39
+ index: number;
40
+ }, name: string, value: string | boolean | null): string;
41
+ /** Plain text slots are editable; nested markup, comments and bindings remain authored. */
42
+ export declare function changeSourceText(source: string, target: {
43
+ tag: string;
44
+ index: number;
45
+ }, slot: string, value: string): string;
46
+ export declare function validateSource(html: string, css?: string, javascript?: string): SourceIssue[];
47
+ /** Replaces only the selected slot's authored content; edits are explicitly applied by the user. */
48
+ export declare function changeSourceSlotMarkup(source: string, target: {
49
+ tag: string;
50
+ index: number;
51
+ }, slot: string, markup: string): string;
52
+ //# sourceMappingURL=sourceModel.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sourceModel.d.ts","sourceRoot":"","sources":["../../src/utils/sourceModel.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AACzF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AACD,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,QAAQ,EAAE,aAAa,EAAE,CAAA;CAC1B,CAAA;AACD,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AAc9F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAgE3D;AASD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAI9E;AAOD,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,GAC7B,MAAM,CAiBR;AACD,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAoBR;AACD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,EAAE,UAAU,SAAK,GAAG,WAAW,EAAE,CAarF;AAED,oGAAoG;AACpG,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACtC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,MAAM,CAkBR"}
@@ -0,0 +1,3 @@
1
+ import type { PlaygroundHiddenItems } from '../core/index.js';
2
+ export declare function isPlaygroundItemHidden(id: string, hidden?: PlaygroundHiddenItems): boolean;
3
+ //# sourceMappingURL=visibility.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../src/utils/visibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAE7D,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAE1F"}
@@ -0,0 +1,400 @@
1
+ # API do Playground compartilhado
2
+
3
+ Esta é a referência de `@govbr-ds/playground`. As fontes dos tipos ficam em
4
+ [`src/core/index.ts`](../src/core/index.ts), [`src/sources.ts`](../src/sources.ts)
5
+ e [`src/library/profile.ts`](../src/library/profile.ts). A aplicação controla
6
+ os recursos executáveis; o componente apresenta o editor e um iframe isolado.
7
+
8
+ ## Entradas do pacote e instalação
9
+
10
+ - `@govbr-ds/playground` e `/react`: `Playground`, tipos públicos, funções de
11
+ fontes e perfil, `createPreviewDocument` e `isPlaygroundConfig`.
12
+ - `/browser`: `mountPlayground(element, config)`, funções de fontes e perfil.
13
+ Retorna `update(config)` (remonta a instância) e `destroy()`.
14
+ - `/core`: tipos do runtime/perfil, `createPreviewDocument(config, channelId)` e
15
+ `isPlaygroundConfig(value)`. Este último verifica somente `runtime.id` e
16
+ `example.html`; não é validação completa de arquivos externos.
17
+ - `/styles.css`: estilos da interface, importados uma vez pela aplicação.
18
+
19
+ ```tsx
20
+ import { Playground } from '@govbr-ds/playground/react'
21
+ import '@govbr-ds/playground/styles.css'
22
+
23
+ ;<Playground
24
+ className="meu-playground"
25
+ config={{
26
+ runtime: { id: 'button' },
27
+ example: { html: '<br-button>Continuar</br-button>' },
28
+ }}
29
+ />
30
+ ```
31
+
32
+ `className` aplica uma classe na seção raiz. O host deve conceder altura ao
33
+ playground, por exemplo `.meu-playground { height: 80vh; min-height: 32rem; }`.
34
+ Em React, mantenha `config` estável (por exemplo, com `useMemo`) quando o host
35
+ é renderizado novamente: uma configuração nova reinicia a preparação das fontes.
36
+ Os recursos e bibliotecas carregam no cliente; React renderiza uma mensagem de
37
+ carregamento no servidor. Para Docusaurus, use o adaptador descrito abaixo.
38
+
39
+ Desenvolvimento local: `pnpm link <produtor>/packages/playground` no consumidor.
40
+ Depois de editar o produtor, execute `pnpm --filter @govbr-ds/playground build`.
41
+ O link consome `dist`, não os arquivos TypeScript. A publicação não é necessária.
42
+
43
+ ## Formas de fornecer os exemplos
44
+
45
+ As formas anteriores permanecem: `example` inline e `examples` com grupos já
46
+ carregados. A nova propriedade `source` aceita uma pasta, manifesto ou arquivo.
47
+
48
+ ```ts
49
+ // Código já carregado pelo integrador.
50
+ { runtime: { id: 'inline' }, example: { html: '<br-button>Ação</br-button>', css: '', javascript: '' } }
51
+
52
+ // Pasta servida: busca /exemplos/button/examples.json.
53
+ { runtime: { id: 'folder' }, source: { directory: '/exemplos/button/' } }
54
+
55
+ // Arquivo específico: busca examples.json ao lado e seleciona a entrada source correspondente.
56
+ { runtime: { id: 'file' }, source: { file: '/exemplos/button/designer.html' } }
57
+
58
+ // Manifesto em URL explícita; file é opcional.
59
+ { runtime: { id: 'manifest' }, source: { manifest: 'https://exemplo.test/button/examples.json' } }
60
+ { runtime: { id: 'manifest-file' }, source: { manifest: '/catalogo/button.json', file: '/exemplos/button/designer.html' } }
61
+ ```
62
+
63
+ A pasta é uma **URL HTTP(S)**, não um caminho do filesystem. Publique-a no
64
+ servidor estático do host; não existe enumeração automática de diretórios no
65
+ navegador. Todos os exemplos são descobertos pela lista de `examples.json`.
66
+ `file://` não é aceito. URLs de outra origem exigem CORS. Alguns navegadores restringem recursos de loopback acessados por iframes de origem opaca. Para exemplos locais confiáveis, o integrador pode habilitar `runtime.allowSameOrigin`; o padrão continua isolado. O nome canônico do
67
+ manifesto adjacente é **`examples.json`**; para outro nome, use `source.manifest`.
68
+
69
+ O carregador resolve `source`, `style` e `script` relativos à pasta do manifesto.
70
+ Para `source: 'button.html'`, tenta também `button.css` e `button.js`; ausência
71
+ 404 desses dois arquivos implícitos é permitida. Erro de arquivo explicitamente
72
+ configurado é apresentado, assim como JSON inválido, exemplos duplicados e
73
+ arquivo selecionado ausente/oculto. Respostas HTML do fallback de SPA não são
74
+ interpretadas como CSS/JS implícitos. Caminhos de assets dentro do HTML usam
75
+ `runtime.baseUrl` ou, na ausência dele, a pasta do manifesto.
76
+
77
+ O carregamento é atômico: primeiro carrega os exemplos visíveis, depois monta o
78
+ playground. Trocar `config` cancela o fetch anterior. Se `source` existir, seu
79
+ manifesto determina `example` e `examples`. Sem `source`, os códigos inline
80
+ continuam sendo utilizados diretamente. A seleção e os rascunhos salvos ou
81
+ compartilhados podem restaurar outro exemplo conhecido do mesmo playground.
82
+
83
+ ### Manifesto completo
84
+
85
+ ```json
86
+ {
87
+ "schemaVersion": 2,
88
+ "examples": [
89
+ { "id": "developer", "label": "Desenvolvedor", "source": "button.html" },
90
+ {
91
+ "id": "design",
92
+ "label": "Apresentações para design",
93
+ "source": "button.html",
94
+ "ui": { "mode": "designer", "designer": { "controls": "examples" } },
95
+ "items": [
96
+ { "id": "examples", "label": "Com seleção de exemplos" },
97
+ {
98
+ "id": "preview",
99
+ "label": "Somente preview",
100
+ "ui": { "mode": "designer", "designer": { "controls": "none" } }
101
+ }
102
+ ]
103
+ }
104
+ ],
105
+ "groups": [{ "id": "default", "label": "Button", "examples": ["developer", "design"], "defaultExample": "developer" }]
106
+ }
107
+ ```
108
+
109
+ `groups` é opcional: sem ele, todos os exemplos visíveis ficam no grupo
110
+ `default`. Cada grupo exige `id` e `label`; `examples` referencia IDs de exemplos
111
+ ou categorias e `defaultExample` escolhe o inicial. `hidden: true` remove o grupo.
112
+ Um padrão oculto usa o primeiro exemplo visível. Referências desconhecidas falham.
113
+
114
+ Categorias usam `items`, aceitam um nível e exigem filhos com `id`/`label`.
115
+ `design.preview` do exemplo acima tem ID normalizado `design-preview` e metadados
116
+ `category: { id: 'design', label: 'Apresentações para design' }`. O filho herda
117
+ campos do pai e pode substituí-los, inclusive o objeto `ui` inteiro. `hidden` no
118
+ pai oculta todos os filhos. IDs normalizados devem ser únicos. Use IDs estáveis
119
+ para que URLs e rascunhos continuem identificando o exemplo certo.
120
+
121
+ O carregador do pacote respeita `hidden` e não filtra tags automaticamente. O
122
+ adaptador Docusaurus do consumidor pode aplicar a política editorial `prod`.
123
+
124
+ ## Propriedades da configuração
125
+
126
+ | Campo | Tipo/padrão | Função |
127
+ | -------------- | ------------------------------------ | -------------------------------------------------------------------------------------------------- |
128
+ | `runtime` | objeto obrigatório | Identidade, biblioteca e recursos do iframe. |
129
+ | `example` | `PlaygroundExample` | Obrigatório em configuração inline; código inicial. |
130
+ | `examples` | lista de grupos | Grupos com `id`, `label`, `examples` já hidratados, `defaultExample` e `viewport` opcionais. |
131
+ | `source` | objeto opcional | Carregamento externo descrito acima. |
132
+ | `library` | perfil; padrão WBC 2.7.0 | Biblioteca dos controles da interface e padrão do preview. |
133
+ | `features` | mapa; todas habilitadas | Desativa capacidades, conforme lista abaixo. |
134
+ | `ui` | objeto opcional | Apresentação, dimensões, abas, ações e visibilidade. |
135
+ | `controls` | objeto opcional | Manifesto do inspetor. |
136
+ | `onChange` | `(example, original) => void` | Notifica fontes/seleção atuais e fonte original carregada; pode ser usado para anexos de feedback. |
137
+ | `onShare` | `(example) => void ou Promise<void>` | Callback de compartilhamento; sem ele, gera URL com estado. |
138
+ | `onStackblitz` | `(example) => void` | Integração externa criada pelo host; habilita a ação correspondente. |
139
+
140
+ ### `PlaygroundExample`
141
+
142
+ | Campo | Função |
143
+ | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
144
+ | `html` | HTML obrigatório no formato inline. |
145
+ | `css`, `javascript` | Fontes opcionais. HTML/CSS são atualizados ao vivo; JS válido recarrega após 500 ms de inatividade. Há também recarga explícita. |
146
+ | `id`, `label` | Identidade e texto da seleção. Necessários no manifesto. |
147
+ | `description`, `details` | Resumo visível e explicação detalhada que pode ser recolhida. |
148
+ | `tags` | `handoff`, `testes`, `prod`: metadados; não aparecem como selos na interface. |
149
+ | `category` | `{ id, label }`: agrupa opções e habilita seletor condicional dos filhos. |
150
+ | `background` | Cor CSS global ou mapa por tema e modo de cor. Campos omitidos usam o fundo padrão dos tokens do tema. |
151
+ | `viewport` | ID de viewport ou `{ id?, label?, width?, height?, x?, y? }`. `x/y` são dimensões legadas. |
152
+ | `ui` | `mode`, `designer`, `hidden`: overrides de apresentação por exemplo. |
153
+
154
+ O fundo pode variar por tema e modo de cor. Os modos são `main` (principal) e
155
+ `contrast`; valores ausentes continuam usando o fundo padrão dos tokens.
156
+
157
+ ```json
158
+ {
159
+ "background": {
160
+ "light": { "main": "#e4e4e4", "contrast": "#ffffff" },
161
+ "dark": { "main": "#252525", "contrast": "#000000" }
162
+ }
163
+ }
164
+ ```
165
+
166
+ Também são aceitos uma cor CSS como string e o formato anterior
167
+ `{ "light": "...", "dark": "...", "contrast": "..." }`. Nesse formato,
168
+ `contrast` fornece um único fallback para o modo contraste nos dois temas.
169
+
170
+ No manifesto, `source`, `style` e `script` são nomes/URLs de arquivos. Para
171
+ metadados já hidratados, aceita `html/css/javascript` ou os campos do adaptador
172
+ `code/styleCode/scriptCode`. `hidden: true` elimina a entrada; `items` declara
173
+ uma categoria. Os campos de arquivos não são executados como caminhos locais.
174
+
175
+ ### Biblioteca (`library` e `runtime.library`)
176
+
177
+ | Campo | Função |
178
+ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
179
+ | `profile` | `wbc` ou `wbc-v4`. |
180
+ | `version` | Versão npm. WBC assume `2.7.0`; v4 exige versão ou `moduleUrl`. |
181
+ | `moduleUrl` | Módulo explícito. Deve registrar componentes ao importar ou exportar funções `defineCustomElement*`. |
182
+ | `styles` | Lista de URLs CSS; substitui os estilos padrão, inclusive quando vazia. |
183
+ | `tokensVersion` | Versão dos tokens para o padrão v4; padrão `4.0.0-next.39`. |
184
+ | `fontAwesomeVersion` | `5.15.4` ou `6.7.2` (padrão); identifica a versão do perfil. O host fornece o CSS de ícones quando necessário. |
185
+ | `registration` | `module` (padrão) carrega/registra a biblioteca da interface; `existing` usa `br-button`/`br-select` previamente registrados pelo host e seus estilos. |
186
+
187
+ A interface registra uma biblioteca por documento. Trocar o perfil após o
188
+ registro requer recarregar a página. `registration: 'existing'` exige que o host
189
+ forneça componentes compatíveis com o perfil; é o caso do Docusaurus v4. Essa
190
+ opção só altera o registro da interface: o iframe sempre carrega seus recursos.
191
+ `runtime.library`, quando informado, seleciona a biblioteca do componente em
192
+ avaliação independentemente da interface.
193
+
194
+ ```ts
195
+ library: { profile: 'wbc', version: '2.7.0' },
196
+ runtime: {
197
+ id: 'button-v4',
198
+ library: {
199
+ profile: 'wbc-v4',
200
+ moduleUrl: '/components/components.esm.js',
201
+ styles: ['/tokens.css', '/fonts.css'],
202
+ },
203
+ importMap: { '@govbr-ds/components': '/components/index.esm.js' },
204
+ }
205
+ ```
206
+
207
+ ### Runtime e recursos injetados
208
+
209
+ | Campo de `runtime` | Função |
210
+ | ------------------- | ----------------------------------------------------------------------------------------------- |
211
+ | `id` | String obrigatória; separa preferências e rascunhos. |
212
+ | `baseUrl` | URL base para os caminhos relativos do documento. |
213
+ | `library` | Perfil independente do preview. |
214
+ | `resources` | Estilos/scripts adicionais, na ordem declarada. |
215
+ | `importMap` | Mapa `specifier → URL` aplicado antes dos módulos. |
216
+ | `bootstrap` | Código de módulo confiável do integrador; executa antes do JS do exemplo. |
217
+ | `modeStyles` | CSS do integrador para temas/modos no iframe. |
218
+ | `eventTypes` | Eventos adicionais observados junto dos eventos padrão do pacote. |
219
+ | `componentPackage` | Nome/versão do pacote nos snippets, ex. `@govbr-ds/components@4.0.0-next.1`. |
220
+ | `frameworkPackages` | Pacotes dos wrappers `{ angular, react, vue }` nos snippets. |
221
+ | `allowSameOrigin` | `false` por padrão. Ative apenas para código local confiável que precisa compartilhar a origem. |
222
+
223
+ Cada recurso exige `id` não vazio e único. Tipos disponíveis:
224
+
225
+ ```ts
226
+ resources: [
227
+ { id: 'core', type: 'style', href: '/core.css', integrity: 'sha384-...', crossOrigin: 'anonymous' },
228
+ { id: 'fonts', type: 'inline-style', content: '@font-face { /* ... */ }' },
229
+ { id: 'legacy', type: 'script', src: '/legacy.js' },
230
+ { id: 'components', type: 'module', src: '/webcomponents.esm.js' },
231
+ { id: 'setup', type: 'inline-script', content: 'window.exampleReady = true' },
232
+ { id: 'module-setup', type: 'inline-module', content: 'console.log("Pronto")' },
233
+ ]
234
+ ```
235
+
236
+ `integrity` e `crossOrigin` são opcionais nos recursos externos; este último
237
+ aceita `anonymous` ou `use-credentials`. O sandbox padrão permite scripts e
238
+ formulários, mantendo origem opaca. Mensagens conferem origem, canal e janela
239
+ exata. Fornecer código a um playground significa permitir sua execução no iframe;
240
+ a visibilidade de controles não é uma política de permissões de código.
241
+
242
+ ## Features
243
+
244
+ Todos os IDs abaixo aceitam `false` para desativar a função. Omissão significa
245
+ habilitado; algumas dependem de dados/callbacks para aparecer.
246
+
247
+ | IDs | Função |
248
+ | ------------------------------ | ---------------------------------------------------------- |
249
+ | `editor` | Edição dos arquivos HTML/CSS/JS. |
250
+ | `history` | Desfazer e refazer. |
251
+ | `format`, `copy`, `share` | Formatar, copiar e compartilhar. |
252
+ | `fullscreen`, `reset` | Tela cheia e restauração do exemplo. |
253
+ | `controls` | Inspetor de props e slots (requer manifesto). |
254
+ | `console`, `events` | Diagnóstico e eventos capturados. |
255
+ | `frameworks` | Snippets Angular, React e Vue. |
256
+ | `theme`, `contrast` | Tema e modo de contraste. |
257
+ | `locale`, `motion`, `skeleton` | Idioma/direção, movimento reduzido e Skeleton. |
258
+ | `drafts` | Persistência das fontes e ambiente no armazenamento local. |
259
+ | `stackblitz` | Ação externa (requer `onStackblitz`). |
260
+ | `resize` | Alças para alterar dimensões do iframe. |
261
+
262
+ ## UI e apresentação
263
+
264
+ | Campo de `ui` | Função |
265
+ | ------------------------------- | --------------------------------------------------------------------------- |
266
+ | `mode` | `developer` (padrão) ou `designer`; cada `example.ui.mode` tem prioridade. |
267
+ | `designer.controls` | `examples` (padrão): preview com seletores; `none`: somente iframe. |
268
+ | `title` | Nome acessível do iframe. |
269
+ | `componentName` | Título visual; omita quando o host já o apresenta. |
270
+ | `stateId` | Identidade estável para vários playgrounds na mesma URL. |
271
+ | `previewWidth`, `previewHeight` | Dimensões iniciais; largura aceita número ou string CSS. |
272
+ | `previewHeightMode` | `auto`, `fixed`, `adjustable`; o padrão efetivo atual é `adjustable`. |
273
+ | `previewMaxHeight` | Limite da altura automática; padrão 600 px, limitado a 180–2000. |
274
+ | `workspace` | Configuração inicial dos painéis (abaixo). |
275
+ | `viewports` | Opções de viewport (abaixo). |
276
+ | `hidden` | Visibilidade granular (abaixo). |
277
+ | `actions`, `tabs` | Ações e abas extras (abaixo). |
278
+ | `showExampleTags` | Campo legado sem efeito visual; tags permanecem nos metadados. |
279
+ | `labels` | Campo reservado sem aplicação aos textos atuais; não é uma API de tradução. |
280
+
281
+ ### Designer por exemplo, sem seletor de interface
282
+
283
+ ```json
284
+ {
285
+ "id": "designer",
286
+ "label": "Designer",
287
+ "source": "button.html",
288
+ "ui": { "mode": "designer", "designer": { "controls": "examples" } }
289
+ }
290
+ ```
291
+
292
+ `controls: 'none'` mostra só o iframe; a seleção de outro exemplo passa a ser
293
+ responsabilidade do host. Sem `ui`, vale a configuração global, cujo padrão é
294
+ desenvolvedor. A troca de apresentação preserva o iframe. Um filho de categoria
295
+ pode substituir `ui` herdado do pai. Os grupos de `example.ui.hidden` substituem
296
+ os grupos correspondentes de `config.ui.hidden`.
297
+
298
+ ### Workspace e dimensões
299
+
300
+ `workspace` aceita `layout: 'auto' | 'horizontal' | 'vertical'`,
301
+ `preset: 'visual' | 'code' | 'inspection'`, `split` (percentual inicial do preview,
302
+ 20–80) e `properties` (boolean para abrir inspetor; padrão acompanha preset).
303
+ São configurações iniciais, sem seletor de organização na interface. Preferências
304
+ locais salvas têm prioridade. A disposição automática usa a largura concedida
305
+ pelo host, não apenas a largura da janela; os limites atuais são 700/1100/1600 px.
306
+
307
+ O padrão de divisão é 60/40, respeitando configuração explícita e mínimos dos
308
+ painéis. Arraste a divisória para alterar largura lado a lado ou altura na
309
+ composição empilhada. Cada orientação conserva sua proporção. Setas ajustam,
310
+ Shift aumenta o passo, Home/End vão aos limites e duplo clique restaura 60/40.
311
+ O redimensionamento mantém as instâncias no iframe.
312
+
313
+ Cada viewport tem `id`, `label`, `width` (número ou `100%`), `height` e `hidden`
314
+ opcional. Lista padrão: Desktop 100% × 300, Tablet 768 × 600 e Mobile 375 × 812.
315
+ `hidden.viewports` pode ocultar opções. Uma escolha nomeada limpa o tamanho
316
+ manual. O viewport do exemplo tem prioridade sobre a configuração inicial.
317
+
318
+ ### Ocultar qualquer controle/aba
319
+
320
+ Cada grupo aceita `true` ou lista de IDs. Para inputs/selects/switches/botões,
321
+ `hidden.controls` aceita também o nome acessível exato, por exemplo `Framework`,
322
+ `Buscar propriedade`, `Tipo de mensagem` ou `Restaurar padrão de disabled`.
323
+
324
+ | Grupo | IDs |
325
+ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
326
+ | `actions` | `undo`, `redo`, `format`, `copy`, `share`, `reset`, `fullscreen`, `stackblitz`, `execute` (recarregar preview), IDs extras. |
327
+ | `tabs` | `code`, `controls`, `console`, `events`, `html`, `javascript`, `css`, `frameworks`, `angular`, `react`, `vue`, IDs extras. |
328
+ | `controls` | `example` (principal e filho), `category` (só filho), `settings`, `theme`, `contrast`, `locale`, `direction`, `motion`, `skeleton`, `viewport`, `resize`, `preview-title`, `dimensions`, `panels-resize`, `mobile-panels`, `tools-toggle` (mantém ferramentas abertas sem cabeçalho retrátil). |
329
+ | `viewports` | IDs das opções configuradas. `true` oculta o seletor. |
330
+ | `inspector` | `tree`, `search`, `groups`, `props`, `slots`; ou `prop:<tag>:<atributo>` e `slot:<tag>:<nome>`. Slot sem nome usa `default`. |
331
+
332
+ ```ts
333
+ ui: {
334
+ hidden: {
335
+ actions: ['share', 'stackblitz'],
336
+ tabs: ['console', 'events', 'javascript', 'css'],
337
+ controls: ['dimensions', 'Buscar propriedade'],
338
+ inspector: ['tree', 'prop:br-button:disabled'],
339
+ viewports: ['tablet'],
340
+ },
341
+ }
342
+ ```
343
+
344
+ `hidden.tabs: true` elimina ferramentas e deixa o preview ocupar a área.
345
+ A ação de recarga explícita usa `execute` e o nome acessível `Recarregar preview`.
346
+ Ocultar controles não altera o código do exemplo nem o estado do componente.
347
+
348
+ ### Ações e abas extras
349
+
350
+ ```tsx
351
+ ui: {
352
+ actions: [{ id: 'download', label: 'Baixar fonte', icon: '↓', onClick: (context) => console.log(context.getCode()) }],
353
+ tabs: [{ id: 'notes', label: 'Notas', render: () => <p>Notas do exemplo</p> }],
354
+ }
355
+ ```
356
+
357
+ Cada ação recebe `PlaygroundActionContext`, com `getCode`, `setCode(partial)`,
358
+ `reset`, `openFullscreen`, `undo`, `redo`, `copyCode`, `share`, `format`,
359
+ `openStackblitz` e `toggleTheme`. Funções assíncronas retornam Promise onde
360
+ indicado nos tipos; respeitam as features habilitadas. Abas extras usam prefixo
361
+ interno `custom:`; podem ser ocultadas pelo ID simples ou prefixado.
362
+
363
+ ## Manifesto dos controles
364
+
365
+ `controls` aceita `manifest` inline ou `manifestUrl` (JSON por HTTP), além de
366
+ `tag` (componente inicial) e `target` (seletor para limitar instâncias).
367
+ O manifesto tem `components`, cada qual com `tag`, `description` opcional,
368
+ `props` e `slots`.
369
+
370
+ Props: `attribute`, `propertyName`, `control` (`checkbox`, `number`, `select`,
371
+ `text`, `json`), `description`, `required`, `group`, `type`, `default` e `values`.
372
+ Slots: `name` e `description` opcional. `propertyName` usa o nome JavaScript;
373
+ `attribute` usa a grafia HTML. O inspetor edita a fonte e o DOM compatível sem
374
+ remontar componentes. A descrição geral não é exibida; descrições dos campos
375
+ continuam disponíveis. Erros de fonte mantêm o último preview válido.
376
+
377
+ ## Integração Docusaurus
378
+
379
+ Use um componente adaptador que importe `/react` e `/styles.css`. Ele deve:
380
+
381
+ 1. Preservar props/caminhos das páginas MDX existentes e exemplos pré-compilados.
382
+ 2. Resolver caminhos com `useBaseUrl`, inclusive snapshots de versões anteriores.
383
+ 3. Usar `library.registration: 'existing'` quando o site já registra os mesmos
384
+ componentes e selecionar `runtime.library` para a versão avaliada no iframe.
385
+ 4. Fornecer manifesto de controles e recursos locais/publicados correspondentes.
386
+ 5. Conceder altura ao playground e usar callbacks para feedback/StackBlitz.
387
+
388
+ No consumidor `govbr-ds-components`, `SharedPlayground.tsx` realiza essa adaptação.
389
+ `<Playground src="/stencil-generated-docs/button/examples/default.html" controls frameworks />`
390
+ continua válido. O Button inclui a categoria **Modos do playground** no catálogo,
391
+ com desenvolvedor completo, controles selecionados, designer com seletores e
392
+ somente preview. O modo é definido no próprio `examples.json`.
393
+
394
+ ## Helpers de fontes
395
+
396
+ `normalizePlaygroundManifest(manifest)` expande categorias e filtra ocultos sem
397
+ fazer rede. `resolvePlaygroundConfig(input, options?)` retorna a configuração
398
+ hidratada. `options` aceita `baseUrl`, `signal` e `fetch` para integração/testes.
399
+ Configuração inline sem `source` é devolvida sem carregamento externo. Ambos os
400
+ helpers são exportados pelas entradas React/raiz e browser.