@pine-ds/core 3.11.1 → 3.12.0

package/dist/scripts/vscode-custom-data-generator.js

@@ -0,0 +1,407 @@
+import * as fs from "fs";
+import * as path from "path";
+// Configuration
+const DOCS_BASE_URL = 'https://pine-design-system.netlify.app';
+// Cache for component tag -> storybook title mapping
+let storyTitleCache = null;
+let mdxCache = null;
+/**
+ * Find the MDX documentation file for a component
+ */
+function findMdxFile(componentTag) {
+    const componentsDir = path.resolve(__dirname, '..', 'src', 'components');
+    // Try direct path first: pds-button -> pds-button/docs/pds-button.mdx
+    const directPath = path.join(componentsDir, componentTag, 'docs', `${componentTag}.mdx`);
+    if (fs.existsSync(directPath)) {
+        return directPath;
+    }
+    // Try nested component path: pds-table-cell -> pds-table/pds-table-cell/docs/pds-table-cell.mdx
+    // Search recursively for the docs folder
+    const searchForMdx = (dir) => {
+        if (!fs.existsSync(dir))
+            return null;
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                if (entry.name === componentTag) {
+                    const mdxPath = path.join(dir, entry.name, 'docs', `${componentTag}.mdx`);
+                    if (fs.existsSync(mdxPath)) {
+                        return mdxPath;
+                    }
+                }
+                // Recurse into subdirectories
+                const found = searchForMdx(path.join(dir, entry.name));
+                if (found !== null)
+                    return found;
+            }
+        }
+        return null;
+    };
+    return searchForMdx(componentsDir);
+}
+/**
+ * Parse MDX content and extract h3 headings under the ## Examples section.
+ * Returns an array of example names (e.g., ["Primary", "Secondary", "Tertiary"]).
+ */
+function parseMdxExamples(mdxContent) {
+    const lines = mdxContent.split('\n');
+    const examples = [];
+    let inExamplesSection = false;
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        // Look for ## Examples heading
+        if (trimmedLine.toLowerCase() === '## examples') {
+            inExamplesSection = true;
+            continue;
+        }
+        // Stop at the next h2 heading (but not h3/h4)
+        if (inExamplesSection && trimmedLine.startsWith('## ') && trimmedLine.toLowerCase() !== '## examples') {
+            break;
+        }
+        // Collect h3 headings within the Examples section
+        if (inExamplesSection && trimmedLine.startsWith('### ')) {
+            const heading = trimmedLine.replace(/^### /, '').trim();
+            examples.push(heading);
+        }
+    }
+    return examples;
+}
+/**
+ * Parse MDX content and extract the first paragraph after the component name header.
+ * This provides a concise description for VS Code hover tooltips.
+ */
+function parseMdxToMarkdown(mdxContent) {
+    const lines = mdxContent.split('\n');
+    let foundHeader = false;
+    const paragraphLines = [];
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        // Skip import statements and JSX at the top
+        if (trimmedLine.startsWith('import ') || trimmedLine.startsWith('<Meta')) {
+            continue;
+        }
+        // Look for the main component header (# ComponentName)
+        if (!foundHeader && trimmedLine.startsWith('# ')) {
+            foundHeader = true;
+            continue;
+        }
+        // Once we've found the header, collect the first paragraph
+        if (foundHeader) {
+            // Skip empty lines before the paragraph starts
+            if (paragraphLines.length === 0 && trimmedLine === '') {
+                continue;
+            }
+            // Stop at the next heading, empty line after paragraph, or JSX
+            if (trimmedLine.startsWith('#') || trimmedLine.startsWith('<') || (paragraphLines.length > 0 && trimmedLine === '')) {
+                break;
+            }
+            paragraphLines.push(trimmedLine);
+        }
+    }
+    return paragraphLines.join(' ').trim();
+}
+/**
+ * Get parsed MDX data for a component (with caching).
+ * Reads and parses the MDX file once, extracting both docs and examples.
+ */
+function getMdxData(componentTag) {
+    if (!mdxCache) {
+        mdxCache = new Map();
+    }
+    const cached = mdxCache.get(componentTag);
+    if (cached) {
+        return cached;
+    }
+    const emptyData = { docs: '', examples: [] };
+    const mdxPath = findMdxFile(componentTag);
+    if (!mdxPath) {
+        mdxCache.set(componentTag, emptyData);
+        return emptyData;
+    }
+    try {
+        const mdxContent = fs.readFileSync(mdxPath, 'utf-8');
+        const data = {
+            docs: parseMdxToMarkdown(mdxContent),
+            examples: parseMdxExamples(mdxContent),
+        };
+        mdxCache.set(componentTag, data);
+        return data;
+    }
+    catch (_a) {
+        mdxCache.set(componentTag, emptyData);
+        return emptyData;
+    }
+}
+/**
+ * Recursively find all story files in a directory
+ */
+function findStoryFiles(dir) {
+    const results = [];
+    if (!fs.existsSync(dir)) {
+        return results;
+    }
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...findStoryFiles(fullPath));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.stories.js')) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+/**
+ * Build cache mapping component tags to their Storybook titles
+ * by reading story files
+ */
+function buildStoryTitleCache() {
+    if (storyTitleCache) {
+        return;
+    }
+    storyTitleCache = new Map();
+    const componentsDir = path.resolve(__dirname, '..', 'src', 'components');
+    const storyFiles = findStoryFiles(componentsDir);
+    for (const storyFile of storyFiles) {
+        try {
+            const content = fs.readFileSync(storyFile, 'utf-8');
+            // Extract component tag from the story file
+            const componentMatch = content.match(/component:\s*['"]([^'"]+)['"]/);
+            // Extract title from the story file
+            const titleMatch = content.match(/title:\s*['"]([^'"]+)['"]/);
+            if (componentMatch && titleMatch) {
+                storyTitleCache.set(componentMatch[1], titleMatch[1]);
+            }
+        }
+        catch (_a) {
+            // Skip files that can't be read
+        }
+    }
+}
+/**
+ * Get the Storybook title for a component
+ */
+function getStoryTitle(tag) {
+    buildStoryTitleCache();
+    return storyTitleCache === null || storyTitleCache === void 0 ? void 0 : storyTitleCache.get(tag);
+}
+/**
+ * Convert a Storybook title to a URL path segment
+ * e.g., "components/Table" -> "components-table"
+ * e.g., "components/Copy Text" -> "components-copy-text"
+ * e.g., "components/Radio Group/Radio" -> "components-radio-group-radio"
+ */
+function titleToUrlPath(title) {
+    return title
+        .toLowerCase()
+        .replace(/\s+/g, '-') // spaces to dashes
+        .replace(/\//g, '-'); // slashes to dashes
+}
+/**
+ * Get the Storybook documentation URL for a component
+ */
+function getComponentDocsUrl(tag) {
+    const title = getStoryTitle(tag);
+    if (title !== undefined) {
+        // Generate proper Storybook docs URL
+        const urlPath = titleToUrlPath(title);
+        return `${DOCS_BASE_URL}/?path=/docs/${urlPath}--docs`;
+    }
+    // Fallback for components without a story file
+    // Convert pds-button -> components-button
+    const componentName = tag.replace(/^pds-/, '');
+    return `${DOCS_BASE_URL}/?path=/docs/components-${componentName}--docs`;
+}
+/**
+ * Convert an MDX heading to a URL anchor fragment
+ * e.g., "Primary" -> "primary", "Icon Only" -> "icon-only", "Full Width" -> "full-width"
+ */
+function headingToAnchor(heading) {
+    return heading.toLowerCase().replace(/\s+/g, '-'); // spaces to dashes
+}
+/**
+ * Get a URL to a specific example section in the docs (using anchor)
+ */
+function getExampleUrl(tag, exampleHeading) {
+    const docsUrl = getComponentDocsUrl(tag);
+    const anchor = headingToAnchor(exampleHeading);
+    return `${docsUrl}#${anchor}`;
+}
+function formatPropDescription(prop) {
+    var _a, _b;
+    const parts = [];
+    // Main description
+    if (prop.docs) {
+        parts.push(prop.docs);
+    }
+    // Type info (skip common primitive types)
+    if (prop.type && prop.type !== 'string' && prop.type !== 'boolean') {
+        parts.push(`\n\n**Type:** \`${prop.type}\``);
+    }
+    // Default value
+    const defaultTag = (_a = prop.docsTags) === null || _a === void 0 ? void 0 : _a.find((t) => t.name === 'default');
+    const defaultValue = (defaultTag === null || defaultTag === void 0 ? void 0 : defaultTag.text) || prop.default;
+    if (defaultValue) {
+        parts.push(`\n\n**Default:** \`${defaultValue}\``);
+    }
+    // Deprecation warning
+    const deprecatedTag = (_b = prop.docsTags) === null || _b === void 0 ? void 0 : _b.find((t) => t.name === 'deprecated');
+    if (deprecatedTag) {
+        parts.push(`\n\n⚠️ **Deprecated:** ${deprecatedTag.text || 'This property is deprecated.'}`);
+    }
+    return parts.join('');
+}
+function formatComponentDescription(component) {
+    const parts = [];
+    const mdxData = getMdxData(component.tag);
+    // Try to get rich MDX documentation first, fallback to JSDoc description
+    if (mdxData.docs) {
+        parts.push(mdxData.docs);
+    }
+    else if (component.docs) {
+        parts.push(component.docs);
+    }
+    // Add Examples section with links to MDX example headings
+    if (mdxData.examples.length > 0) {
+        const exampleLinks = mdxData.examples.map((heading) => {
+            const url = getExampleUrl(component.tag, heading);
+            return `[${heading}](${url})`;
+        });
+        parts.push(`\n\n**Examples:**\n${exampleLinks.join(', ')}`);
+    }
+    // Slots
+    if (component.slots && component.slots.length > 0) {
+        parts.push('\n\n**Slots:**');
+        for (const slot of component.slots) {
+            const slotName = slot.name === '' || slot.name === '(default)' ? '(default)' : slot.name;
+            parts.push(`\n- \`${slotName}\` - ${slot.docs || 'No description'}`);
+        }
+    }
+    // CSS Parts
+    if (component.parts && component.parts.length > 0) {
+        parts.push('\n\n**CSS Parts:**');
+        for (const part of component.parts) {
+            parts.push(`\n- \`${part.name}\` - ${part.docs || 'No description'}`);
+        }
+    }
+    // Events
+    if (component.events && component.events.length > 0) {
+        parts.push('\n\n**Events:**');
+        for (const event of component.events) {
+            parts.push(`\n- \`${event.event}\` - ${event.docs || 'No description'}`);
+        }
+    }
+    return parts.join('');
+}
+function extractEnumValues(prop) {
+    // Check if prop.values has string literal values
+    if (prop.values === undefined || prop.values.length === 0) {
+        return undefined;
+    }
+    const enumValues = prop.values.filter((v) => v.type === 'string' && v.value);
+    if (enumValues.length === 0) {
+        return undefined;
+    }
+    return enumValues.map((v) => ({
+        name: v.value,
+        description: undefined, // Could be enhanced with JSDoc @value tags if we add them
+    }));
+}
+function convertPropToAttribute(prop) {
+    // Skip props that don't have an HTML attribute equivalent
+    if (prop.attr === undefined || prop.attr === '') {
+        return null;
+    }
+    const attribute = {
+        name: prop.attr,
+        description: {
+            kind: 'markdown',
+            value: formatPropDescription(prop),
+        },
+    };
+    // Add enum values if applicable
+    const enumValues = extractEnumValues(prop);
+    if (enumValues) {
+        attribute.values = enumValues;
+    }
+    return attribute;
+}
+function convertComponent(component) {
+    // Skip test/mock components
+    if (component.tag.startsWith('mock-') || component.filePath.includes('/test/')) {
+        return null;
+    }
+    const tag = {
+        name: component.tag,
+        description: {
+            kind: 'markdown',
+            value: formatComponentDescription(component),
+        },
+        attributes: [],
+        references: [
+            {
+                name: 'Documentation',
+                url: getComponentDocsUrl(component.tag),
+            },
+        ],
+    };
+    // Convert props to attributes
+    if (component.props !== undefined && component.props.length > 0) {
+        for (const prop of component.props) {
+            const attr = convertPropToAttribute(prop);
+            if (attr) {
+                tag.attributes.push(attr);
+            }
+        }
+    }
+    return tag;
+}
+export function generateVSCodeCustomData(docs, outputPath) {
+    // Reset caches for fresh generation
+    storyTitleCache = null;
+    mdxCache = null;
+    const customData = {
+        version: 1.1,
+        tags: [],
+    };
+    for (const component of docs.components) {
+        const tag = convertComponent(component);
+        if (tag) {
+            customData.tags.push(tag);
+        }
+    }
+    // Sort tags alphabetically
+    customData.tags.sort((a, b) => a.name.localeCompare(b.name));
+    const outputDir = path.dirname(outputPath);
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    const newContent = JSON.stringify(customData, null, 2);
+    // Only write if content has changed (prevents watch loop)
+    let existingContent = '';
+    try {
+        existingContent = fs.readFileSync(outputPath, 'utf-8');
+    }
+    catch (_a) {
+        // File doesn't exist yet, that's fine
+    }
+    if (newContent !== existingContent) {
+        fs.writeFileSync(outputPath, newContent);
+        console.log(`✅ Generated VS Code custom data: ${outputPath}`);
+        console.log(`   ${customData.tags.length} components documented`);
+    }
+    else {
+        console.log(`ℹ️  VS Code custom data unchanged: ${outputPath}`);
+    }
+}
+// For use as a Stencil docs-custom generator
+export default function vscodeCustomDataOutputTarget(outputPath = 'vscode.html-data.json') {
+    return {
+        type: 'docs-custom',
+        generator: (docs) => {
+            generateVSCodeCustomData(docs, outputPath);
+        },
+    };
+}
+//# sourceMappingURL=vscode-custom-data-generator.js.map

package/dist/scripts/vscode-custom-data-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode-custom-data-generator.js","sourceRoot":"","sources":["../../scripts/vscode-custom-data-generator.ts"],"names":[],"mappings":"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","sourcesContent":["import { JsonDocs, JsonDocsComponent, JsonDocsProp } from '@stencil/core/internal';\nimport * as fs from 'fs';\nimport * as path from 'path';\n\n/**\n * VS Code HTML Custom Data Generator\n *\n * Generates a VS Code custom data file that maximizes the spec:\n * - Tag descriptions with markdown\n * - Attribute descriptions with types and defaults\n * - Attribute value descriptions for enums\n * - References to documentation\n * - Slot documentation as attributes\n * - CSS Parts documentation\n * - Event documentation\n */\n\ninterface VSCodeCustomData {\n  version: 1.1;\n  tags: VSCodeTag[];\n  globalAttributes?: VSCodeAttribute[];\n}\n\ninterface VSCodeTag {\n  name: string;\n  description: string | { kind: 'markdown' | 'plaintext'; value: string };\n  attributes: VSCodeAttribute[];\n  references?: VSCodeReference[];\n}\n\ninterface VSCodeAttribute {\n  name: string;\n  description?: string | { kind: 'markdown' | 'plaintext'; value: string };\n  values?: VSCodeAttributeValue[];\n  references?: VSCodeReference[];\n}\n\ninterface VSCodeAttributeValue {\n  name: string;\n  description?: string;\n  references?: VSCodeReference[];\n}\n\ninterface VSCodeReference {\n  name: string;\n  url: string;\n}\n\n// Configuration\nconst DOCS_BASE_URL = 'https://pine-design-system.netlify.app';\n\n// Cache for component tag -> storybook title mapping\nlet storyTitleCache: Map<string, string> | null = null;\n\n// Cache for component tag -> parsed MDX data (docs and examples)\ninterface MdxParsedData {\n  docs: string;\n  examples: string[];\n}\nlet mdxCache: Map<string, MdxParsedData> | null = null;\n\n/**\n * Find the MDX documentation file for a component\n */\nfunction findMdxFile(componentTag: string): string | null {\n  const componentsDir = path.resolve(__dirname, '..', 'src', 'components');\n\n  // Try direct path first: pds-button -> pds-button/docs/pds-button.mdx\n  const directPath = path.join(componentsDir, componentTag, 'docs', `${componentTag}.mdx`);\n  if (fs.existsSync(directPath)) {\n    return directPath;\n  }\n\n  // Try nested component path: pds-table-cell -> pds-table/pds-table-cell/docs/pds-table-cell.mdx\n  // Search recursively for the docs folder\n  const searchForMdx = (dir: string): string | null => {\n    if (!fs.existsSync(dir)) return null;\n\n    const entries = fs.readdirSync(dir, { withFileTypes: true });\n    for (const entry of entries) {\n      if (entry.isDirectory()) {\n        if (entry.name === componentTag) {\n          const mdxPath = path.join(dir, entry.name, 'docs', `${componentTag}.mdx`);\n          if (fs.existsSync(mdxPath)) {\n            return mdxPath;\n          }\n        }\n        // Recurse into subdirectories\n        const found = searchForMdx(path.join(dir, entry.name));\n        if (found !== null) return found;\n      }\n    }\n    return null;\n  };\n\n  return searchForMdx(componentsDir);\n}\n\n/**\n * Parse MDX content and extract h3 headings under the ## Examples section.\n * Returns an array of example names (e.g., [\"Primary\", \"Secondary\", \"Tertiary\"]).\n */\nfunction parseMdxExamples(mdxContent: string): string[] {\n  const lines = mdxContent.split('\\n');\n  const examples: string[] = [];\n\n  let inExamplesSection = false;\n\n  for (const line of lines) {\n    const trimmedLine = line.trim();\n\n    // Look for ## Examples heading\n    if (trimmedLine.toLowerCase() === '## examples') {\n      inExamplesSection = true;\n      continue;\n    }\n\n    // Stop at the next h2 heading (but not h3/h4)\n    if (inExamplesSection && trimmedLine.startsWith('## ') && trimmedLine.toLowerCase() !== '## examples') {\n      break;\n    }\n\n    // Collect h3 headings within the Examples section\n    if (inExamplesSection && trimmedLine.startsWith('### ')) {\n      const heading = trimmedLine.replace(/^### /, '').trim();\n      examples.push(heading);\n    }\n  }\n\n  return examples;\n}\n\n/**\n * Parse MDX content and extract the first paragraph after the component name header.\n * This provides a concise description for VS Code hover tooltips.\n */\nfunction parseMdxToMarkdown(mdxContent: string): string {\n  const lines = mdxContent.split('\\n');\n\n  let foundHeader = false;\n  const paragraphLines: string[] = [];\n\n  for (const line of lines) {\n    const trimmedLine = line.trim();\n\n    // Skip import statements and JSX at the top\n    if (trimmedLine.startsWith('import ') || trimmedLine.startsWith('<Meta')) {\n      continue;\n    }\n\n    // Look for the main component header (# ComponentName)\n    if (!foundHeader && trimmedLine.startsWith('# ')) {\n      foundHeader = true;\n      continue;\n    }\n\n    // Once we've found the header, collect the first paragraph\n    if (foundHeader) {\n      // Skip empty lines before the paragraph starts\n      if (paragraphLines.length === 0 && trimmedLine === '') {\n        continue;\n      }\n\n      // Stop at the next heading, empty line after paragraph, or JSX\n      if (trimmedLine.startsWith('#') || trimmedLine.startsWith('<') || (paragraphLines.length > 0 && trimmedLine === '')) {\n        break;\n      }\n\n      paragraphLines.push(trimmedLine);\n    }\n  }\n\n  return paragraphLines.join(' ').trim();\n}\n\n/**\n * Get parsed MDX data for a component (with caching).\n * Reads and parses the MDX file once, extracting both docs and examples.\n */\nfunction getMdxData(componentTag: string): MdxParsedData {\n  if (!mdxCache) {\n    mdxCache = new Map();\n  }\n\n  const cached = mdxCache.get(componentTag);\n  if (cached) {\n    return cached;\n  }\n\n  const emptyData: MdxParsedData = { docs: '', examples: [] };\n\n  const mdxPath = findMdxFile(componentTag);\n  if (!mdxPath) {\n    mdxCache.set(componentTag, emptyData);\n    return emptyData;\n  }\n\n  try {\n    const mdxContent = fs.readFileSync(mdxPath, 'utf-8');\n    const data: MdxParsedData = {\n      docs: parseMdxToMarkdown(mdxContent),\n      examples: parseMdxExamples(mdxContent),\n    };\n    mdxCache.set(componentTag, data);\n    return data;\n  } catch {\n    mdxCache.set(componentTag, emptyData);\n    return emptyData;\n  }\n}\n\n/**\n * Recursively find all story files in a directory\n */\nfunction findStoryFiles(dir: string): string[] {\n  const results: string[] = [];\n\n  if (!fs.existsSync(dir)) {\n    return results;\n  }\n\n  const entries = fs.readdirSync(dir, { withFileTypes: true });\n\n  for (const entry of entries) {\n    const fullPath = path.join(dir, entry.name);\n\n    if (entry.isDirectory()) {\n      results.push(...findStoryFiles(fullPath));\n    } else if (entry.isFile() && entry.name.endsWith('.stories.js')) {\n      results.push(fullPath);\n    }\n  }\n\n  return results;\n}\n\n/**\n * Build cache mapping component tags to their Storybook titles\n * by reading story files\n */\nfunction buildStoryTitleCache(): void {\n  if (storyTitleCache) {\n    return;\n  }\n\n  storyTitleCache = new Map();\n  const componentsDir = path.resolve(__dirname, '..', 'src', 'components');\n  const storyFiles = findStoryFiles(componentsDir);\n\n  for (const storyFile of storyFiles) {\n    try {\n      const content = fs.readFileSync(storyFile, 'utf-8');\n\n      // Extract component tag from the story file\n      const componentMatch = content.match(/component:\\s*['\"]([^'\"]+)['\"]/);\n      // Extract title from the story file\n      const titleMatch = content.match(/title:\\s*['\"]([^'\"]+)['\"]/);\n\n      if (componentMatch && titleMatch) {\n        storyTitleCache.set(componentMatch[1], titleMatch[1]);\n      }\n    } catch {\n      // Skip files that can't be read\n    }\n  }\n}\n\n/**\n * Get the Storybook title for a component\n */\nfunction getStoryTitle(tag: string): string | undefined {\n  buildStoryTitleCache();\n  return storyTitleCache?.get(tag);\n}\n\n/**\n * Convert a Storybook title to a URL path segment\n * e.g., \"components/Table\" -> \"components-table\"\n * e.g., \"components/Copy Text\" -> \"components-copy-text\"\n * e.g., \"components/Radio Group/Radio\" -> \"components-radio-group-radio\"\n */\nfunction titleToUrlPath(title: string): string {\n  return title\n    .toLowerCase()\n    .replace(/\\s+/g, '-') // spaces to dashes\n    .replace(/\\//g, '-'); // slashes to dashes\n}\n\n/**\n * Get the Storybook documentation URL for a component\n */\nfunction getComponentDocsUrl(tag: string): string {\n  const title = getStoryTitle(tag);\n\n  if (title !== undefined) {\n    // Generate proper Storybook docs URL\n    const urlPath = titleToUrlPath(title);\n    return `${DOCS_BASE_URL}/?path=/docs/${urlPath}--docs`;\n  }\n\n  // Fallback for components without a story file\n  // Convert pds-button -> components-button\n  const componentName = tag.replace(/^pds-/, '');\n  return `${DOCS_BASE_URL}/?path=/docs/components-${componentName}--docs`;\n}\n\n/**\n * Convert an MDX heading to a URL anchor fragment\n * e.g., \"Primary\" -> \"primary\", \"Icon Only\" -> \"icon-only\", \"Full Width\" -> \"full-width\"\n */\nfunction headingToAnchor(heading: string): string {\n  return heading.toLowerCase().replace(/\\s+/g, '-'); // spaces to dashes\n}\n\n/**\n * Get a URL to a specific example section in the docs (using anchor)\n */\nfunction getExampleUrl(tag: string, exampleHeading: string): string {\n  const docsUrl = getComponentDocsUrl(tag);\n  const anchor = headingToAnchor(exampleHeading);\n  return `${docsUrl}#${anchor}`;\n}\n\nfunction formatPropDescription(prop: JsonDocsProp): string {\n  const parts: string[] = [];\n\n  // Main description\n  if (prop.docs) {\n    parts.push(prop.docs);\n  }\n\n  // Type info (skip common primitive types)\n  if (prop.type && prop.type !== 'string' && prop.type !== 'boolean') {\n    parts.push(`\\n\\n**Type:** \\`${prop.type}\\``);\n  }\n\n  // Default value\n  const defaultTag = prop.docsTags?.find((t) => t.name === 'default');\n  const defaultValue = defaultTag?.text || prop.default;\n  if (defaultValue) {\n    parts.push(`\\n\\n**Default:** \\`${defaultValue}\\``);\n  }\n\n  // Deprecation warning\n  const deprecatedTag = prop.docsTags?.find((t) => t.name === 'deprecated');\n  if (deprecatedTag) {\n    parts.push(`\\n\\n⚠️ **Deprecated:** ${deprecatedTag.text || 'This property is deprecated.'}`);\n  }\n\n  return parts.join('');\n}\n\nfunction formatComponentDescription(component: JsonDocsComponent): string {\n  const parts: string[] = [];\n  const mdxData = getMdxData(component.tag);\n\n  // Try to get rich MDX documentation first, fallback to JSDoc description\n  if (mdxData.docs) {\n    parts.push(mdxData.docs);\n  } else if (component.docs) {\n    parts.push(component.docs);\n  }\n\n  // Add Examples section with links to MDX example headings\n  if (mdxData.examples.length > 0) {\n    const exampleLinks = mdxData.examples.map((heading) => {\n      const url = getExampleUrl(component.tag, heading);\n      return `[${heading}](${url})`;\n    });\n    parts.push(`\\n\\n**Examples:**\\n${exampleLinks.join(', ')}`);\n  }\n\n  // Slots\n  if (component.slots && component.slots.length > 0) {\n    parts.push('\\n\\n**Slots:**');\n    for (const slot of component.slots) {\n      const slotName = slot.name === '' || slot.name === '(default)' ? '(default)' : slot.name;\n      parts.push(`\\n- \\`${slotName}\\` - ${slot.docs || 'No description'}`);\n    }\n  }\n\n  // CSS Parts\n  if (component.parts && component.parts.length > 0) {\n    parts.push('\\n\\n**CSS Parts:**');\n    for (const part of component.parts) {\n      parts.push(`\\n- \\`${part.name}\\` - ${part.docs || 'No description'}`);\n    }\n  }\n\n  // Events\n  if (component.events && component.events.length > 0) {\n    parts.push('\\n\\n**Events:**');\n    for (const event of component.events) {\n      parts.push(`\\n- \\`${event.event}\\` - ${event.docs || 'No description'}`);\n    }\n  }\n\n  return parts.join('');\n}\n\nfunction extractEnumValues(prop: JsonDocsProp): VSCodeAttributeValue[] | undefined {\n  // Check if prop.values has string literal values\n  if (prop.values === undefined || prop.values.length === 0) {\n    return undefined;\n  }\n\n  const enumValues = prop.values.filter((v) => v.type === 'string' && v.value);\n\n  if (enumValues.length === 0) {\n    return undefined;\n  }\n\n  return enumValues.map((v) => ({\n    name: v.value!,\n    description: undefined, // Could be enhanced with JSDoc @value tags if we add them\n  }));\n}\n\nfunction convertPropToAttribute(prop: JsonDocsProp): VSCodeAttribute | null {\n  // Skip props that don't have an HTML attribute equivalent\n  if (prop.attr === undefined || prop.attr === '') {\n    return null;\n  }\n\n  const attribute: VSCodeAttribute = {\n    name: prop.attr,\n    description: {\n      kind: 'markdown',\n      value: formatPropDescription(prop),\n    },\n  };\n\n  // Add enum values if applicable\n  const enumValues = extractEnumValues(prop);\n  if (enumValues) {\n    attribute.values = enumValues;\n  }\n\n  return attribute;\n}\n\nfunction convertComponent(component: JsonDocsComponent): VSCodeTag | null {\n  // Skip test/mock components\n  if (component.tag.startsWith('mock-') || component.filePath.includes('/test/')) {\n    return null;\n  }\n\n  const tag: VSCodeTag = {\n    name: component.tag,\n    description: {\n      kind: 'markdown',\n      value: formatComponentDescription(component),\n    },\n    attributes: [],\n    references: [\n      {\n        name: 'Documentation',\n        url: getComponentDocsUrl(component.tag),\n      },\n    ],\n  };\n\n  // Convert props to attributes\n  if (component.props !== undefined && component.props.length > 0) {\n    for (const prop of component.props) {\n      const attr = convertPropToAttribute(prop);\n      if (attr) {\n        tag.attributes.push(attr);\n      }\n    }\n  }\n\n  return tag;\n}\n\nexport function generateVSCodeCustomData(docs: JsonDocs, outputPath: string): void {\n  // Reset caches for fresh generation\n  storyTitleCache = null;\n  mdxCache = null;\n\n  const customData: VSCodeCustomData = {\n    version: 1.1,\n    tags: [],\n  };\n\n  for (const component of docs.components) {\n    const tag = convertComponent(component);\n    if (tag) {\n      customData.tags.push(tag);\n    }\n  }\n\n  // Sort tags alphabetically\n  customData.tags.sort((a, b) => a.name.localeCompare(b.name));\n\n  const outputDir = path.dirname(outputPath);\n  if (!fs.existsSync(outputDir)) {\n    fs.mkdirSync(outputDir, { recursive: true });\n  }\n\n  const newContent = JSON.stringify(customData, null, 2);\n\n  // Only write if content has changed (prevents watch loop)\n  let existingContent = '';\n  try {\n    existingContent = fs.readFileSync(outputPath, 'utf-8');\n  } catch {\n    // File doesn't exist yet, that's fine\n  }\n\n  if (newContent !== existingContent) {\n    fs.writeFileSync(outputPath, newContent);\n    console.log(`✅ Generated VS Code custom data: ${outputPath}`);\n    console.log(`   ${customData.tags.length} components documented`);\n  } else {\n    console.log(`ℹ️  VS Code custom data unchanged: ${outputPath}`);\n  }\n}\n\n// For use as a Stencil docs-custom generator\nexport default function vscodeCustomDataOutputTarget(outputPath: string = 'vscode.html-data.json') {\n  return {\n    type: 'docs-custom' as const,\n    generator: (docs: JsonDocs) => {\n      generateVSCodeCustomData(docs, outputPath);\n    },\n  };\n}\n"]}

package/dist/scripts/vscode-settings-patcher.cjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+
+/**
+ * VSCode Settings Patcher for Pine Design System
+ *
+ * This script automatically configures VSCode to use Pine's HTML custom data
+ * for web component autocomplete. It runs as a postinstall hook.
+ *
+ * Features:
+ * - Detects monorepo vs external package context
+ * - Creates .vscode directory if needed
+ * - Backs up existing settings.json before modifying
+ * - Merges html.customData without duplicates
+ * - Fails gracefully (won't break npm install)
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function patchVSCodeSettings() {
+  try {
+    // Find project root (where npm install was run)
+    // When running as postinstall, process.cwd() is the consuming project's root
+    // But when run from node_modules, we need to traverse up
+    let projectRoot = process.cwd();
+
+    // If we're inside node_modules, traverse up to find project root
+    if (projectRoot.includes('node_modules')) {
+      projectRoot = projectRoot.split('node_modules')[0].replace(/[/\\]$/, '');
+    }
+
+    // Detect context: monorepo vs external package
+    const isMonorepo = fs.existsSync(path.join(projectRoot, 'libs/core/package.json'));
+
+    // Determine the correct path to the HTML custom data file
+    const customDataPath = isMonorepo
+      ? './libs/core/dist/vscode.html-data.json'
+      : './node_modules/@pine-ds/core/dist/vscode.html-data.json';
+
+    const vscodeDir = path.join(projectRoot, '.vscode');
+    const settingsPath = path.join(vscodeDir, 'settings.json');
+    const backupPath = path.join(vscodeDir, 'settings.json.backup');
+
+    // Create .vscode directory if it doesn't exist
+    if (!fs.existsSync(vscodeDir)) {
+      fs.mkdirSync(vscodeDir, { recursive: true });
+      console.log('[pine-ds] Created .vscode directory');
+    }
+
+    // Read existing settings or start fresh
+    let settings = {};
+    let existingContent = null;
+    if (fs.existsSync(settingsPath)) {
+      existingContent = fs.readFileSync(settingsPath, 'utf8');
+      try {
+        settings = JSON.parse(existingContent);
+      } catch (e) {
+        console.warn('[pine-ds] Warning: Could not parse existing settings.json, starting fresh');
+        settings = {};
+      }
+    }
+
+    // Check if we need to add the custom data path
+    const existingCustomData = settings['html.customData'] || [];
+    if (!existingCustomData.includes(customDataPath)) {
+      // Backup only if we're about to make changes
+      if (existingContent !== null) {
+        fs.writeFileSync(backupPath, existingContent);
+        console.log(`[pine-ds] Backed up existing settings to ${path.relative(projectRoot, backupPath)}`);
+      }
+
+      // Merge html.customData
+      settings['html.customData'] = [...existingCustomData, customDataPath];
+
+      // Write updated settings
+      fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+      console.log(`[pine-ds] VSCode settings updated with Pine HTML custom data: ${customDataPath}`);
+      console.log('[pine-ds] Restart VSCode for autocomplete to take effect');
+    } else {
+      console.log('[pine-ds] Pine HTML custom data already configured in VSCode settings');
+    }
+  } catch (error) {
+    // Don't fail the install if VSCode setup fails
+    console.warn('[pine-ds] Warning: Could not set up VSCode HTML custom data:', error.message);
+    console.warn('[pine-ds] You can manually add html.customData to your .vscode/settings.json');
+  }
+}
+
+patchVSCodeSettings();

package/dist/types/components/pds-popover/pds-popover.d.ts

@@ -108,7 +108,7 @@ export declare class PdsPopover {
     private clearDebounceTimers;
     private createPortal;
     /**
-     * Adds Pine design system focus styles to the portal element
+     * Adds Pine design system focus styles and dark mode border to the portal element
      * Uses CSS variables from Pine's design tokens
      */
     private addPortalFocusStyles;

package/dist/types/components/pds-radio-group/pds-radio-group.d.ts

@@ -0,0 +1,72 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import { RadioGroupChangeEventDetail } from './radio-group-interface';
+/**
+ * @slot (default) - Child pds-radio components
+ */
+export declare class PdsRadioGroup {
+    el: HTMLPdsRadioGroupElement;
+    /**
+     * A unique identifier used for the underlying component `id` attribute.
+     */
+    componentId: string;
+    /**
+     * Stable group ID generated once during component initialization.
+     * Used to maintain DOM stability and accessibility relationships across re-renders.
+     */
+    private _groupId;
+    /**
+     * Layout direction for the radio group.
+     * @defaultValue column
+     */
+    direction: 'row' | 'column';
+    /**
+     * Displays error message text describing an invalid state for the entire group.
+     */
+    errorMessage: string;
+    /**
+     * Displays helper message text below the radio group.
+     */
+    helperMessage: string;
+    /**
+     * Spacing between radio items. Accepts t-shirt sizes (none, xxs, xs, sm, md, lg, xl, xxl) or core spacing tokens (025, 050, 100, etc.).
+     * @defaultValue xs
+     */
+    gap: string;
+    /**
+     * Determines whether or not the radio group is disabled.
+     * @defaultValue false
+     */
+    disabled: boolean;
+    /**
+     * Determines whether or not the radio group is invalid.
+     * @defaultValue false
+     */
+    invalid: boolean;
+    /**
+     * String used for group label/heading.
+     */
+    groupLabel: string;
+    /**
+     * String used for radio `name` attribute. Applied to all child radios.
+     * Required for proper radio group behavior (mutual exclusivity and form submission).
+     */
+    name: string;
+    /**
+     * Determines whether or not the radio group is required.
+     * @defaultValue false
+     */
+    required: boolean;
+    /**
+     * Emits when a radio in the group is selected, providing the selected value and component ID.
+     */
+    pdsRadioGroupChange: EventEmitter<RadioGroupChangeEventDetail>;
+    handlePropsChange(): void;
+    handleRadioChange(event: Event): void;
+    private updateChildRadios;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    private classNames;
+    private getGapValue;
+    private getAriaDescribedBy;
+    render(): any;
+}

package/dist/types/components/pds-radio-group/radio-group-interface.d.ts

@@ -0,0 +1,5 @@
+export interface RadioGroupChangeEventDetail {
+    checked: boolean;
+    value?: string;
+    componentId?: string;
+}