@openedx/paragon 23.7.0 → 23.9.0

package/bin/paragon-scripts.js

@@ -96,6 +96,11 @@ const COMMANDS = {
           Can be provided as a comma-separated list (e.g., "light,dark") or multiple arguments (e.g., "-t light -t dark").`,
         defaultValue: 'light',
       },
+      {
+        name: '--exclude-core',
+        description: 'Exclude core from the token build.',
+        defaultValue: false,
+      },
       {
         name: '-v, --verbose',
         description: 'Enable verbose logging.',
@@ -142,6 +147,11 @@ const COMMANDS = {
         description: 'Path to the theme\'s core SCSS file, defaults to Paragon\'s core.scss.',
         defaultValue: 'styles/scss/core/core.scss',
       },
+      {
+        name: '--excludeCore',
+        description: 'Exclude core from the SCSS build.',
+        defaultValue: false,
+      },
       {
         name: '--themesPath',
         description: `Path to the directory that contains themes' files. Expects directory to have following structure:

package/lib/__tests__/build-scss.test.js

@@ -143,4 +143,18 @@ describe('buildScssCommand', () => {
       expect.any(Object),
     );
   });
+
+  it('should exclude core properly', () => {
+    buildScssCommand(['--excludeCore']);
+
+    expect(sass.compile).not.toHaveBeenCalledWith(
+      expect.stringContaining('core.scss'),
+      expect.any(Object),
+    );
+
+    expect(fs.readdirSync).toHaveBeenCalledWith(
+      expect.stringContaining('themes'),
+      expect.objectContaining({ withFileTypes: true }),
+    );
+  });
 });

package/lib/__tests__/build-tokens.test.js

@@ -63,6 +63,25 @@ describe('buildTokensCommand', () => {
     }));
   });
 
+  it('should handle the exclude-core flag', async () => {
+    await buildTokensCommand(['--exclude-core']);
+
+    // only light theme, not core
+    expect(StyleDictionary).toHaveBeenCalledTimes(1);
+    const callArgs = StyleDictionary.mock.calls[0][0];
+    for (const file of callArgs.platforms.css.files) {
+      expect(file.destination).toContain('themes/light');
+    }
+
+    // Verify only light theme index files are created
+    expect(createIndexCssFile).toHaveBeenCalledTimes(1);
+    expect(createIndexCssFile).toHaveBeenCalledWith(expect.objectContaining({
+      buildDir: defaultBuildDir,
+      isThemeVariant: true,
+      themeVariant: 'light',
+    }));
+  });
+
   it('should use custom build path', async () => {
     const customBuildDir = './custom-build/';
     await buildTokensCommand(['--build-dir', customBuildDir]);

package/lib/build-scss.js

@@ -154,6 +154,7 @@ const compileAndWriteStyleSheets = ({
 function buildScssCommand(commandArgs) {
   const defaultArgs = {
     corePath: path.resolve(process.cwd(), 'styles/scss/core/core.scss'),
+    excludeCore: false,
     themesPath: path.resolve(process.cwd(), 'styles/css/themes'),
     outDir: './dist',
     defaultThemeVariants: 'light',
@@ -161,17 +162,20 @@ function buildScssCommand(commandArgs) {
 
   const {
     corePath,
+    excludeCore,
     themesPath,
     outDir,
     defaultThemeVariants,
-  } = minimist(commandArgs, { default: defaultArgs });
+  } = minimist(commandArgs, { default: defaultArgs, boolean: ['excludeCore'] });
 
   // Core CSS
-  compileAndWriteStyleSheets({
-    name: 'core',
-    stylesPath: corePath,
-    outDir,
-  });
+  if (!excludeCore) {
+    compileAndWriteStyleSheets({
+      name: 'core',
+      stylesPath: corePath,
+      outDir,
+    });
+  }
 
   // Theme Variants CSS
   fs.readdirSync(themesPath, { withFileTypes: true })

package/lib/build-tokens.js

@@ -22,6 +22,7 @@ async function buildTokensCommand(commandArgs) {
     'build-dir': './build/',
     'source-tokens-only': false,
     'output-references': true,
+    'exclude-core': false,
     verbose: false,
   };
 
@@ -38,12 +39,13 @@ async function buildTokensCommand(commandArgs) {
     'output-references': outputReferences,
     themes,
     verbose,
+    'exclude-core': excludeCore,
   } = minimist(
     commandArgs,
     {
       alias,
       default: defaultParams,
-      boolean: ['source-tokens-only', 'output-references', 'verbose'],
+      boolean: ['source-tokens-only', 'output-references', 'exclude-core', 'verbose'],
     },
   );
 
@@ -144,17 +146,19 @@ async function buildTokensCommand(commandArgs) {
     },
   });
 
-  // Create list of style-dictionary configurations to build (core + theme variants)
-  const configs = [
-    { config: coreConfig },
-    ...parsedThemes.map((themeVariant) => {
-      const config = getStyleDictionaryConfig(themeVariant);
-      return {
-        config,
-        themeVariant,
-      };
-    }),
-  ];
+  // Create list of style-dictionary configurations to build
+  const configs = [];
+
+  //  Add core if it isn't excluded
+  if (!excludeCore) {
+    configs.push({ config: coreConfig });
+  }
+
+  //  Add theme variants
+  for (const themeVariant of parsedThemes) {
+    const config = getStyleDictionaryConfig(themeVariant);
+    configs.push({ config, themeVariant });
+  }
 
   // Build tokens for each configuration
   await Promise.all(configs.map(async ({ config, themeVariant }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openedx/paragon",
-  "version": "23.7.0",
+  "version": "23.9.0",
   "description": "Accessible, responsive UI component library based on Bootstrap.",
   "main": "dist/index.js",
   "module": "dist/index.js",