@promptui-lib/figma-parser 0.1.22 → 0.1.23

package/dist/parser/layout-parser.d.ts

@@ -14,6 +14,7 @@ export interface ILayoutProperties {
     height?: IStyleProperty;
     flex?: IStyleProperty;
     flexWrap?: IStyleProperty;
+    flexShrink?: IStyleProperty;
 }
 /**
  * Parseia padding de um node (funciona com ou sem Auto Layout)
@@ -26,11 +27,13 @@ export declare function parseLayout(node: IFigmaNode): ILayoutProperties;
 /**
  * Parseia sizing de um node
  * @param isRoot - indica se é o node raiz do componente
+ * @param parentHasAutoLayout - indica se o pai tem Auto Layout (para aplicar flex-shrink)
  */
-export declare function parseSizing(node: IFigmaNode, isRoot?: boolean): ILayoutProperties;
+export declare function parseSizing(node: IFigmaNode, isRoot?: boolean, parentHasAutoLayout?: boolean): ILayoutProperties;
 /**
  * Combina layout e sizing
  * @param isRoot - indica se é o node raiz do componente
+ * @param parentHasAutoLayout - indica se o pai tem Auto Layout
  */
-export declare function parseLayoutAndSizing(node: IFigmaNode, isRoot?: boolean): IStyleProperty[];
+export declare function parseLayoutAndSizing(node: IFigmaNode, isRoot?: boolean, parentHasAutoLayout?: boolean): IStyleProperty[];
 //# sourceMappingURL=layout-parser.d.ts.map

