@fragments-sdk/cli 0.7.4 → 0.7.5

package/LICENSE

@@ -1,10 +1,7 @@
 Functional Source License, Version 1.1, MIT Future License
 
 Licensor:  Conan McNicholl
-Software:  Fragments SDK (@fragments-sdk/cli, @fragments-sdk/mcp, @fragments-sdk/context)
-
-IMPORTANT: The @fragments-sdk/ui package is licensed separately under the MIT License.
-See libs/ui/LICENSE for details.
+Software:  @fragments-sdk/cli
 
 ---
 

package/dist/bin.js

@@ -8,15 +8,16 @@ import {
   runScreenshotCommand,
   validateAll,
   validateCoverage,
-  validateSchema
-} from "./chunk-S56I5FST.js";
+  validateSchema,
+  validateSnippets
+} from "./chunk-EFQ7SIBX.js";
 import {
   scan
-} from "./chunk-NEJ2FBTN.js";
+} from "./chunk-CR3XHBGM.js";
 import {
   loadConfig,
   loadFragmentFile
-} from "./chunk-R6IZZSE7.js";
+} from "./chunk-JZNATKQA.js";
 import {
   discoverFragmentFiles
 } from "./chunk-AWYCDRPG.js";
@@ -38,8 +39,8 @@ import {
 } from "./chunk-YMPGYEWK.js";
 import {
   generateContext
-} from "./chunk-UXLGIGSX.js";
-import "./chunk-P33AKQJW.js";
+} from "./chunk-GIC3I2KZ.js";
+import "./chunk-SFWZ4K7C.js";
 import {
   BRAND
 } from "./chunk-EKLMXTWU.js";
@@ -56,6 +57,7 @@ import { dirname as dirname4, join as join10 } from "path";
 import pc from "picocolors";
 async function validate(options = {}) {
   const { config, configDir } = await loadConfig(options.config);
+  const componentLimit = Number.isFinite(options.componentLimit) ? options.componentLimit : void 0;
   console.log(pc.cyan(`
 ${BRAND.name} Validator
 `));
@@ -66,9 +68,20 @@ ${BRAND.name} Validator
   } else if (options.coverage) {
     console.log(pc.dim("Running coverage validation...\n"));
     result = await validateCoverage(config, configDir);
+  } else if (options.snippets) {
+    console.log(pc.dim("Running snippet policy validation...\n"));
+    result = await validateSnippets(config, configDir, {
+      snippetMode: options.snippetMode,
+      componentStart: options.componentStart,
+      componentLimit
+    });
   } else {
     console.log(pc.dim("Running all validations...\n"));
-    result = await validateAll(config, configDir);
+    result = await validateAll(config, configDir, {
+      snippetMode: options.snippetMode,
+      componentStart: options.componentStart,
+      componentLimit
+    });
   }
   if (result.errors.length > 0) {
     console.log(pc.red(pc.bold("Errors:")));
@@ -1793,7 +1806,7 @@ ${BRAND.name} Dev Server
       }
     }
   }
