vite-plugin-symfony/src/types.d.ts

A Vite plugin to integrate easily Vite in your Symfony application

import "rollup";
import { Plugin, ResolvedConfig } from "vite";

declare module "rollup" {
  export interface RenderedChunk {
    viteMetadata?: ChunkMetadata;
  }
}

export type ResolvedConfigWithOrderablePlugins = Omit<ResolvedConfig, "plugins"> & {
  plugins: Plugin[];
};

export interface ChunkMetadata {
  importedAssets: Set<string>;
  importedCss: Set<string>;
}

export type FileMetadatas = {
  hash: string | null;
};

export type EntryPointsFile = {
  base: string;
  entryPoints: EntryPoints;
  legacy: boolean;
  metadatas: FilesMetadatas;
  version: [string, number, number, number];
  viteServer: string | null;
};

export type FilesMetadatas = {
  [k: string]: FileMetadatas;
};

export type EntryPoint =
  | {
      js?: string[];
    }
  | {
      css?: string[];
    }
  | BuildEntryPoint;

export type BuildEntryPoint = {
  js: string[];
  css: string[];
  preload: string[];
  dynamic: string[];
  legacy: boolean | string;
};

export type EntryPoints = {
  [k: string]: EntryPoint;
};

export type StringMapping = {
  [k: string]: string;
};

export type ParsedInputs = {
  [k: string]: ParsedEntry;
};

export type ParsedEntry = {
  inputType: "js" | "css";
  inputRelPath: string;
};

export type EntryFilesMapping = {
  [k: string]: string;
};

export type ManifestEntry = {
  file: string;
  src?: string;
  isDynamicEntry?: boolean;
  isEntry?: boolean;
  imports?: string[];
  css?: string[];
};

export type ManifestFile = {
  [k: string]: ManifestEntry;
};

export type FileInfos = JsFileInfos | CSSFileInfos | AssetFileInfos;

export type JsFileInfos = {
  type: "js";
  outputRelPath: string;
  inputRelPath: string | null;
  hash: string | null;

  imports: string[];

  assets: string[];
  js: string[];
  preload: string[];
  dynamic: string[];

  css: string[];
};
export type CSSFileInfos = {
  type: "css";
  outputRelPath: string;
  inputRelPath: string | null;
  hash: string | null;

  css: string[];
};
export type AssetFileInfos = {
  type: "asset";
  outputRelPath: string;
  inputRelPath: string | null;
  hash: string | null;
};

export type GeneratedFiles = {
  [inputRelPath: string]: FileInfos;
};

export type DevServerUrl = `${"http" | "https"}://${string}:${number}`;

export type HashAlgorithm = false | "sha256" | "sha384" | "sha512";

export type VitePluginSymfonyOptions = VitePluginSymfonyEntrypointsOptions & {
  /**
   * enable controllers.json loader for Symfony UX.
   * @default false
   */
  stimulus: false | VitePluginSymfonyStimulusOptions;
};

export type VitePluginSymfonyPartialOptions = Omit<Partial<VitePluginSymfonyOptions>, "stimulus"> & {
  stimulus?: boolean | string | Partial<VitePluginSymfonyStimulusOptions>;
};

export type VitePluginSymfonyEntrypointsOptions = {
  /**
   * By default vite-plugin-symfony set vite option publicDir to false.
   * Because we don't want symfony entrypoint (index.php) and other files to
   * be copied into the build directory.
   * Related to this issue : https://github.com/lhapaipai/vite-bundle/issues/17
   *
   * Vite plugin Symfony use sirv to serve public directory.
   *
   * If you want to force vite option publicDir to true, set servePublic to false.
   *
   * @default 'public'
   */
  servePublic: false | string;

  /**
   * Refresh vite dev server when your twig templates are updated.
   *  - array of paths to files to be watched, or glob patterns
   *  - true : equivalent to ["templates/**\/*.twig"]
   * @default false
   *
   * for additional glob documentation, check out low-level library picomatch : https://github.com/micromatch/picomatch
   */
  refresh: boolean | string[];

  /**
   * If you specify vite `server.host` option to '0.0.0.0' (usage with Docker)
   * You probably need to configure your `viteDevServerHostname` to 'localhost'.
   * Related to this issue : https://github.com/lhapaipai/vite-bundle/issues/26
   *
   * @default null
   */
  viteDevServerHostname: null | string;

  /**
   * Add an integrity attribute to your <script> <link> elements
   * @default false
   */
  sriAlgorithm: HashAlgorithm;

  /**
   * Show vite resolved config
   * @default false
   */
  debug: boolean;

  /**
   * Override the origin for every dev entrypoint.
   * Useful when you use a proxy server.
   * @default null
   */
  originOverride: null | string;

  /**
   * force the plugin to run at the end of the list of all plugins
   * necessary if you want to add integrity attributes in your scripts
   * @default true
   */
  enforcePluginOrderingPosition: boolean;

  /**
   * force the vite dev server to reassign his `server.origin` Vite config after vite dev server is listening.
   * relating to https://github.com/vitejs/vite/issues/12597
   * with this option activated we no longer need to pass Vite asset requests through the symfony proxy
   * @default true
   */
  enforceServerOriginAfterListening: boolean;

  /**
   * For security reasons only variables prefixed with `VITE_` from your .env files are exposed.
   * In some cases you will want to be able to access other variables. Just add them here.
   * @default ["APP_ENV"]
   */
  exposedEnvVars: string[];
};

export type VitePluginSymfonyStimulusOptions = {
  /**
   * path to the deepest folder that contains all your stimulus controllers
   * relative to vite root
   * @default "./assets/controllers"
   */
  controllersDir: string;

  /**
   * path to controllers.json relative to vite root
   * @default "./assets/controller.json"
   */
  controllersFilePath: string;

  /**
   * enable hmr for controllers
   * @default true
   */
  hmr: boolean;

  /**
   * default fetch mode when importing Stimulus Controller
   * @default "eager"
   */
  fetchMode: "eager" | "lazy";

  /**
   * @default "snakeCase"
   * if you provide a function, it will be called with the path relative
   * to the project root directory as its first argument and it should return an
   * identifier for your controller
   */
  identifierResolutionMethod: "snakeCase" | "camelCase" | ((path: string) => string);
};