@salty-css/core 0.1.0-alpha.5 → 0.1.0-alpha.7

package/astro-component-5hrNTCJ5.js

@@ -0,0 +1,4 @@
+const astroComponent = "---\nimport { <%- styledComponentName %> } from './<%- fileName %>.css';\n\ninterface Props {\n  text?: string;\n}\n\nconst { text = 'Lorem ipsum' } = Astro.props;\n---\n\n<<%- styledComponentName %>>\n  {text}\n</<%- styledComponentName %>>\n";
+export {
+  astroComponent as default
+};

package/astro-component-Dj3enX6K.cjs

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const astroComponent = "---\nimport { <%- styledComponentName %> } from './<%- fileName %>.css';\n\ninterface Props {\n  text?: string;\n}\n\nconst { text = 'Lorem ipsum' } = Astro.props;\n---\n\n<<%- styledComponentName %>>\n  {text}\n</<%- styledComponentName %>>\n";
+exports.default = astroComponent;

package/bin/commands/build.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const registerBuildCommand: (program: Command, defaultProject: string | undefined) => void;

package/bin/commands/generate.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const registerGenerateCommand: (program: Command, defaultProject: string | undefined) => void;

package/bin/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const registerInitCommand: (program: Command) => void;

package/bin/commands/update.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const registerUpdateCommand: (program: Command) => void;

package/bin/commands/version.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const registerVersionOption: (program: Command) => void;

package/bin/context.d.ts

@@ -0,0 +1,19 @@
+import { RCFile } from '../types/cli-types';
+import { PackageJson } from './package-json';
+export interface ProjectContext {
+    cwd: string;
+    projectDir: string;
+    relativeProjectPath: string;
+    packageJson?: PackageJson;
+    rcFile: RCFile;
+    cliVersion: string;
+    skipInstall: boolean;
+}
+export declare const resolveProjectDir: (dir: string, rootDir?: string) => string;
+export interface BuildContextOptions {
+    dir: string;
+    skipInstall?: boolean;
+    /** When false, build context even if package.json is missing (used by commands that should not require one). */
+    requirePackageJson?: boolean;
+}
+export declare const buildContext: (opts: BuildContextOptions) => Promise<ProjectContext>;

package/bin/detection/css-file.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Looks for a global CSS file inside `projectDir` and returns its path relative to it,
+ * or undefined when none is found.
+ */
+export declare const findGlobalCssFile: (projectDir: string) => Promise<string | undefined>;

package/bin/frameworks/astro.d.ts

@@ -0,0 +1,4 @@
+import { FrameworkAdapter } from './types';
+export declare const astroConfigFiles: readonly ["astro.config.mjs", "astro.config.ts", "astro.config.js", "astro.config.cjs"];
+export declare const findAstroConfig: (projectDir: string) => string | null;
+export declare const astroFramework: FrameworkAdapter;

package/bin/frameworks/index.d.ts

@@ -0,0 +1,13 @@
+import { ProjectContext } from '../context';
+import { FrameworkAdapter, FrameworkName } from './types';
+/**
+ * Adapters are evaluated in this order; the first whose `detect()` returns true wins.
+ * React is the final fallback, so its `detect()` always returns true.
+ */
+export declare const frameworkRegistry: FrameworkAdapter[];
+export declare const frameworksByName: Record<FrameworkName, FrameworkAdapter>;
+export declare const detectFramework: (ctx: ProjectContext) => Promise<FrameworkAdapter>;
+export declare const getFramework: (name: string | undefined) => FrameworkAdapter | undefined;
+export type { FrameworkAdapter, FrameworkName } from './types';
+export { reactFramework } from './react';
+export { astroFramework, findAstroConfig, astroConfigFiles } from './astro';

package/bin/frameworks/react.d.ts

@@ -0,0 +1,2 @@
+import { FrameworkAdapter } from './types';
+export declare const reactFramework: FrameworkAdapter;

package/bin/frameworks/types.d.ts

