@synergy-design-system/metadata 3.7.0 → 3.8.0

package/dist/public/index.d.ts

@@ -1,7 +1,9 @@
 export { clearMetadataStoreCache, createMetadataStore, getMetadataInfo } from './store.js';
+export { generateSkillBundle } from './skill-bundle.js';
+export type { SkillBundleOptions } from './skill-bundle.js';
 export { getAssetMetadata, listAssets, searchIcons } from './domains/assets.js';
 export { listComponentClusters, listComponentsByCluster } from './domains/clusters.js';
-export { getComponentMetadata, getDataForComponent, listComponents } from './domains/components.js';
+export { getComponentMetadata, getDataForComponent, getRulesForComponent, listComponents, } from './domains/components.js';
 export { getFontMetadata, listFonts } from './domains/fonts.js';
 export { getMigrations } from './domains/migrations.js';
 export { getDataForSetup } from './domains/setup.js';
@@ -11,11 +13,78 @@ export { getDataForTokens, getTokens } from './domains/tokens.js';
 export { collectLayerReferences, readLayerFilesForEntity } from './utils.js';
 export type { AssetQueryOptions, IconSearchOptions } from './domains/assets.js';
 export type { ClusterComponentQueryOptions, ClusterQueryOptions, } from './domains/clusters.js';
-export type { ComponentDataLayer, ComponentDataPayload, ComponentDataQueryOptions, ComponentFramework, ComponentFrameworkDetails, ComponentLayerContent, ComponentQueryOptions, ComponentTextLayerContent, } from './domains/components.js';
+export type { ComponentDataLayer, ComponentDataPayload, ComponentDataQueryOptions, ComponentFramework, ComponentFrameworkDetails, ComponentLayerContent, ComponentQueryOptions, ComponentRulesPayload, ComponentTextLayerContent, } from './domains/components.js';
 export type { FontQueryOptions } from './domains/fonts.js';
+export type { ComponentGuideQuery as ExperimentalComponentGuideQuery, ComponentGuideResult as ExperimentalComponentGuideResult, FindComponentsForTaskQuery as ExperimentalFindComponentsForTaskQuery, FindComponentsForTaskResult as ExperimentalFindComponentsForTaskResult, IntentOptionsQuery as ExperimentalIntentOptionsQuery, IntentOptionsResult as ExperimentalIntentOptionsResult, IntentCategoryQueryOptions as ExperimentalIntentCategoryQueryOptions, IntentListQueryOptions as ExperimentalIntentListQueryOptions, IntentPhaseQueryOptions as ExperimentalIntentPhaseQueryOptions, IntentRenderQuery as ExperimentalIntentRenderQuery, IntentResolutionQuery as ExperimentalIntentResolutionQuery, ValidateComponentQuery as ExperimentalValidateComponentQuery, ValidateComponentResult as ExperimentalValidateComponentResult, } from './domains/intent-policy.js';
 export type { MigrationQueryOptions } from './domains/migrations.js';
 export type { SetupDataPayload, SetupDataQueryOptions, SetupEntry, SetupPackage, SetupTextLayerContent, } from './domains/setup.js';
 export type { StyleDataLayer, StyleDataPayload, StyleDataQueryOptions, StyleQueryOptions, StyleTextLayerContent, } from './domains/styles.js';
 export type { TemplateDataLayer, TemplateDataPayload, TemplateDataQueryOptions, TemplateQueryOptions, TemplateTextLayerContent, } from './domains/templates.js';
 export type { TokenDataContent, TokenDataPayload, TokenDataQueryOptions, TokenFormat, TokenQueryOptions, TokenTheme, } from './domains/tokens.js';
