ci: rework sassdoc build and bump theme and localization to 2.0.0 (#15943)

* ci: replace sassdoc gulp tasks with native node scripts

* ci(docs): refactor SassDoc build, update theme, and improve scripts

- Replace legacy SassDoc build logic in gulpfile.js with new
scripts/build-sassdoc.mjs
- Update all npm scripts to use build-sassdoc.mjs
- Upgrade igniteui-sassdoc-theme to ^2.0.0-beta.1 in dependencies and
lockfile
- Add scripts/logger.mjs for consistent logging
- Update GitHub Actions workflow to use unified build:docs script

* fix(sassdoc): windows build

* deps: bump sassdoc-plugin-localization and igniteui-sassdoc-theme to their

Author: simeonoff

.github/workflows/nodejs.yml

@@ -42,8 +42,7 @@ jobs:
         run: npm run build:migrations
       - name: Build TypeDoc & SassDoc
         run: |
-            npm run build:typedoc:en:production
-            npm run build:sassdoc:en:production
+            npm run build:docs
       - name: Test
         run: |
             npm run test:lib

.gitignore

@@ -48,7 +48,8 @@ src/**/*.js
 src/**/*.js.map
 src/**/*.css.map
 
-# Typedoc Theme
+# Typedoc and SassDoc Themes
+extras/sassdoc/**/*
 extras/docs/themes/typedoc/bin
 extras/docs/themes/sassdoc/node_modules
 extras/docs/themes/sassdoc/sassdoc/*

gulpfile.js

@@ -1,19 +1,11 @@
 'use strict';
 
-const del = require('del');
 const gulp = require('gulp');
 const process = require('process');
 const fs = require('fs');
-const argv = require('yargs').argv;
-const sassdoc = require('sassdoc');
 const path = require('path');
-const { series } = require('gulp');
-const slash = require('slash');
-
-const DOCS_OUTPUT_PATH = slash(path.join(__dirname, 'dist', 'igniteui-angular', 'docs'));
 
 module.exports.copyGitHooks = async (cb) => {
-
     if (process.env.AZURE_PIPELINES || process.env.TRAVIS || process.env.CI || !fs.existsSync('.git')) {
         return;
     }
@@ -88,93 +80,6 @@ module.exports.copySchematics = (cb) => {
 };
 
 
-function createDocsOutputDirFn(cb) {
-    !fs.existsSync(DOCS_OUTPUT_PATH) && fs.mkdirSync(DOCS_OUTPUT_PATH);
-    cb();
-}
-
-const SASSDOC = {
-    PROJECT_PATHS: [
-        `${path.join(__dirname, 'projects', 'igniteui-angular', 'src', 'lib', 'core', 'styles')}/**/*.scss`,
-        `${path.join(__dirname, 'node_modules', 'igniteui-theming', 'sass')}/**/*.scss`
-    ],
-    DEST: path.join(DOCS_OUTPUT_PATH, 'sass'),
-    OPTIONS: path.join(__dirname, '.sassdocrc'),
-};
-
-const sassdocCleanOutputDir = (cb) => {
-    del.sync(SASSDOC.DEST);
-    cb();
-}
-
-function sassdocBuildJson(cb) {
-    const options = JSON.parse(fs.readFileSync(SASSDOC.OPTIONS, 'utf8'));
-
-    const { convert, exportDir } = argv;
-
-    options.convert = convert;
-    options.exportDir = exportDir;
-
-    gulp.src(SASSDOC.PROJECT_PATHS)
-        .pipe(sassdoc(options));
-
-    cb();
-
-}
-
-function sassdocImportJson(cb) {
-    const options = JSON.parse(fs.readFileSync(SASSDOC.OPTIONS, 'utf8'));
-
-    const { render, importDir } = argv;
-
-    options.render = render;
-    options.json_dir = importDir;
-    options.shellStringsPath = path.join(__dirname, 'extras', 'template', 'strings', 'shell-strings.json');
-
-    gulp.src(SASSDOC.PROJECT_PATHS)
-        .pipe(sassdoc(options));
-
-    cb();
-}
-
-function sassdocBuildJA(cb) {
-    const pathTranslations = path.join(__dirname, 'i18nRepo', 'sassdoc', 'ja');
-    const options = JSON.parse(fs.readFileSync(SASSDOC.OPTIONS, 'utf8'));
-
-    options.lang = 'jp';
-    options.render = argv.render;
-    options.json_dir = pathTranslations;
-    options.shellStringsPath = path.join(__dirname, 'extras', 'template', 'strings', 'shell-strings.json');
-
-    gulp.src(SASSDOC.PROJECT_PATHS)
-        .pipe(sassdoc(options));
-
-    cb();
-}
-
-function sassdocBuildEN(cb) {
-    const options = JSON.parse(fs.readFileSync(SASSDOC.OPTIONS, 'utf8'));
-
-    options.lang = 'en';
-    options.shellStringsPath = path.join(__dirname, 'extras', 'template', 'strings', 'shell-strings.json');
-
-    gulp.src(SASSDOC.PROJECT_PATHS)
-        .pipe(sassdoc(options));
-
-    cb();
-}
-
-module.exports.createDocsOutputDir = createDocsOutputDirFn;
-
-/**
- * Sassdoc build tasks
- */
-module.exports.sassdocCleanOutputDir = sassdocCleanOutputDir;
-module.exports.sassdocImportJson = sassdocImportJson;
-module.exports.sassdocBuildJson = sassdocBuildJson;
-module.exports.sassdocBuildJA = series(sassdocCleanOutputDir, sassdocBuildJA);
-module.exports.sassdocBuildEN = series(sassdocCleanOutputDir, sassdocBuildEN);
-
 module.exports.copyPackageForElements = (cb) => {
     return gulp.src([
         path.join(__dirname, 'projects/igniteui-angular-elements/package.json')