feat: run stc from integrations

packages/build-tools/src/load-stylable-config.ts

@@ -1,6 +1,9 @@
 import findConfig from 'find-config';
 
-export function loadStylableConfig<T>(context: string, extract: (config: any) => T): T | undefined {
+export function loadStylableConfig<T>(
+    context: string,
+    extract: (config: any) => T
+): { path: string; config: T } | undefined {
     const path = findConfig('stylable.config.js', { cwd: context });
     let config;
     if (path) {
@@ -16,7 +19,10 @@ export function loadStylableConfig<T>(context: string, extract: (config: any) =>
                 `Stylable configuration loaded from ${path} but no exported configuration found`
             );
         }
-        return extract(config);
+        return {
+            path,
+            config: extract(config),
+        };
     }
     return undefined;
 }

packages/cli/README.md

@@ -41,6 +41,7 @@ After installing `@stylable/cli`, the `stc` command will be available, running `
 | `--dts`                   |        | output definition files for the stylable source files (`.st.css.d.ts`)                 | `false`          |
 | `--dtsSourceMap`          |        | output source-maps for the definitions of stylable source files (`.st.css.d.ts.map`)   | `true` if `--dts` is true, otherwise `false` |
 | `--watch`                 |  `w`   | enable watch mode                                                                      | `false`          |
+| `--config`                 |  `c`   | The path to a config file specifying how to build and output Stylable stylesheets                                                                      | The directory containing the config file is assumed to be the "rootDir" for the project named "stylable.config.js"         |
 | `--useNamespaceReference` | `unsr` | mark output stylable source files with relative path for namespacing purposes (\*)     | `false`          |
 | `--customGenerator`       |        | path of a custom index file generator                                                  | -                |
 | `--ext`                   |        | extension of stylable css files                                                        | `.st.css`        |

packages/cli/src/build-single-file.ts

@@ -282,13 +282,14 @@ export function getAllDiagnostics(res: StylableResults): Diagnostic[] {
         ? res.meta.diagnostics.reports.concat(res.meta.transformDiagnostics.reports)
         : res.meta.diagnostics.reports;
 
-    return diagnostics.map((diagnostic) => {
-        const err = diagnostic.node.error(diagnostic.message, diagnostic.options);
-
-        return {
-            type: diagnostic.type,
-            message: `${diagnostic.message}\n${err.showSourceCode(true)}`,
-            offset: diagnostic.node.source?.start?.offset,
+    return diagnostics.map(({ message, node, options, type }) => {
+        const err = node.error(message, options);
+        const diagnostic: Diagnostic = {
+            type,
+            message: `${message}\n${err.showSourceCode(true)}`,
+            ...(node.source?.start && {}),
         };
+
+        return diagnostic;
     });
 }

packages/cli/src/build-stylable.ts

@@ -21,6 +21,8 @@ export interface BuildStylableContext
     outputFiles?: Map<string, Set<string>>;
     defaultOptions?: BuildOptions;
     overrideBuildOptions?: Partial<BuildOptions>;
+    configFilePath?: string;
+    watchMode?: boolean;
 }
 
 export async function buildStylable(
@@ -30,23 +32,32 @@ export async function buildStylable(
         overrideBuildOptions = {},
         fs: fileSystem = fs,
         log = createDefaultLogger(),
-        watch = false,
+        watch: runWatch = false,
+        watchMode: watch = runWatch,
         resolverCache = new Map(),
         fileProcessorCache = {},
         diagnosticsManager = new DiagnosticsManager({
             log,
-            onFatalDiagnostics() {
-                if (!watch) {
-                    process.exitCode = 1;
-                }
+            hooks: {
+                postReport(_diagnostics, hasFatalDiagnostic) {
+                    if (hasFatalDiagnostic && !watch) {
+                        process.exitCode = 1;
+                    }
+                },
             },
         }),
         outputFiles = new Map(),
         requireModule = require,
         resolveNamespace = requireModule(NAMESPACE_RESOLVER_MODULE_REQUEST).resolveNamespace,
+        configFilePath,
     }: BuildStylableContext = {}
 ) {
-    const projects = await projectsConfig(rootDir, overrideBuildOptions, defaultOptions);
+    const projects = await projectsConfig(
+        rootDir,
+        overrideBuildOptions,
+        defaultOptions,
+        configFilePath
+    );
     const watchHandler = new WatchHandler(fileSystem, {
         log,
         resolverCache,
@@ -77,7 +88,7 @@ export async function buildStylable(
                 fileProcessorCache,
             });
 
-            const { service } = await build(buildOptions, {
+            const { service, generatedFiles } = await build(buildOptions, {
                 watch,
                 stylable,
                 log,
@@ -89,15 +100,15 @@ export async function buildStylable(
                 diagnosticsManager,
             });
 
-            watchHandler.register({ service, identifier, stylable });
+            watchHandler.register({ service, identifier, stylable, generatedFiles });
         }
     }
 
     diagnosticsManager.report();
 
-    if (watch) {
+    if (runWatch) {
         watchHandler.start();
     }
 
-    return { watchHandler };
+    return { watchHandler, outputFiles, projects, diagnosticsManager };
 }

packages/cli/src/build.ts

@@ -202,7 +202,7 @@ export async function build(
         log(mode, buildMessages.BUILD_SKIPPED(isMultiPackagesProject ? identifier : undefined));
     }
 
-    return { service };
+    return { service, generatedFiles: buildGeneratedFiles };
 
     function buildFiles(filesToBuild: Set<string>, generated: Set<string>) {
         for (const filePath of filesToBuild) {

packages/cli/src/cli.ts

@@ -13,6 +13,7 @@ async function main() {
         log: shouldLog,
         namespaceResolver,
         preserveWatchOutput,
+        config,
     } = argv;
     const { resolveNamespace } = require(namespaceResolver);
     const rootDir = resolve(argv.rootDir);
@@ -44,6 +45,7 @@ async function main() {
         resolveNamespace,
         watch,
         log,
+        configFilePath: config,
     });
 
     process.on('SIGTERM', () => {

packages/cli/src/config/projects-config.ts

@@ -8,7 +8,7 @@ import type {
     RawProjectEntity,
     ResolveProjectsContext,
     ResolveRequests,
-    STCConfig,
+    STCProjects,
 } from '../types';
 import { processProjects } from './process-projects';
 import { createDefaultOptions, mergeBuildOptions, validateOptions } from './resolve-options';
@@ -17,28 +17,30 @@ import { resolveNpmRequests } from './resolve-requests';
 export async function projectsConfig(
     rootDir: string,
     overrideBuildOptions: Partial<BuildOptions>,
-    defaultOptions: BuildOptions = createDefaultOptions()
-): Promise<STCConfig> {
-    const configFile = resolveConfigFile(rootDir);
+    defaultOptions: BuildOptions = createDefaultOptions(),
+    configFilePath?: string
+): Promise<STCProjects> {
+    const { config } = resolveConfig(rootDir, configFilePath) || {};
+
     const topLevelOptions = mergeBuildOptions(
         defaultOptions,
-        configFile?.options,
+        config?.options,
         overrideBuildOptions
     );
 
     validateOptions(topLevelOptions);
 
-    let projects: STCConfig;
+    let projects: STCProjects;
 
-    if (isMultipleConfigProject(configFile)) {
-        const { entities } = processProjects(configFile, {
+    if (isMultipleConfigProject(config)) {
+        const { entities } = processProjects(config, {
             defaultOptions: topLevelOptions,
         });
 
         projects = await resolveProjectsRequests({
             rootDir,
             entities,
-            resolveRequests: configFile.projectsOptions?.resolveRequests ?? resolveNpmRequests,
+            resolveRequests: config.projectsOptions?.resolveRequests ?? resolveNpmRequests,
         });
     } else {
         projects = [
@@ -52,17 +54,29 @@ export async function projectsConfig(
     return projects;
 }
 
-export function resolveConfigFile(context: string) {
-    return loadStylableConfig(context, (config) =>
-        tryRun(
-            () =>
-                isSTCConfig(config)
-                    ? typeof config.stcConfig === 'function'
-                        ? config.stcConfig()
-                        : config.stcConfig
-                    : undefined,
-            'Failed to evaluate "stcConfig"'
-        )
+export function resolveConfig(context: string, request?: string) {
+    return request ? requireConfigFile(request, context) : resolveConfigFile(context);
+}
+
+function requireConfigFile(request: string, context: string) {
+    const path = require.resolve(request, { paths: [context] });
+    const config = resolveConfigValue(require(path));
+    return config ? { config, path } : undefined;
+}
+
+function resolveConfigFile(context: string) {
+    return loadStylableConfig(context, (config) => resolveConfigValue(config));
+}
+
+function resolveConfigValue(config: any) {
+    return tryRun(
+        () =>
+            isSTCConfig(config)
+                ? typeof config.stcConfig === 'function'
+                    ? config.stcConfig()
+                    : config.stcConfig
+                : undefined,
+        'Failed to evaluate "stcConfig"'
     );
 }
 
@@ -86,7 +100,7 @@ async function resolveProjectsRequests({
     rootDir: string;
     entities: Array<RawProjectEntity>;
     resolveRequests: ResolveRequests;
-}): Promise<STCConfig> {
+}): Promise<STCProjects> {
     const context: ResolveProjectsContext = { rootDir };
 
     return resolveRequests(entities, context);

packages/cli/src/config/resolve-options.ts

@@ -142,6 +142,14 @@ export function getCliArguments(): Arguments<CliArguments> {
             defaultDescription: defaults.diagnosticsMode,
             choices: ['strict', 'loose'],
         })
+        .option('config', {
+            alias: 'c',
+            type: 'string',
+            description:
+                'The path to a config file specifying how to build and output Stylable stylesheets',
+            defaultDescription:
+                'The directory containing the config file is assumed to be the "rootDir" for the project named "stylable.config.js"',
+        })
         .option('watch', {
             alias: 'w',
             type: 'boolean',

packages/cli/src/diagnostics-manager.ts

@@ -12,7 +12,10 @@ type DiagnosticsStore = Map<string, Map<string, ProcessDiagnostics>>;
 
 interface DiagnosticsManagerOptions {
     log?: Log;
-    onFatalDiagnostics?: () => void;
+    hooks?: {
+        preReport?(diagnosticsMessages: DiagnosticMessages): void;
+        postReport?(diagnosticsMessages: DiagnosticMessages, hasFatalDiagnostic: boolean): void;
+    };
 }
 
 export class DiagnosticsManager {
@@ -94,16 +97,16 @@ export class DiagnosticsManager {
             }
         }
 
+        this.options.hooks?.preReport?.(diagnosticMessages);
+
         if (diagnosticMessages.size) {
             const hasFatalDiangostics = reportDiagnostics(
                 this.log,
                 diagnosticMessages,
                 diagnosticMode
             );
 
-            if (hasFatalDiangostics) {
-                this.options.onFatalDiagnostics?.();
-            }
+            this.options.hooks?.postReport?.(diagnosticMessages, hasFatalDiangostics);
         }
 
         return Boolean(diagnosticMessages.size);

packages/cli/src/index.ts

@@ -10,13 +10,18 @@ export {
     BuildOptions,
     Configuration,
     ConfigurationProvider,
-    STCConfig,
+    STCProjects,
     ResolveRequests,
     typedConfiguration,
 } from './types';
+export { resolveConfig } from './config/projects-config';
+export type { WatchHandler } from './watch-handler';
+export { DiagnosticsManager } from './diagnostics-manager';
 export {
     DirectoryProcessService,
     DirectoryProcessServiceOptions,
+    createWatchEvent,
 } from './directory-process-service/directory-process-service';
+export { STCBuilder } from './stc-builder';
 export { BuildStylableContext, buildStylable } from './build-stylable';
 export type { CodeMod } from './code-mods/types';

packages/cli/src/report-diagnostics.ts

@@ -4,6 +4,8 @@ import { levels, Log } from './logger';
 export interface Diagnostic {
     message: string;
     type: DiagnosticType;
+    line?: number;
+    column?: number;
     offset?: number;
 }