-  const { createDevServer } = await import("./viewer-WXTDDQGK.js");
+  const { createDevServer } = await import("./viewer-IVP5XC7U.js");
   console.log(pc7.dim("\nStarting dev server..."));
   const parsedPort = typeof port === "string" ? parseInt(port, 10) : port;
   try {
@@ -3777,12 +3790,18 @@ export default defineFragment({
     {
       name: 'Default',
       description: 'Default ${name} appearance',
+      code: \`import { ${name} } from '@/components/${name}';
+
+<${name}>Example content</${name}>\`,
       render: () => <${name}>Example content</${name}>,
     },
     // TODO: Add more variants
     // {
     //   name: 'WithProps',
     //   description: '${name} with additional props',
+    //   code: \`import { ${name} } from '@/components/${name}';
+    //
+    // <${name} someProp="value">Content</${name}>\`,
     //   render: () => <${name} someProp="value">Content</${name}>,
     // },
   ],
@@ -5193,7 +5212,7 @@ var __dirname = dirname4(fileURLToPath(import.meta.url));
 var pkg = JSON.parse(readFileSync(join10(__dirname, "../package.json"), "utf-8"));
 var program = new Command();
 program.name(BRAND.cliCommand).description(`${BRAND.name} - Design system documentation and compliance tool`).version(pkg.version);
-program.command("validate").description("Validate fragment files").option("-c, --config <path>", "Path to config file").option("--schema", "Validate fragment schema only").option("--coverage", "Validate coverage only").action(async (options) => {
+program.command("validate").description("Validate fragment files").option("-c, --config <path>", "Path to config file").option("--schema", "Validate fragment schema only").option("--coverage", "Validate coverage only").option("--snippets", "Validate snippet/render policy only").option("--snippet-mode <mode>", "Override snippet policy mode (warn|error)").option("--component-start <name>", "Start component name for alphabetical snippet batch validation").option("--component-limit <n>", "Component count for alphabetical snippet batch validation", (value) => Number.parseInt(value, 10)).action(async (options) => {
   try {
     const result = await validate(options);
     if (!result.valid) {
@@ -5558,7 +5577,7 @@ Make sure the dev server is running: ${BRAND.cliCommand} dev`));
 });
 program.command("view").description(`Generate a static HTML viewer for ${BRAND.outFile}`).option("-i, --input <path>", `Path to ${BRAND.outFile}`, BRAND.outFile).option("-o, --output <path>", "Output HTML file path", BRAND.viewerHtmlFile).option("--open", "Open in browser after generation").action(async (options) => {
   try {
-    const { generateViewerFromJson } = await import("./static-viewer-VA2JXSCX.js");
+    const { generateViewerFromJson } = await import("./static-viewer-5N42MBDR.js");
     const fs2 = await import("fs/promises");
     const path = await import("path");
     const inputPath = path.resolve(process.cwd(), options.input);
@@ -5606,7 +5625,7 @@ program.command("add").argument("[name]", 'Component name (e.g., "Button", "Text
 });
 program.command("init").description("Initialize fragments in a project (interactive by default)").option("--force", "Overwrite existing config").option("-y, --yes", "Non-interactive mode - auto-detect and use defaults").action(async (options) => {
   try {
-    const { init } = await import("./init-VYVYMVHH.js");
+    const { init } = await import("./init-O3FCHEPN.js");
     const result = await init({
       projectRoot: process.cwd(),
       force: options.force,
@@ -5626,7 +5645,7 @@ program.command("init").description("Initialize fragments in a project (interact
 });
 program.command("tokens").description("Discover and list design tokens from CSS/SCSS files").option("-c, --config <path>", "Path to config file").option("--json", "Output as JSON").option("--categories", "Group tokens by category").option("--theme <theme>", "Filter by theme name").option("--category <category>", "Filter by category (color, spacing, typography, etc.)").option("--verbose", "Show all tokens (no truncation)").action(async (options) => {
   try {
-    const { tokens } = await import("./tokens-7JA5CPDL.js");
+    const { tokens } = await import("./tokens-6VJAHFIG.js");
     const result = await tokens({
       config: options.config,
       json: options.json,
@@ -5645,7 +5664,7 @@ program.command("tokens").description("Discover and list design tokens from CSS/
 });
 program.command("generate").description("Generate fragment files from component source code").argument("[component]", "Specific component name to generate (optional)").option("--force", "Overwrite existing fragment files").option("--pattern <glob>", "Pattern for component files", "src/components/**/*.tsx").action(async (component, options) => {
   try {
-    const { generate } = await import("./generate-23VLX7QN.js");
+    const { generate } = await import("./generate-C2DKFCFJ.js");
     const result = await generate({
       projectRoot: process.cwd(),
       component,
@@ -5672,7 +5691,7 @@ program.command("graph").description("Query the component relationship graph").a
 program.command("test").description("Run interaction tests for fragments with play functions").option("-c, --config <path>", "Path to config file").option("--component <name>", "Filter by component name").option("--tags <tags>", "Filter by tags (comma-separated)").option("--grep <pattern>", "Filter by variant name pattern").option("--exclude <pattern>", "Exclude tests matching pattern").option("--parallel <count>", "Number of parallel browser contexts", parseInt, 4).option("--timeout <ms>", "Timeout per test in milliseconds", parseInt, 3e4).option("--retries <count>", "Number of retries for failed tests", parseInt, 0).option("--bail", "Stop on first failure").option("--browser <name>", "Browser to use (chromium, firefox, webkit)", "chromium").option("--headed", "Run in headed mode (show browser)").option("--a11y", "Run accessibility checks with axe-core").option("--visual", "Capture screenshots for visual regression").option("--update-snapshots", "Update visual snapshots").option("--watch", "Watch mode - re-run on file changes").option("--reporters <names>", "Reporters to use (console, junit, json)", "console").option("-o, --output <dir>", "Output directory for results", "./test-results").option("--server-url <url>", "URL of running dev server (skips starting server)").option("-p, --port <port>", "Port for dev server", parseInt, 6006).option("--ci", "CI mode - non-interactive, exit with code 1 on failure").option("--list", "List available tests without running them").action(async (options) => {
   try {
     const { config, configDir } = await loadConfig(options.config);
-    const { runTestCommand, listTests } = await import("./test-VTD7R6G2.js");
+    const { runTestCommand, listTests } = await import("./test-OMMDWL2W.js");
     if (options.list) {
       await listTests(config, configDir, {
         component: options.component,