-export type { AssetCustom, AssetEntity, AssetIconData, AssetIconSetCustom, AssetIconSetEntity, AssetLogoCustom, AssetLogoEntity, AssetSystemIconCustom, AssetSystemIconEntity, ComponentAngularCustom, ComponentCluster, ComponentCustom, ComponentEntity, ComponentInterfaceAttribute, ComponentInterfaceEvent, ComponentInterfaceMethod, ComponentInterfaceProperty, ComponentInterfaceSnapshot, ComponentNamedDescription, ComponentReactJsxCustom, ComponentReactWrapperCustom, ComponentVueCustom, FontCustom, FontEntity, IconFilterMode, IconSearchQuery, IconSearchResult, LayerName, MetadataEntity, MetadataIndex, MetadataIndexEntry, MetadataLayerRef, MetadataQuery, MetadataRelationRef, MetadataStore, MetadataStoreOptions, MigrationCustom, MigrationEntity, SetupCustom, SetupEntity, PublicError, PublicErrorCode, PublicRequestOptions, PublicResponse, PublicResponseMeta, StyleCustom, StyleEntity, TokenCustom, TokenEntity, Verbosity, } from './types.js';
+export type { AssetCustom, AssetEntity, AssetIconData, AssetIconSetCustom, AssetIconSetEntity, AssetLogoCustom, AssetLogoEntity, AssetSystemIconCustom, AssetSystemIconEntity, ComponentAngularCustom, ComponentCluster, ComponentCustom, ComponentEntity, ComponentInterfaceAttribute, ComponentInterfaceEvent, ComponentInterfaceMethod, ComponentInterfaceProperty, ComponentInterfaceSnapshot, ComponentNamedDescription, ComponentReactJsxCustom, ComponentReactWrapperCustom, ComponentVueCustom, FontCustom, FontEntity, FrameworkProfile, IconFilterMode, IconSearchQuery, IconSearchResult, LayerName, MetadataEntity, MetadataIndex, MetadataIndexEntry, MetadataLayerRef, MetadataQuery, MetadataRelationRef, MetadataStore, MetadataStoreOptions, MigrationCustom, MigrationEntity, IntentCapability, IntentCategory, IntentDefinition, IntentPhase, IntentPreset, IntentPresetValue, IntentResolutionResult, IntentTargetKind, IntentTargetRef, IntentStructureNode, IntentUsagePattern, SetupCustom, SetupEntity, PublicError, PublicErrorCode, PublicRequestOptions, PublicResponse, PublicResponseMeta, StyleCustom, StyleEntity, TokenCustom, TokenEntity, Verbosity, } from './types.js';
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+export declare const experimental_getIntentCategory: (categoryId: string, options?: import("./domains/intent-policy.js").IntentCategoryQueryOptions, storeOptions?: import("./types.js").MetadataStoreOptions) => Promise<import("./types.js").PublicResponse<import("./types.js").IntentCategory | null>>;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+export declare const experimental_getTargetCapabilities: (target: import("./types.js").IntentTargetRef, storeOptions?: import("./types.js").MetadataStoreOptions) => Promise<import("./types.js").PublicResponse<import("./types.js").IntentCapability | null>>;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+export declare const experimental_getComponentGuide: (query: import("./domains/intent-policy.js").ComponentGuideQuery, storeOptions?: import("./types.js").MetadataStoreOptions) => Promise<import("./types.js").PublicResponse<import("./domains/intent-policy.js").ComponentGuideResult | null>>;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+export declare const experimental_getIntentOptions: (query: import("./domains/intent-policy.js").IntentOptionsQuery, storeOptions?: import("./types.js").MetadataStoreOptions) => Promise<import("./types.js").PublicResponse<import("./domains/intent-policy.js").IntentOptionsResult | null>>;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+export declare const experimental_listIntentCategories: (storeOptions?: import("./types.js").MetadataStoreOptions, options?: import("./domains/intent-policy.js").IntentPhaseQueryOptions) => Promise<import("./types.js").PublicResponse<import("./types.js").IntentCategory[]>>;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+export declare const experimental_listIntentCapabilities: (intentId: string, options?: import("./domains/intent-policy.js").IntentListQueryOptions, storeOptions?: import("./types.js").MetadataStoreOptions) => Promise<import("./types.js").PublicResponse<import("./types.js").IntentCapability[]>>;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+export declare const experimental_listIntents: (options?: import("./domains/intent-policy.js").IntentListQueryOptions, storeOptions?: import("./types.js").MetadataStoreOptions) => Promise<import("./types.js").PublicResponse<import("./types.js").IntentDefinition[]>>;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+export declare const experimental_findComponentsForTask: (query: import("./domains/intent-policy.js").FindComponentsForTaskQuery, storeOptions?: import("./types.js").MetadataStoreOptions) => Promise<import("./types.js").PublicResponse<import("./domains/intent-policy.js").FindComponentsForTaskResult | null>>;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+export declare const experimental_renderIntent: (query: import("./domains/intent-policy.js").IntentRenderQuery, storeOptions?: import("./types.js").MetadataStoreOptions) => Promise<import("./types.js").PublicResponse<string | null>>;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+export declare const experimental_resolveIntent: (query: import("./domains/intent-policy.js").IntentResolutionQuery, storeOptions?: import("./types.js").MetadataStoreOptions) => Promise<import("./types.js").PublicResponse<import("./types.js").IntentResolutionResult | null>>;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+export declare const experimental_validateComponent: (query: import("./domains/intent-policy.js").ValidateComponentQuery, storeOptions?: import("./types.js").MetadataStoreOptions) => Promise<import("./types.js").PublicResponse<import("./domains/intent-policy.js").ValidateComponentResult | null>>;