package/dist/parser/layout-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout-parser.d.ts","sourceRoot":"","sources":["../../src/parser/layout-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA4BrE,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAuBpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CA2F/D;AAwBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,OAAe,GAAG,iBAAiB,CA+ExF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,OAAe,GAAG,cAAc,EAAE,CAShG"}
+{"version":3,"file":"layout-parser.d.ts","sourceRoot":"","sources":["../../src/parser/layout-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA4BrE,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAuBpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CA2F/D;AAwBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,OAAe,EAAE,mBAAmB,GAAE,OAAe,GAAG,iBAAiB,CA+F9H;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,OAAe,EAAE,mBAAmB,GAAE,OAAe,GAAG,cAAc,EAAE,CAStI"}

package/dist/parser/layout-parser.js

@@ -141,11 +141,17 @@ function isScreenNode(node) {
 /**
  * Parseia sizing de um node
  * @param isRoot - indica se é o node raiz do componente
+ * @param parentHasAutoLayout - indica se o pai tem Auto Layout (para aplicar flex-shrink)
  */
-export function parseSizing(node, isRoot = false) {
+export function parseSizing(node, isRoot = false, parentHasAutoLayout = false) {
     const properties = {};
     // Se é o node raiz e é uma tela, usa viewport units
     const isScreen = isRoot && isScreenNode(node);
+    // Verifica se precisa de flex-shrink: 0 (quando tem sizing HUG ou FIXED dentro de flex)
+    const needsFlexShrink = parentHasAutoLayout && (node.layoutSizingHorizontal === 'HUG' ||
+        node.layoutSizingHorizontal === 'FIXED' ||
+        node.layoutSizingVertical === 'HUG' ||
+        node.layoutSizingVertical === 'FIXED');
     // Width
     if (node.layoutSizingHorizontal) {
         switch (node.layoutSizingHorizontal) {
@@ -217,15 +223,23 @@ export function parseSizing(node, isRoot = false) {
             value: 'hidden',
         };
     }
+    // Adiciona flex-shrink: 0 quando necessário
+    if (needsFlexShrink) {
+        properties.flexShrink = {
+            property: 'flex-shrink',
+            value: '0',
+        };
+    }
     return properties;
 }
 /**
  * Combina layout e sizing
  * @param isRoot - indica se é o node raiz do componente
+ * @param parentHasAutoLayout - indica se o pai tem Auto Layout
  */
-export function parseLayoutAndSizing(node, isRoot = false) {
+export function parseLayoutAndSizing(node, isRoot = false, parentHasAutoLayout = false) {
     const layout = parseLayout(node);
-    const sizing = parseSizing(node, isRoot);
+    const sizing = parseSizing(node, isRoot, parentHasAutoLayout);
     const combined = { ...layout, ...sizing };
     return Object.values(combined).filter((prop) => prop !== undefined);
 }

package/dist/parser/node-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-parser.d.ts","sourceRoot":"","sources":["../../src/parser/node-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EAOb,cAAc,EACd,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAiB5B,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAwB7D;AAqmBD;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CA6Cf;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,GAAE,aAAkB,GAC1B,aAAa,EAAE,CAEjB"}
+{"version":3,"file":"node-parser.d.ts","sourceRoot":"","sources":["../../src/parser/node-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EAOb,cAAc,EACd,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAiB5B,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAwB7D;AAulBD;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CA6Cf;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,GAAE,aAAkB,GAC1B,aAAa,EAAE,CAEjB"}

package/dist/parser/node-parser.js

@@ -61,24 +61,10 @@ function isAssetNode(node) {
     return false;
 }
 /**
- * Patterns para detectar elementos de formulário simulados
+ * Patterns para detectar elementos de formulário com prefixo explícito $tipo:nome
+ * O usuário deve marcar explicitamente os elementos para conversão
  */
-const FORM_ELEMENT_PATTERNS = {
-    // Input de texto (uma linha)
-    input: /^(input|text-?input|entrada|campo-texto|field-input|input-field)$/i,
-    // Textarea (múltiplas linhas)
-    textarea: /^(textarea|text-?area|area-?texto|multiline|multi-line|mensagem-input|message-input)$/i,
-    // Select/Dropdown
-    select: /^(select|dropdown|combo-?box|picker|seletor|selecao|lista-selecao|select-input)$/i,
-    // Checkbox
-    checkbox: /^(checkbox|check-?box|caixa-?selecao|toggle|switch)$/i,
-    // Radio button
-    radio: /^(radio|radio-?button|opcao-?radio|radio-?input)$/i,
-    // Button
-    button: /^(button|btn|botao|submit|cancel|action|cta)$/i,
-    // Label
-    label: /^(label|rotulo|field-?label|input-?label)$/i,
-};
+const FORM_ELEMENT_PREFIX_PATTERN = /^\$(input|textarea|select|checkbox|radio|button|label):/i;
 /**
  * Verifica se um node é um frame válido (FRAME, INSTANCE ou COMPONENT)
  */
@@ -135,51 +121,44 @@ function extractAllTexts(node) {
 }
 /**
  * Detecta qual tipo de elemento de formulário um node representa
+ *
+ * IMPORTANTE: A detecção só acontece quando o nome tem prefixo explícito:
+ *   $input:nome, $textarea:nome, $select:nome, etc.
+ *
+ * Isso preserva a estrutura visual do Figma por padrão.
  */
 function detectSimulatedFormElement(node) {
     if (!isValidFrameNode(node)) {
         return null;
     }
-    const name = node.name.toLowerCase().trim();
-    // Verifica cada pattern
-    if (FORM_ELEMENT_PATTERNS.textarea.test(name)) {
-        return 'textarea';
-    }
-    if (FORM_ELEMENT_PATTERNS.select.test(name)) {
-        return 'select';
-    }
-    if (FORM_ELEMENT_PATTERNS.checkbox.test(name)) {
-        return 'checkbox';
-    }
-    if (FORM_ELEMENT_PATTERNS.radio.test(name)) {
-        return 'radio';
-    }
-    if (FORM_ELEMENT_PATTERNS.button.test(name)) {
-        // Só é button se tiver texto dentro
-        if (hasTextChild(node)) {
-            return 'button';
-        }
-    }
-    if (FORM_ELEMENT_PATTERNS.label.test(name)) {
-        // Só é label se tiver texto direto como filho
-        if (node.children?.some(child => child.type === 'TEXT')) {
-            return 'label';
-        }
-    }
-    if (FORM_ELEMENT_PATTERNS.input.test(name)) {
-        // Só é input se tiver texto dentro (placeholder)
-        if (hasTextChild(node)) {
-            return 'input';
-        }
+    const name = node.name.trim();
+    // Verifica se tem prefixo explícito $tipo:nome
+    const match = name.match(FORM_ELEMENT_PREFIX_PATTERN);
+    if (!match) {
+        // Sem prefixo explícito = não é um form element
+        return null;
     }
-    return null;
+    const elementType = match[1].toLowerCase();
+    return elementType;
+}
+/**
+ * Extrai o nome limpo do node (remove prefixos especiais como $input:, #, etc.)
+ */
+function extractCleanName(name) {
+    // Remove prefixo de form element $tipo:
+    let clean = name.replace(FORM_ELEMENT_PREFIX_PATTERN, '');
+    // Remove prefixo de exportação #
+    clean = clean.replace(/^#/, '');
+    // Remove prefixo interno _
+    clean = clean.replace(/^_/, '');
+    return clean.trim();
 }
 /**
  * Detecta o tipo específico de input baseado no contexto
  */
 function detectInputType(node, parentNode) {
-    const nodeName = node.name.toLowerCase();
-    const parentName = parentNode?.name.toLowerCase() || '';
+    const nodeName = extractCleanName(node.name).toLowerCase();
+    const parentName = parentNode ? extractCleanName(parentNode.name).toLowerCase() : '';
     const combinedContext = `${parentName} ${nodeName}`;
     // Detecta por palavras-chave no contexto
     if (combinedContext.includes('senha') || combinedContext.includes('password')) {
@@ -209,7 +188,7 @@ function detectInputType(node, parentNode) {
  * Detecta o tipo de button baseado no contexto
  */
 function detectButtonType(node) {
-    const name = node.name.toLowerCase();
+    const name = extractCleanName(node.name).toLowerCase();
     const text = extractFirstText(node).toLowerCase();
     const context = `${name} ${text}`;
     if (context.includes('submit') || context.includes('enviar') || context.includes('entrar') || context.includes('login') || context.includes('cadastrar')) {
@@ -430,12 +409,14 @@ function collectStyles(node, blockName, depth = 0, parentNode) {
         : `.${generateBEMElement(blockName, elementName)}`;
     // Coleta propriedades deste node
     const properties = [];
+    // Verifica se o pai tem Auto Layout (para aplicar flex-shrink nos filhos)
+    const parentHasAutoLayoutMode = parentNode ? hasAutoLayout(parentNode) : false;
     // Layout e sizing
     // Para FRAME, COMPONENT, INSTANCE: extrai layout completo (flex, gap, etc)
     // Para GROUP: extrai sizing e position: relative (container sem flex)
     // Para outros tipos (RECTANGLE, etc): extrai apenas sizing (width, height)
     if (node.type === 'FRAME' || node.type === 'COMPONENT' || node.type === 'INSTANCE') {
-        properties.push(...parseLayoutAndSizing(node, isRoot));
+        properties.push(...parseLayoutAndSizing(node, isRoot, parentHasAutoLayoutMode));
         // Se é um container sem Auto Layout, adiciona position: relative
         const containerPos = parseContainerPosition(node);
         if (containerPos) {
@@ -452,7 +433,7 @@ function collectStyles(node, blockName, depth = 0, parentNode) {
     }
     else if (node.type === 'GROUP') {
         // GROUPs são containers visuais - precisam de position: relative e sizing
-        const sizingProps = parseSizing(node);
+        const sizingProps = parseSizing(node, false, parentHasAutoLayoutMode);
         const sizingArray = Object.values(sizingProps).filter((p) => p !== undefined);
         properties.push(...sizingArray);
         // GROUP sempre precisa de position: relative se tiver filhos
@@ -465,7 +446,7 @@ function collectStyles(node, blockName, depth = 0, parentNode) {
     }
     else if (node.type !== 'TEXT' && node.absoluteBoundingBox) {
         // Para elementos não-texto com dimensões, extrai apenas sizing
-        const sizingProps = parseSizing(node);
+        const sizingProps = parseSizing(node, false, parentHasAutoLayoutMode);
         const sizingArray = Object.values(sizingProps).filter((p) => p !== undefined);
         properties.push(...sizingArray);
     }

package/dist/parser/position-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"position-parser.d.ts","sourceRoot":"","sources":["../../src/parser/position-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAgB,MAAM,oBAAoB,CAAC;AAEnF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAoBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEhE;AAwBD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,UAAU,CAAC,EAAE,UAAU,GACtB,cAAc,EAAE,CA6IlB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAa/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAQ9E"}
+{"version":3,"file":"position-parser.d.ts","sourceRoot":"","sources":["../../src/parser/position-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAgB,MAAM,oBAAoB,CAAC;AAEnF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AA6BD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEhE;AAwBD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,UAAU,CAAC,EAAE,UAAU,GACtB,cAAc,EAAE,CA6IlB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAa/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAQ9E"}

package/dist/parser/position-parser.js

@@ -13,12 +13,20 @@ function roundPixelValue(value) {
     return Math.round(value * 10) / 10;
 }
 /**
- * Formata valor de pixel arredondado
+ * Formata valor de pixel arredondado (suporta valores negativos)
  */
 function formatPixels(value) {
     const rounded = roundPixelValue(value);
     return `${rounded}px`;
 }
+/**
+ * Formata valor de pixel para CSS, incluindo valores negativos
+ * Valores negativos são importantes para elementos que "vazam" do container
+ */
+function formatPixelsWithNegative(value) {
+    const rounded = roundPixelValue(value);
+    return `${rounded}px`;
+}
 /**
  * Verifica se um node pai tem Auto Layout
  */

package/dist/parser/semantic-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semantic-detector.d.ts","sourceRoot":"","sources":["../../src/parser/semantic-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAkRrD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAalD;AA0DD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,UAAU,CAAC,EAAE,UAAU,EACvB,MAAM,GAAE,MAAU,EAClB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,MAAM,CA4MR;AA+ID;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgLxB"}
+{"version":3,"file":"semantic-detector.d.ts","sourceRoot":"","sources":["../../src/parser/semantic-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAuRrD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAalD;AA0DD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,UAAU,CAAC,EAAE,UAAU,EACvB,MAAM,GAAE,MAAU,EAClB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,MAAM,CA4MR;AAgJD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgLxB"}

package/dist/parser/semantic-detector.js

@@ -184,13 +184,18 @@ const SEMANTIC_PATTERNS = {
     // Links
     link: /(link|anchor|href|ancora|forgot|esqueci|saiba-mais|ver-mais|leia-mais)/i,
     // Formulários
+    // NOTA: Patterns de form elements são desativados por padrão para preservar a estrutura visual.
+    // Use prefixo $input:, $label:, etc. no Figma para ativar a conversão.
+    // Os patterns abaixo são mantidos apenas para elementos claramente marcados.
     form: /^(form|formulario|login-form|signup-form|contact-form|search-form)/i,
-    input: /^(input|field|textfield|entrada|campo|text-input)/i,
-    label: /^(label|rotulo|field-label|input-label)/i,
-    select: /^(select|dropdown|picker|seletor|selecao|combobox)/i,
-    textarea: /^(textarea|text-area|area-texto|multiline)/i,
-    checkbox: /^(checkbox|check-box|caixa-selecao|toggle)/i,
-    radio: /^(radio|radio-button|opcao-radio)/i,
+    // input/label/select/etc NÃO são mais detectados automaticamente
+    // para evitar converter estruturas visuais em elementos HTML
+    input: /^(\$input:|never-match-automatically)/i, // Desativado - use $input:nome
+    label: /^(\$label:|never-match-automatically)/i, // Desativado - use $label:nome
+    select: /^(\$select:|never-match-automatically)/i, // Desativado - use $select:nome
+    textarea: /^(\$textarea:|never-match-automatically)/i, // Desativado - use $textarea:nome
+    checkbox: /^(\$checkbox:|never-match-automatically)/i, // Desativado - use $checkbox:nome
+    radio: /^(\$radio:|never-match-automatically)/i, // Desativado - use $radio:nome
     fieldset: /^(fieldset|field-group|grupo-campos)/i,
     // Navegação - expandido para mais variações
     nav: /^(nav|navigation|navbar|menu|navegacao|breadcrumb|tabs|pagination|nav-bar|top-nav|main-nav|side-nav)/i,
@@ -486,8 +491,9 @@ function detectTextTag(node, parentNode, normalizedName) {
     if (fontSize >= 24 && fontWeight >= 600) {
         return getHeadingLevel(fontSize);
     }
-    // Labels (geralmente associados a inputs)
-    if (SEMANTIC_PATTERNS.label.test(name)) {
+    // Labels - só detecta com prefixo explícito $label:
+    // NÃO detecta automaticamente para preservar estrutura visual
+    if (name.startsWith('$label:')) {
         return 'label';
     }
     // Links - mas não se o pai já é um link (evita <a> aninhado)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptui-lib/figma-parser",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "private": false,
   "description": "Figma API client and parser for PromptUI",
   "license": "UNLICENSED",
@@ -30,7 +30,7 @@
     "dist"
   ],
   "dependencies": {
-    "@promptui-lib/core": "0.1.22"
+    "@promptui-lib/core": "0.1.23"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",