@@ -0,0 +1,27 @@
+import { ProjectContext } from '../context';
+import { TemplateKey } from '../templates';
+export type FrameworkName = 'react' | 'astro';
+export interface ComponentTemplates {
+    /** Template used for the styled-file when the wrapper component is requested. */
+    styled: TemplateKey;
+    /** Template used for the wrapper component file. */
+    wrapper: TemplateKey;
+    /** Extension for the wrapper component file (including dot), e.g. '.tsx' or '.astro'. */
+    wrapperExt: string;
+}
+export interface FrameworkAdapter {
+    name: FrameworkName;
+    /** The path to the framework's source files. */
+    srcDirectory: string;
+    /** True when this framework matches the project. Adapters are evaluated in registry order. */
+    detect(ctx: ProjectContext): Promise<boolean> | boolean;
+    /** The runtime npm spec to install for this framework, e.g. `@salty-css/react@1.2.3`. */
+    runtimePackage(version: string): string;
+    /** Templates used by the `generate` command. */
+    templates: {
+        /** Template used for a standalone styled-file (no wrapper). */
+        styled: TemplateKey;
+        /** Optional wrapper component templates. Omit if the framework does not support `--reactComponent`. */
+        component?: ComponentTemplates;
+    };
+}

package/bin/integrations/astro.d.ts

@@ -0,0 +1,11 @@
+import { BuildIntegrationAdapter, ConfigEdit } from './types';
+export declare const astroPackage: (version: string) => string;
+/**
+ * Returns the new content of an Astro config (with saltyIntegration wired in),
+ * or `{ content: null }` if the integration is already present or if no safe
+ * insertion point was found.
+ */
+export declare const editAstroConfig: (existing: string) => ConfigEdit & {
+    warning?: string;
+};
+export declare const astroIntegration: BuildIntegrationAdapter;

package/bin/integrations/eslint.d.ts

@@ -0,0 +1,6 @@
+import { BuildIntegrationAdapter, ConfigEdit } from './types';
+export declare const eslintConfigCandidates: (projectDir: string, rootDir: string) => string[];
+export declare const editEslintConfig: (existing: string, isJsFlat: boolean) => ConfigEdit & {
+    warning?: string;
+};
+export declare const eslintIntegration: BuildIntegrationAdapter;

package/bin/integrations/index.d.ts

@@ -0,0 +1,13 @@
+import { ProjectContext } from '../context';
+import { BuildIntegrationAdapter } from './types';
+export declare const buildIntegrationRegistry: BuildIntegrationAdapter[];
+export declare const detectAndApplyIntegrations: (ctx: ProjectContext) => Promise<{
+    name: string;
+    configPath: string;
+    changed: boolean;
+}[]>;
+export type { BuildIntegrationAdapter, ConfigEdit } from './types';
+export { viteIntegration, editViteConfig, vitePackage } from './vite';
+export { nextIntegration, editNextConfig, nextPackage, nextConfigFiles } from './next';
+export { astroIntegration, editAstroConfig, astroPackage } from './astro';
+export { eslintIntegration, editEslintConfig, eslintConfigCandidates } from './eslint';

package/bin/integrations/next.d.ts

@@ -0,0 +1,9 @@
+import { BuildIntegrationAdapter, ConfigEdit } from './types';
+export declare const nextConfigFiles: readonly ["next.config.js", "next.config.cjs", "next.config.ts", "next.config.mjs"];
+export declare const nextPackage: (version: string) => string;
+/**
+ * Returns the new content of a Next.js config (with withSaltyCss wired in),
+ * or `{ content: null }` if the plugin is already present.
+ */
+export declare const editNextConfig: (existing: string) => ConfigEdit;
+export declare const nextIntegration: BuildIntegrationAdapter;

package/bin/integrations/types.d.ts

@@ -0,0 +1,17 @@
+import { ProjectContext } from '../context';
+export interface IntegrationApplyResult {
+    /** Whether any file was edited or any install was performed. */
+    changed: boolean;
+}
+export interface BuildIntegrationAdapter {
+    name: string;
+    /** Returns the config file path this integration targets, or null when not applicable. */
+    detect(ctx: ProjectContext): Promise<string | null> | string | null;
+    /** Idempotently wire the integration into the project (edit configs, install dev deps). */
+    apply(ctx: ProjectContext, configPath: string): Promise<IntegrationApplyResult>;
+}
+/** Pure transform — returned by an integration when it knows how to rewrite a config file. */
+export interface ConfigEdit {
+    /** New content to write, or null when no edit is needed. */
+    content: string | null;
+}

package/bin/integrations/vite.d.ts

@@ -0,0 +1,8 @@
+import { BuildIntegrationAdapter, ConfigEdit } from './types';
+export declare const vitePackage: (version: string) => string;
+/**
+ * Returns the new content of a Vite config (with the salty plugin wired in),
+ * or `{ content: null }` if the plugin is already present.
+ */
+export declare const editViteConfig: (existing: string) => ConfigEdit;
+export declare const viteIntegration: BuildIntegrationAdapter;