package/dist/public/index.js

@@ -1,7 +1,9 @@
+import { findComponentsForTask as experimentalFindComponentsForTask, getComponentGuide as experimentalGetComponentGuide, getIntentCategory as experimentalGetIntentCategory, getIntentOptions as experimentalGetIntentOptions, getTargetCapabilities as experimentalGetTargetCapabilities, listIntentCapabilities as experimentalListIntentCapabilities, listIntentCategories as experimentalListIntentCategories, listIntents as experimentalListIntents, renderIntent as experimentalRenderIntent, resolveIntent as experimentalResolveIntent, validateComponent as experimentalValidateComponent, } from './domains/intent-policy.js';
 export { clearMetadataStoreCache, createMetadataStore, getMetadataInfo } from './store.js';
+export { generateSkillBundle } from './skill-bundle.js';
 export { getAssetMetadata, listAssets, searchIcons } from './domains/assets.js';
 export { listComponentClusters, listComponentsByCluster } from './domains/clusters.js';
-export { getComponentMetadata, getDataForComponent, listComponents } from './domains/components.js';
+export { getComponentMetadata, getDataForComponent, getRulesForComponent, listComponents, } from './domains/components.js';
 export { getFontMetadata, listFonts } from './domains/fonts.js';
 export { getMigrations } from './domains/migrations.js';
 export { getDataForSetup } from './domains/setup.js';
@@ -9,3 +11,80 @@ export { getDataForStyle, getStyleMetadata, listStyles } from './domains/styles.
 export { getTemplateMetadata, getDataForTemplate, listTemplates } from './domains/templates.js';
 export { getDataForTokens, getTokens } from './domains/tokens.js';
 export { collectLayerReferences, readLayerFilesForEntity } from './utils.js';
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+// eslint-disable-next-line camelcase
+export const experimental_getIntentCategory = experimentalGetIntentCategory;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+// eslint-disable-next-line camelcase
+export const experimental_getTargetCapabilities = experimentalGetTargetCapabilities;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+// eslint-disable-next-line camelcase
+export const experimental_getComponentGuide = experimentalGetComponentGuide;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+// eslint-disable-next-line camelcase
+export const experimental_getIntentOptions = experimentalGetIntentOptions;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+// eslint-disable-next-line camelcase
+export const experimental_listIntentCategories = experimentalListIntentCategories;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+// eslint-disable-next-line camelcase
+export const experimental_listIntentCapabilities = experimentalListIntentCapabilities;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+// eslint-disable-next-line camelcase
+export const experimental_listIntents = experimentalListIntents;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+// eslint-disable-next-line camelcase
+export const experimental_findComponentsForTask = experimentalFindComponentsForTask;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+// eslint-disable-next-line camelcase
+export const experimental_renderIntent = experimentalRenderIntent;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+// eslint-disable-next-line camelcase
+export const experimental_resolveIntent = experimentalResolveIntent;
+/**
+ * Experimental API export.
+ *
+ * @experimental
+ */
+// eslint-disable-next-line camelcase
+export const experimental_validateComponent = experimentalValidateComponent;

package/dist/public/skill-bundle.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Generate a self-contained Synergy component skill bundle.
+ *
+ * Copies component metadata from the layers (interface, rules, examples)
+ * into a portable skill folder that can be installed to .github/skills/
+ */
+export interface SkillBundleOptions {
+    outputPath: string;
+    dataDir?: string;
+}
+/**
+ * Generate a self-contained skill bundle at the specified path.
+ * Creates:
+ * - synergy-component/SKILL.md
+ * - synergy-component/components/{component-name}/{interface,rules,examples}.md
+ */
+export declare function generateSkillBundle(options: SkillBundleOptions): Promise<void>;

package/dist/public/skill-bundle.js

@@ -0,0 +1,259 @@
+/* eslint-disable no-console */
+/**
+ * Generate a self-contained Synergy component skill bundle.
+ *
+ * Copies component metadata from the layers (interface, rules, examples)
+ * into a portable skill folder that can be installed to .github/skills/
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { createMetadataStore } from './store.js';
+const COMPONENT_SKILL_BODY_MARKDOWN = `
+# Synergy Component Skill
+
+This skill provides offline, copyable documentation for Synergy Design System components.
+
+> All files in this skill are generated from Synergy metadata and must not be edited manually.
+
+## When to Use
+
+- You are developing with Synergy components locally
+- You want component guidance without running MCP
+- You need to share component knowledge with your team via \`.github/skills/\`
+
+## Structure
+
+Each component includes three facets:
+
+### \`interface.md\`
+The component's API reference: properties, attributes, slots, methods, events, and type information. Use this for understanding what a component can do technically.
+
+### \`rules.md\`
+Usage guidelines, accessibility considerations, common use cases, and best practices. Use this for understanding *when* and *how* to use a component correctly.
+
+> Rules are authoritative within the design system.
+> Best practices are recommendations, not enforceable constraints, and may require extension based on product, platform, or regulatory needs.
+
+### \`examples.md\`
+Code samples showing common patterns and variations. Use this for understanding typical usage patterns.
+
+## How to Use
+
+
+### Precedence
+
+> If there is any conflict between guidance in \`rules.md\` and examples shown in \`examples.md\`, always follow \`rules.md\`.
+
+### Order of operations:
+
+1. **Find a component**: Look in the \`components/\` folder for the component you need (e.g., \`syn-button/\`)
+2. **Start with \`rules.md\`**: Understand the component's purpose and usage guidelines
+3. **Reference \`interface.md\`**: Look up specific properties or attributes
+4. **Check \`examples.md\`**: See code samples for your use case
+
+## Installation
+
+Copy this folder to your project's Copilot skills directory:
+
+\`\`\`bash
+# Option 1: Manual copy
+cp -r synergy-component/ .github/skills/
+
+# Option 2: Using the CLI (if metadata is installed)
+npx @synergy-design-system/metadata install-skills --path .github/skills
+\`\`\`
+
+After installation, reference this skill with \`@synergy-component\` in Copilot chat for component guidance without leaving your editor.
+`.trim();
+const TEMPLATE_SKILL_BODY_MARKDOWN = `
+# Synergy Templates Skill
+
+This skill provides offline, copyable template examples for common layout and interaction patterns built with the Synergy Design System.
+
+> All files in this skill are generated from Synergy metadata and must not be edited manually.
+
+## Notes on Template Scope
+
+- Templates are illustrative starting points and are not production‑ready implementations.
+- They may omit edge cases, error handling, and accessibility refinements that must be addressed based on your product context and applicable standards.
+
+## When to Use
+
+- You are developing with Synergy templates locally
+- You want concrete HTML starting points for common UI or layout patterns without running MCP
+- You need to share template knowledge with your team via \`.github/skills/\`
+
+## Structure
+
+Templates are currently represented by a single file:
+
+### \`examples.md\`
+Code samples showing common layout and interaction patterns. Use this for understanding typical composition and setup patterns.
+
+For component API details and usage rules, use the \`synergy-component\` skill.
+
+## How to Use
+
+1. **Find a template**: Look in the \`templates/\` folder for the template you need (e.g., \`forms/\`)
+2. **Open \`examples.md\`**: Review the provided markdown and code snippets
+3. **Copy and adapt**: Use the snippet as a starting point and adapt it for your product context
+
+## Installation
+
+Copy this folder to your project's Copilot skills directory:
+
+\`\`\`bash
+# Option 1: Manual copy
+cp -r synergy-templates/ .github/skills/
+
+# Option 2: Using the CLI (if metadata is installed)
+npx @synergy-design-system/metadata install-skills --path .github/skills
+\`\`\`
+
+After installation, reference this skill with \`@synergy-templates\` in Copilot chat for template guidance without leaving your editor.
+
+If a suitable template is not available, consider composing a solution from individual components following the guidance in \`synergy-component\`.
+`.trim();
+function buildSkillRootMarkdown(name, description, metadata, body) {
+    return `
+---
+name: ${name}
+description: '${description}'
+metadata:
+  skill-version: "${metadata.version}"
+  source: "${metadata.source}"
+  generated-at: "${metadata.generatedAt}"
+  data-built-at: "${metadata.dataBuiltAt}"
+  schema-version: "${metadata.schemaVersion}"
+  skill-type: "${metadata.skillType}"
+  content-layer: "${metadata.contentLayer}"
+---
+
+${body}
+`.trim();
+}
+function readPackageVersion(packageJsonContent) {
+    const parsed = JSON.parse(packageJsonContent);
+    if (typeof parsed !== 'object'
+        || parsed === null
+        || !('version' in parsed)
+        || typeof parsed.version !== 'string') {
+        throw new Error('Invalid package.json: missing string "version" field');
+    }
+    return parsed.version;
+}
+/**
+ * Generate a self-contained skill bundle at the specified path.
+ * Creates:
+ * - synergy-component/SKILL.md
+ * - synergy-component/components/{component-name}/{interface,rules,examples}.md
+ */
+export async function generateSkillBundle(options) {
+    const { outputPath, dataDir } = options;
+    const packageJsonPath = new URL('../../package.json', import.meta.url);
+    const packageJsonContent = await readFile(packageJsonPath, 'utf-8');
+    const packageVersion = readPackageVersion(packageJsonContent);
+    const componentSkillPath = resolve(outputPath, 'synergy-component');
+    const componentPath = join(componentSkillPath, 'components');
+    const templateSkillPath = resolve(outputPath, 'synergy-templates');
+    const templatePath = join(templateSkillPath, 'templates');
+    // Ensure output directory exists
+    await mkdir(componentPath, { recursive: true });
+    await mkdir(templatePath, { recursive: true });
+    // Create metadata store to access component data
+    const store = createMetadataStore({ dataDir });
+    const index = await store.getIndex();
+    const generatedAt = new Date().toISOString();
+    // Write root SKILL.md
+    await writeFile(join(componentSkillPath, 'SKILL.md'), buildSkillRootMarkdown('synergy-component', 'Local Synergy Design System component reference without MCP. Use to understand component APIs, usage guidelines, examples, and best practices for your local development.', {
+        contentLayer: 'interface,rules,examples',
+        dataBuiltAt: index.builtAt,
+        generatedAt,
+        schemaVersion: index.version,
+        skillType: 'component-reference',
+        source: 'synergy-design-system',
+        version: packageVersion,
+    }, COMPONENT_SKILL_BODY_MARKDOWN), 'utf-8');
+    await writeFile(join(templateSkillPath, 'SKILL.md'), buildSkillRootMarkdown('synergy-templates', 'Local Synergy Design System template reference without MCP. Use to explore implementation examples for common layout and interaction patterns for local development.', {
+        contentLayer: 'examples',
+        dataBuiltAt: index.builtAt,
+        generatedAt,
+        schemaVersion: index.version,
+        skillType: 'template-reference',
+        source: 'synergy-design-system',
+        version: packageVersion,
+    }, TEMPLATE_SKILL_BODY_MARKDOWN), 'utf-8');
+    // Get all components from the components package
+    const components = await store.findEntities({ kind: 'component', package: 'components' });
+    // For each component, copy the layer files
+    for (const entity of components) {
+        const componentName = entity.id.replace('component:', '');
+        const componentFacetPath = join(componentPath, componentName);
+        await mkdir(componentFacetPath, { recursive: true });
+        // Copy interface layer (use only the markdown file, not the JSON file)
+        if (entity.layers?.interface) {
+            for (const layerRef of entity.layers.interface) {
+                if (!layerRef.path.endsWith('.md')) {
+                    continue;
+                }
+                try {
+                    const content = await store.readLayerFile(layerRef);
+                    await writeFile(join(componentFacetPath, 'interface.md'), content, 'utf-8');
+                    break; // Use only the first markdown interface file per component
+                }
+                catch (err) {
+                    // Log but continue
+                    console.warn(`Failed to copy interface for ${componentName}:`, err);
+                }
+            }
+        }
+        // Copy rules layer
+        if (entity.layers?.rules) {
+            for (const layerRef of entity.layers.rules) {
+                try {
+                    const content = await store.readLayerFile(layerRef);
+                    await writeFile(join(componentFacetPath, 'rules.md'), content, 'utf-8');
+                    break; // Use only the first rules file per component
+                }
+                catch (err) {
+                    // Log but continue
+                    console.warn(`Failed to copy rules for ${componentName}:`, err);
+                }
+            }
+        }
+        // Copy examples layer
+        if (entity.layers?.examples) {
+            for (const layerRef of entity.layers.examples) {
+                try {
+                    const content = await store.readLayerFile(layerRef);
+                    await writeFile(join(componentFacetPath, 'examples.md'), content, 'utf-8');
+                    break; // Use only the first examples file per component
+                }
+                catch (err) {
+                    // Log but continue
+                    console.warn(`Failed to copy examples for ${componentName}:`, err);
+                }
+            }
+        }
+    }
+    // Get all templates discovered by metadata build and copy their examples layer
+    const templates = await store.findEntities({ kind: 'template' });
+    for (const entity of templates) {
+        const templateName = entity.id.replace('template:', '');
+        const templateExamplePath = join(templatePath, templateName);
+        await mkdir(templateExamplePath, { recursive: true });
+        if (entity.layers?.examples) {
+            for (const layerRef of entity.layers.examples) {
+                try {
+                    const content = await store.readLayerFile(layerRef);
+                    await writeFile(join(templateExamplePath, 'examples.md'), content, 'utf-8');
+                    break; // Use only the first examples file per template
+                }
+                catch (err) {
+                    // Log but continue
+                    console.warn(`Failed to copy template example for ${templateName}:`, err);
+                }
+            }
+        }
+    }
+}

package/dist/public/types.d.ts

@@ -4,7 +4,7 @@
  */
 import type { ComponentRules } from '../config/types.js';
 /** Logical metadata layer names used for query and response shaping. */
-export type LayerName = 'full' | 'interface' | 'examples';
+export type LayerName = 'full' | 'interface' | 'examples' | 'rules';
 /** Verbosity levels for response formatting in public query helpers. */
 export type Verbosity = 'readable' | 'compact' | 'minified';
 /** Named documentation item with free-text description. */
@@ -52,6 +52,8 @@ export type ComponentInterfaceSnapshot = {
     dependencies: string[];
     documentation?: string;
     events: ComponentInterfaceEvent[];
+    figmaComponentId?: string;
+    figmaDocsId?: string;
     methods: ComponentInterfaceMethod[];
     properties: ComponentInterfaceProperty[];
     since: string;
@@ -110,7 +112,11 @@ export type ComponentCustom = {
         vue?: ComponentVueCustom;
     };
     interfaceSnapshot?: ComponentInterfaceSnapshot;
+    sourceModulePath?: string;
+    summary?: string;
     override?: {
+        figmaComponentId?: string;
+        figmaDocsId?: string;
         stories?: Array<{
             description?: {
                 type: string;
@@ -127,6 +133,8 @@ export type ComponentCustom = {
     };
     rules?: ComponentRules;
 };
+export type { IntentCapability, IntentCategory, IntentDefinition, IntentPhase, IntentPreset, IntentPresetValue, IntentResolutionResult, IntentTargetKind, IntentTargetRef, IntentStructureNode, IntentUsagePattern, } from '../intentPolicy/types.js';
+export type { FrameworkProfile, } from '../intentPolicy/intermediate-representation/types.js';
 /** Font artifact metadata. */
 export type FontCustom = {
     artifactPath?: string;
@@ -236,9 +244,11 @@ export type PublicResponse<T> = {
     meta: PublicResponseMeta;
 };
 /** Relation reference from one entity to another. */
+export type MetadataRelationType = 'dependsOn' | 'usedBy' | 'partOf' | 'relates';
+/** Relation reference from one entity to another. */
 export type MetadataRelationRef = {
     id: string;
-    kind: string;
+    type: MetadataRelationType;
 };
 /** Reference to one generated layer file. */
 export type MetadataLayerRef = {

package/package.json

@@ -3,6 +3,9 @@
     "name": "SICK Global UX Foundation",
     "url": "https://www.sick.com"
   },
+  "bin": {
+    "install-skills": "./dist/bin/install-skills.js"
+  },
   "description": "Metadata for the Synergy Design System, usable by MCP Servers or other AI tools",
   "devDependencies": {
     "@types/node": "^24.12.2",
@@ -19,12 +22,12 @@
     "serve-handler": "^6.1.7",
     "typescript": "^5.9.3",
     "zod": "^4.3.6",
-    "@synergy-design-system/components": "3.13.4",
+    "@synergy-design-system/components": "3.14.0",
     "@synergy-design-system/eslint-config-syn": "^0.1.0",
     "@synergy-design-system/docs": "0.1.0",
-    "@synergy-design-system/fonts": "1.0.6",
+    "@synergy-design-system/tokens": "^3.14.0",
     "@synergy-design-system/styles": "2.1.0",
-    "@synergy-design-system/tokens": "^3.13.4"
+    "@synergy-design-system/fonts": "1.0.6"
   },
   "exports": {
     ".": {
@@ -42,6 +45,8 @@
     "dist/index.d.ts",
     "dist/index.js",
     "dist/public/**",
+    "dist/intentPolicy/**",
+    "dist/bin/**",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -65,7 +70,7 @@
   },
   "types": "./dist/index.d.ts",
   "type": "module",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "scripts": {
     "build:all": "METADATA_LOG_LEVEL=info pnpm run build:ts && RUN_STORYBOOK_SCRAPER=true pnpm run build:data",
     "build": "METADATA_LOG_LEVEL=info pnpm run build:ts && pnpm run build:data",