@donotdev/core 0.0.17 → 0.0.19

package/functions/index.d.ts

@@ -1,1452 +1,5 @@
+import { BuildOptions } from 'esbuild';
 import * as React from 'react';
-import { ReactNode } from 'react';
-
-type Platform$1 = 'browser' | 'node' | 'neutral'
-type Format = 'iife' | 'cjs' | 'esm'
-type Loader = 'base64' | 'binary' | 'copy' | 'css' | 'dataurl' | 'default' | 'empty' | 'file' | 'js' | 'json' | 'jsx' | 'local-css' | 'text' | 'ts' | 'tsx'
-type LogLevel = 'verbose' | 'debug' | 'info' | 'warning' | 'error' | 'silent'
-type Charset = 'ascii' | 'utf8'
-type Drop = 'console' | 'debugger'
-type AbsPaths = 'code' | 'log' | 'metafile'
-
-interface CommonOptions {
-  /** Documentation: https://esbuild.github.io/api/#sourcemap */
-  sourcemap?: boolean | 'linked' | 'inline' | 'external' | 'both'
-  /** Documentation: https://esbuild.github.io/api/#legal-comments */
-  legalComments?: 'none' | 'inline' | 'eof' | 'linked' | 'external'
-  /** Documentation: https://esbuild.github.io/api/#source-root */
-  sourceRoot?: string
-  /** Documentation: https://esbuild.github.io/api/#sources-content */
-  sourcesContent?: boolean
-
-  /** Documentation: https://esbuild.github.io/api/#format */
-  format?: Format
-  /** Documentation: https://esbuild.github.io/api/#global-name */
-  globalName?: string
-  /** Documentation: https://esbuild.github.io/api/#target */
-  target?: string | string[]
-  /** Documentation: https://esbuild.github.io/api/#supported */
-  supported?: Record<string, boolean>
-  /** Documentation: https://esbuild.github.io/api/#platform */
-  platform?: Platform$1
-
-  /** Documentation: https://esbuild.github.io/api/#mangle-props */
-  mangleProps?: RegExp
-  /** Documentation: https://esbuild.github.io/api/#mangle-props */
-  reserveProps?: RegExp
-  /** Documentation: https://esbuild.github.io/api/#mangle-props */
-  mangleQuoted?: boolean
-  /** Documentation: https://esbuild.github.io/api/#mangle-props */
-  mangleCache?: Record<string, string | false>
-  /** Documentation: https://esbuild.github.io/api/#drop */
-  drop?: Drop[]
-  /** Documentation: https://esbuild.github.io/api/#drop-labels */
-  dropLabels?: string[]
-  /** Documentation: https://esbuild.github.io/api/#minify */
-  minify?: boolean
-  /** Documentation: https://esbuild.github.io/api/#minify */
-  minifyWhitespace?: boolean
-  /** Documentation: https://esbuild.github.io/api/#minify */
-  minifyIdentifiers?: boolean
-  /** Documentation: https://esbuild.github.io/api/#minify */
-  minifySyntax?: boolean
-  /** Documentation: https://esbuild.github.io/api/#line-limit */
-  lineLimit?: number
-  /** Documentation: https://esbuild.github.io/api/#charset */
-  charset?: Charset
-  /** Documentation: https://esbuild.github.io/api/#tree-shaking */
-  treeShaking?: boolean
-  /** Documentation: https://esbuild.github.io/api/#ignore-annotations */
-  ignoreAnnotations?: boolean
-
-  /** Documentation: https://esbuild.github.io/api/#jsx */
-  jsx?: 'transform' | 'preserve' | 'automatic'
-  /** Documentation: https://esbuild.github.io/api/#jsx-factory */
-  jsxFactory?: string
-  /** Documentation: https://esbuild.github.io/api/#jsx-fragment */
-  jsxFragment?: string
-  /** Documentation: https://esbuild.github.io/api/#jsx-import-source */
-  jsxImportSource?: string
-  /** Documentation: https://esbuild.github.io/api/#jsx-development */
-  jsxDev?: boolean
-  /** Documentation: https://esbuild.github.io/api/#jsx-side-effects */
-  jsxSideEffects?: boolean
-
-  /** Documentation: https://esbuild.github.io/api/#define */
-  define?: { [key: string]: string }
-  /** Documentation: https://esbuild.github.io/api/#pure */
-  pure?: string[]
-  /** Documentation: https://esbuild.github.io/api/#keep-names */
-  keepNames?: boolean
-
-  /** Documentation: https://esbuild.github.io/api/#abs-paths */
-  absPaths?: AbsPaths[]
-  /** Documentation: https://esbuild.github.io/api/#color */
-  color?: boolean
-  /** Documentation: https://esbuild.github.io/api/#log-level */
-  logLevel?: LogLevel
-  /** Documentation: https://esbuild.github.io/api/#log-limit */
-  logLimit?: number
-  /** Documentation: https://esbuild.github.io/api/#log-override */
-  logOverride?: Record<string, LogLevel>
-
-  /** Documentation: https://esbuild.github.io/api/#tsconfig-raw */
-  tsconfigRaw?: string | TsconfigRaw
-}
-
-interface TsconfigRaw {
-  compilerOptions?: {
-    alwaysStrict?: boolean
-    baseUrl?: string
-    experimentalDecorators?: boolean
-    importsNotUsedAsValues?: 'remove' | 'preserve' | 'error'
-    jsx?: 'preserve' | 'react-native' | 'react' | 'react-jsx' | 'react-jsxdev'
-    jsxFactory?: string
-    jsxFragmentFactory?: string
-    jsxImportSource?: string
-    paths?: Record<string, string[]>
-    preserveValueImports?: boolean
-    strict?: boolean
-    target?: string
-    useDefineForClassFields?: boolean
-    verbatimModuleSyntax?: boolean
-  }
-}
-
-interface BuildOptions extends CommonOptions {
-  /** Documentation: https://esbuild.github.io/api/#bundle */
-  bundle?: boolean
-  /** Documentation: https://esbuild.github.io/api/#splitting */
-  splitting?: boolean
-  /** Documentation: https://esbuild.github.io/api/#preserve-symlinks */
-  preserveSymlinks?: boolean
-  /** Documentation: https://esbuild.github.io/api/#outfile */
-  outfile?: string
-  /** Documentation: https://esbuild.github.io/api/#metafile */
-  metafile?: boolean
-  /** Documentation: https://esbuild.github.io/api/#outdir */
-  outdir?: string
-  /** Documentation: https://esbuild.github.io/api/#outbase */
-  outbase?: string
-  /** Documentation: https://esbuild.github.io/api/#external */
-  external?: string[]
-  /** Documentation: https://esbuild.github.io/api/#packages */
-  packages?: 'bundle' | 'external'
-  /** Documentation: https://esbuild.github.io/api/#alias */
-  alias?: Record<string, string>
-  /** Documentation: https://esbuild.github.io/api/#loader */
-  loader?: { [ext: string]: Loader }
-  /** Documentation: https://esbuild.github.io/api/#resolve-extensions */
-  resolveExtensions?: string[]
-  /** Documentation: https://esbuild.github.io/api/#main-fields */
-  mainFields?: string[]
-  /** Documentation: https://esbuild.github.io/api/#conditions */
-  conditions?: string[]
-  /** Documentation: https://esbuild.github.io/api/#write */
-  write?: boolean
-  /** Documentation: https://esbuild.github.io/api/#allow-overwrite */
-  allowOverwrite?: boolean
-  /** Documentation: https://esbuild.github.io/api/#tsconfig */
-  tsconfig?: string
-  /** Documentation: https://esbuild.github.io/api/#out-extension */
-  outExtension?: { [ext: string]: string }
-  /** Documentation: https://esbuild.github.io/api/#public-path */
-  publicPath?: string
-  /** Documentation: https://esbuild.github.io/api/#entry-names */
-  entryNames?: string
-  /** Documentation: https://esbuild.github.io/api/#chunk-names */
-  chunkNames?: string
-  /** Documentation: https://esbuild.github.io/api/#asset-names */
-  assetNames?: string
-  /** Documentation: https://esbuild.github.io/api/#inject */
-  inject?: string[]
-  /** Documentation: https://esbuild.github.io/api/#banner */
-  banner?: { [type: string]: string }
-  /** Documentation: https://esbuild.github.io/api/#footer */
-  footer?: { [type: string]: string }
-  /** Documentation: https://esbuild.github.io/api/#entry-points */
-  entryPoints?: (string | { in: string, out: string })[] | Record<string, string>
-  /** Documentation: https://esbuild.github.io/api/#stdin */
-  stdin?: StdinOptions
-  /** Documentation: https://esbuild.github.io/plugins/ */
-  plugins?: Plugin[]
-  /** Documentation: https://esbuild.github.io/api/#working-directory */
-  absWorkingDir?: string
-  /** Documentation: https://esbuild.github.io/api/#node-paths */
-  nodePaths?: string[]; // The "NODE_PATH" variable from Node.js
-}
-
-interface StdinOptions {
-  contents: string | Uint8Array
-  resolveDir?: string
-  sourcefile?: string
-  loader?: Loader
-}
-
-interface Message {
-  id: string
-  pluginName: string
-  text: string
-  location: Location | null
-  notes: Note[]
-
-  /**
-   * Optional user-specified data that is passed through unmodified. You can
-   * use this to stash the original error, for example.
-   */
-  detail: any
-}
-
-interface Note {
-  text: string
-  location: Location | null
-}
-
-interface Location {
-  file: string
-  namespace: string
-  /** 1-based */
-  line: number
-  /** 0-based, in bytes */
-  column: number
-  /** in bytes */
-  length: number
-  lineText: string
-  suggestion: string
-}
-
-interface OutputFile {
-  path: string
-  contents: Uint8Array
-  hash: string
-  /** "contents" as text (changes automatically with "contents") */
-  readonly text: string
-}
-
-interface BuildResult<ProvidedOptions extends BuildOptions = BuildOptions> {
-  errors: Message[]
-  warnings: Message[]
-  /** Only when "write: false" */
-  outputFiles: OutputFile[] | (ProvidedOptions['write'] extends false ? never : undefined)
-  /** Only when "metafile: true" */
-  metafile: Metafile | (ProvidedOptions['metafile'] extends true ? never : undefined)
-  /** Only when "mangleCache" is present */
-  mangleCache: Record<string, string | false> | (ProvidedOptions['mangleCache'] extends Object ? never : undefined)
-}
-
-/** Documentation: https://esbuild.github.io/api/#serve-arguments */
-interface ServeOptions {
-  port?: number
-  host?: string
-  servedir?: string
-  keyfile?: string
-  certfile?: string
-  fallback?: string
-  cors?: CORSOptions
-  onRequest?: (args: ServeOnRequestArgs) => void
-}
-
-/** Documentation: https://esbuild.github.io/api/#cors */
-interface CORSOptions {
-  origin?: string | string[]
-}
-
-interface ServeOnRequestArgs {
-  remoteAddress: string
-  method: string
-  path: string
-  status: number
-  /** The time to generate the response, not to send it */
-  timeInMS: number
-}
-
-/** Documentation: https://esbuild.github.io/api/#serve-return-values */
-interface ServeResult {
-  port: number
-  hosts: string[]
-}
-
-interface TransformOptions extends CommonOptions {
-  /** Documentation: https://esbuild.github.io/api/#sourcefile */
-  sourcefile?: string
-  /** Documentation: https://esbuild.github.io/api/#loader */
-  loader?: Loader
-  /** Documentation: https://esbuild.github.io/api/#banner */
-  banner?: string
-  /** Documentation: https://esbuild.github.io/api/#footer */
-  footer?: string
-}
-
-interface TransformResult<ProvidedOptions extends TransformOptions = TransformOptions> {
-  code: string
-  map: string
-  warnings: Message[]
-  /** Only when "mangleCache" is present */
-  mangleCache: Record<string, string | false> | (ProvidedOptions['mangleCache'] extends Object ? never : undefined)
-  /** Only when "legalComments" is "external" */
-  legalComments: string | (ProvidedOptions['legalComments'] extends 'external' ? never : undefined)
-}
-
-interface Plugin {
-  name: string
-  setup: (build: PluginBuild) => (void | Promise<void>)
-}
-
-interface PluginBuild {
-  /** Documentation: https://esbuild.github.io/plugins/#build-options */
-  initialOptions: BuildOptions
-
-  /** Documentation: https://esbuild.github.io/plugins/#resolve */
-  resolve(path: string, options?: ResolveOptions): Promise<ResolveResult>
-
-  /** Documentation: https://esbuild.github.io/plugins/#on-start */
-  onStart(callback: () =>
-    (OnStartResult | null | void | Promise<OnStartResult | null | void>)): void
-
-  /** Documentation: https://esbuild.github.io/plugins/#on-end */
-  onEnd(callback: (result: BuildResult) =>
-    (OnEndResult | null | void | Promise<OnEndResult | null | void>)): void
-
-  /** Documentation: https://esbuild.github.io/plugins/#on-resolve */
-  onResolve(options: OnResolveOptions, callback: (args: OnResolveArgs) =>
-    (OnResolveResult | null | undefined | Promise<OnResolveResult | null | undefined>)): void
-
-  /** Documentation: https://esbuild.github.io/plugins/#on-load */
-  onLoad(options: OnLoadOptions, callback: (args: OnLoadArgs) =>
-    (OnLoadResult | null | undefined | Promise<OnLoadResult | null | undefined>)): void
-
-  /** Documentation: https://esbuild.github.io/plugins/#on-dispose */
-  onDispose(callback: () => void): void
-
-  // This is a full copy of the esbuild library in case you need it
-  esbuild: {
-    context: typeof context,
-    build: typeof build,
-    buildSync: typeof buildSync,
-    transform: typeof transform,
-    transformSync: typeof transformSync,
-    formatMessages: typeof formatMessages,
-    formatMessagesSync: typeof formatMessagesSync,
-    analyzeMetafile: typeof analyzeMetafile,
-    analyzeMetafileSync: typeof analyzeMetafileSync,
-    initialize: typeof initialize,
-    version: typeof version,
-  }
-}
-
-/** Documentation: https://esbuild.github.io/plugins/#resolve-options */
-interface ResolveOptions {
-  pluginName?: string
-  importer?: string
-  namespace?: string
-  resolveDir?: string
-  kind?: ImportKind
-  pluginData?: any
-  with?: Record<string, string>
-}
-
-/** Documentation: https://esbuild.github.io/plugins/#resolve-results */
-interface ResolveResult {
-  errors: Message[]
-  warnings: Message[]
-
-  path: string
-  external: boolean
-  sideEffects: boolean
-  namespace: string
-  suffix: string
-  pluginData: any
-}
-
-interface OnStartResult {
-  errors?: PartialMessage[]
-  warnings?: PartialMessage[]
-}
-
-interface OnEndResult {
-  errors?: PartialMessage[]
-  warnings?: PartialMessage[]
-}
-
-/** Documentation: https://esbuild.github.io/plugins/#on-resolve-options */
-interface OnResolveOptions {
-  filter: RegExp
-  namespace?: string
-}
-
-/** Documentation: https://esbuild.github.io/plugins/#on-resolve-arguments */
-interface OnResolveArgs {
-  path: string
-  importer: string
-  namespace: string
-  resolveDir: string
-  kind: ImportKind
-  pluginData: any
-  with: Record<string, string>
-}
-
-type ImportKind =
-  | 'entry-point'
-
-  // JS
-  | 'import-statement'
-  | 'require-call'
-  | 'dynamic-import'
-  | 'require-resolve'
-
-  // CSS
-  | 'import-rule'
-  | 'composes-from'
-  | 'url-token'
-
-/** Documentation: https://esbuild.github.io/plugins/#on-resolve-results */
-interface OnResolveResult {
-  pluginName?: string
-
-  errors?: PartialMessage[]
-  warnings?: PartialMessage[]
-
-  path?: string
-  external?: boolean
-  sideEffects?: boolean
-  namespace?: string
-  suffix?: string
-  pluginData?: any
-
-  watchFiles?: string[]
-  watchDirs?: string[]
-}
-
-/** Documentation: https://esbuild.github.io/plugins/#on-load-options */
-interface OnLoadOptions {
-  filter: RegExp
-  namespace?: string
-}
-
-/** Documentation: https://esbuild.github.io/plugins/#on-load-arguments */
-interface OnLoadArgs {
-  path: string
-  namespace: string
-  suffix: string
-  pluginData: any
-  with: Record<string, string>
-}
-
-/** Documentation: https://esbuild.github.io/plugins/#on-load-results */
-interface OnLoadResult {
-  pluginName?: string
-
-  errors?: PartialMessage[]
-  warnings?: PartialMessage[]
-
-  contents?: string | Uint8Array
-  resolveDir?: string
-  loader?: Loader
-  pluginData?: any
-
-  watchFiles?: string[]
-  watchDirs?: string[]
-}
-
-interface PartialMessage {
-  id?: string
-  pluginName?: string
-  text?: string
-  location?: Partial<Location> | null
-  notes?: PartialNote[]
-  detail?: any
-}
-
-interface PartialNote {
-  text?: string
-  location?: Partial<Location> | null
-}
-
-/** Documentation: https://esbuild.github.io/api/#metafile */
-interface Metafile {
-  inputs: {
-    [path: string]: {
-      bytes: number
-      imports: {
-        path: string
-        kind: ImportKind
-        external?: boolean
-        original?: string
-        with?: Record<string, string>
-      }[]
-      format?: 'cjs' | 'esm'
-      with?: Record<string, string>
-    }
-  }
-  outputs: {
-    [path: string]: {
-      bytes: number
-      inputs: {
-        [path: string]: {
-          bytesInOutput: number
-        }
-      }
-      imports: {
-        path: string
-        kind: ImportKind | 'file-loader'
-        external?: boolean
-      }[]
-      exports: string[]
-      entryPoint?: string
-      cssBundle?: string
-    }
-  }
-}
-
-interface FormatMessagesOptions {
-  kind: 'error' | 'warning'
-  color?: boolean
-  terminalWidth?: number
-}
-
-interface AnalyzeMetafileOptions {
-  color?: boolean
-  verbose?: boolean
-}
-
-/** Documentation: https://esbuild.github.io/api/#watch-arguments */
-interface WatchOptions {
-  delay?: number // In milliseconds
-}
-
-interface BuildContext<ProvidedOptions extends BuildOptions = BuildOptions> {
-  /** Documentation: https://esbuild.github.io/api/#rebuild */
-  rebuild(): Promise<BuildResult<ProvidedOptions>>
-
-  /** Documentation: https://esbuild.github.io/api/#watch */
-  watch(options?: WatchOptions): Promise<void>
-
-  /** Documentation: https://esbuild.github.io/api/#serve */
-  serve(options?: ServeOptions): Promise<ServeResult>
-
-  cancel(): Promise<void>
-  dispose(): Promise<void>
-}
-
-// This is a TypeScript type-level function which replaces any keys in "In"
-// that aren't in "Out" with "never". We use this to reject properties with
-// typos in object literals. See: https://stackoverflow.com/questions/49580725
-type SameShape<Out, In extends Out> = In & { [Key in Exclude<keyof In, keyof Out>]: never }
-
-/**
- * This function invokes the "esbuild" command-line tool for you. It returns a
- * promise that either resolves with a "BuildResult" object or rejects with a
- * "BuildFailure" object.
- *
- * - Works in node: yes
- * - Works in browser: yes
- *
- * Documentation: https://esbuild.github.io/api/#build
- */
-declare function build<T extends BuildOptions>(options: SameShape<BuildOptions, T>): Promise<BuildResult<T>>
-
-/**
- * This is the advanced long-running form of "build" that supports additional
- * features such as watch mode and a local development server.
- *
- * - Works in node: yes
- * - Works in browser: no
- *
- * Documentation: https://esbuild.github.io/api/#build
- */
-declare function context<T extends BuildOptions>(options: SameShape<BuildOptions, T>): Promise<BuildContext<T>>
-
-/**
- * This function transforms a single JavaScript file. It can be used to minify
- * JavaScript, convert TypeScript/JSX to JavaScript, or convert newer JavaScript
- * to older JavaScript. It returns a promise that is either resolved with a
- * "TransformResult" object or rejected with a "TransformFailure" object.
- *
- * - Works in node: yes
- * - Works in browser: yes
- *
- * Documentation: https://esbuild.github.io/api/#transform
- */
-declare function transform<T extends TransformOptions>(input: string | Uint8Array, options?: SameShape<TransformOptions, T>): Promise<TransformResult<T>>
-
-/**
- * Converts log messages to formatted message strings suitable for printing in
- * the terminal. This allows you to reuse the built-in behavior of esbuild's
- * log message formatter. This is a batch-oriented API for efficiency.
- *
- * - Works in node: yes
- * - Works in browser: yes
- */
-declare function formatMessages(messages: PartialMessage[], options: FormatMessagesOptions): Promise<string[]>
-
-/**
- * Pretty-prints an analysis of the metafile JSON to a string. This is just for
- * convenience to be able to match esbuild's pretty-printing exactly. If you want
- * to customize it, you can just inspect the data in the metafile yourself.
- *
- * - Works in node: yes
- * - Works in browser: yes
- *
- * Documentation: https://esbuild.github.io/api/#analyze
- */
-declare function analyzeMetafile(metafile: Metafile | string, options?: AnalyzeMetafileOptions): Promise<string>
-
-/**
- * A synchronous version of "build".
- *
- * - Works in node: yes
- * - Works in browser: no
- *
- * Documentation: https://esbuild.github.io/api/#build
- */
-declare function buildSync<T extends BuildOptions>(options: SameShape<BuildOptions, T>): BuildResult<T>
-
-/**
- * A synchronous version of "transform".
- *
- * - Works in node: yes
- * - Works in browser: no
- *
- * Documentation: https://esbuild.github.io/api/#transform
- */
-declare function transformSync<T extends TransformOptions>(input: string | Uint8Array, options?: SameShape<TransformOptions, T>): TransformResult<T>
-
-/**
- * A synchronous version of "formatMessages".
- *
- * - Works in node: yes
- * - Works in browser: no
- */
-declare function formatMessagesSync(messages: PartialMessage[], options: FormatMessagesOptions): string[]
-
-/**
- * A synchronous version of "analyzeMetafile".
- *
- * - Works in node: yes
- * - Works in browser: no
- *
- * Documentation: https://esbuild.github.io/api/#analyze
- */
-declare function analyzeMetafileSync(metafile: Metafile | string, options?: AnalyzeMetafileOptions): string
-
-/**
- * This configures the browser-based version of esbuild. It is necessary to
- * call this first and wait for the returned promise to be resolved before
- * making other API calls when using esbuild in the browser.
- *
- * - Works in node: yes
- * - Works in browser: yes ("options" is required)
- *
- * Documentation: https://esbuild.github.io/api/#browser
- */
-declare function initialize(options: InitializeOptions): Promise<void>
-
-interface InitializeOptions {
-  /**
-   * The URL of the "esbuild.wasm" file. This must be provided when running
-   * esbuild in the browser.
-   */
-  wasmURL?: string | URL
-
-  /**
-   * The result of calling "new WebAssembly.Module(buffer)" where "buffer"
-   * is a typed array or ArrayBuffer containing the binary code of the
-   * "esbuild.wasm" file.
-   *
-   * You can use this as an alternative to "wasmURL" for environments where it's
-   * not possible to download the WebAssembly module.
-   */
-  wasmModule?: WebAssembly.Module
-
-  /**
-   * By default esbuild runs the WebAssembly-based browser API in a web worker
-   * to avoid blocking the UI thread. This can be disabled by setting "worker"
-   * to false.
-   */
-  worker?: boolean
-}
-
-declare let version: string
-
-// Note: These declarations exist to avoid type errors when you omit "dom" from
-// "lib" in your "tsconfig.json" file. TypeScript confusingly declares the
-// global "WebAssembly" type in "lib.dom.d.ts" even though it has nothing to do
-// with the browser DOM and is present in many non-browser JavaScript runtimes
-// (e.g. node and deno). Declaring it here allows esbuild's API to be used in
-// these scenarios.
-//
-// There's an open issue about getting this problem corrected (although these
-// declarations will need to remain even if this is fixed for backward
-// compatibility with older TypeScript versions):
-//
-//   https://github.com/microsoft/TypeScript-DOM-lib-generator/issues/826
-//
-declare global {
-  namespace WebAssembly {
-    interface Module {
-    }
-  }
-  interface URL {
-  }
-}
-
-// packages/core/types/src/auth/constants.ts
-
-
-
-// =============================================================================
-// User Role Constants
-// =============================================================================
-
-/**
- * Standard user role names
- * Apps can override these by providing their own role constants
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare const USER_ROLES = {
-  GUEST: 'guest',
-  USER: 'user',
-  ADMIN: 'admin',
-  SUPER: 'super',
-} as const;
-
-/**
- * Type for user role names
- * Apps can extend this with their own custom roles
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-type UserRole = (typeof USER_ROLES)[keyof typeof USER_ROLES] | string;
-
-// =============================================================================
-// Subscription Tier Constants
-// =============================================================================
-
-/**
- * Standard subscription tier names
- * Apps can override these by providing their own tier constants
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-declare const SUBSCRIPTION_TIERS = {
-  FREE: 'free',
-  PRO: 'pro',
-  PREMIUM: 'premium',
-} as const;
-
-/**
- * Type for subscription tier names
- * Apps can extend this with their own custom tiers
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-type SubscriptionTier =
-  | (typeof SUBSCRIPTION_TIERS)[keyof typeof SUBSCRIPTION_TIERS]
-  | string;
-
-// packages/core/types/src/common/index.ts
-
-
-
-// =============================================================================
-// PLATFORM CONSTANTS
-// =============================================================================
-
-/**
- * Supported platform identifiers
- * @constant
- */
-declare const PLATFORMS = {
-  VITE: 'vite',
-  NEXTJS: 'nextjs',
-  UNKNOWN: 'unknown',
-} as const;
-
-/**
- * Platform type derived from PLATFORMS constant
- */
-type Platform = (typeof PLATFORMS)[keyof typeof PLATFORMS];
-
-// =============================================================================
-// ENVIRONMENT CONSTANTS
-// =============================================================================
-
-/**
- * Supported environment modes
- * @constant
- */
-declare const ENVIRONMENTS = {
-  DEVELOPMENT: 'development',
-  PRODUCTION: 'production',
-  TEST: 'test',
-} as const;
-
-/**
- * Environment mode type derived from ENVIRONMENTS constant
- */
-type EnvironmentMode = (typeof ENVIRONMENTS)[keyof typeof ENVIRONMENTS];
-
-// =============================================================================
-// CONTEXT CONSTANTS
-// =============================================================================
-
-/**
- * Supported execution contexts
- * @constant
- */
-declare const CONTEXTS = {
-  CLIENT: 'client',
-  SERVER: 'server',
-  BUILD: 'build',
-} as const;
-
-/**
- * Context type derived from CONTEXTS constant
- */
-type Context = (typeof CONTEXTS)[keyof typeof CONTEXTS];
-
-// =============================================================================
-// STORAGE CONSTANTS
-// =============================================================================
-
-/**
- * Supported storage backend types
- * @constant
- */
-declare const STORAGE_TYPES = {
-  LOCAL: 'localStorage',
-  SESSION: 'sessionStorage',
-  INDEXED_DB: 'indexedDB',
-  MEMORY: 'memory',
-} as const;
-
-/**
- * Storage type derived from STORAGE_TYPES constant
- */
-type StorageType = (typeof STORAGE_TYPES)[keyof typeof STORAGE_TYPES];
-
-// =============================================================================
-// PWA CONSTANTS
-// =============================================================================
-
-/**
- * PWA display modes
- * @constant
- */
-declare const PWA_DISPLAY_MODES = {
-  STANDALONE: 'standalone',
-  FULLSCREEN: 'fullscreen',
-  MINIMAL_UI: 'minimal-ui',
-  BROWSER: 'browser',
-} as const;
-
-/**
- * PWA display mode type derived from PWA_DISPLAY_MODES constant
- */
-type PWADisplayMode =
-  (typeof PWA_DISPLAY_MODES)[keyof typeof PWA_DISPLAY_MODES];
-
-/**
- * PWA asset types
- * @constant
- */
-declare const PWA_ASSET_TYPES = {
-  MANIFEST: 'manifest',
-  SERVICE_WORKER: 'service-worker',
-  ICON: 'icon',
-} as const;
-
-/**
- * PWA asset type derived from PWA_ASSET_TYPES constant
- */
-type PWAAssetType =
-  (typeof PWA_ASSET_TYPES)[keyof typeof PWA_ASSET_TYPES];
-
-// =============================================================================
-// ROUTE DISCOVERY CONSTANTS
-// =============================================================================
-
-/**
- * Route discovery sources
- * @constant
- */
-declare const ROUTE_SOURCES = {
-  AUTO: 'auto-discovery',
-  MANUAL: 'manual',
-  HYBRID: 'hybrid',
-} as const;
-
-/**
- * Route source type derived from ROUTE_SOURCES constant
- */
-type RouteSource = (typeof ROUTE_SOURCES)[keyof typeof ROUTE_SOURCES];
-
-// =============================================================================
-// AUTHENTICATION TYPES
-// =============================================================================
-
-/**
- * Page-level authentication requirements
- * @description Used in PageMeta and NavigationRoute for route-level auth
- */
-type PageAuth =
-  | boolean
-  | {
-      /** Whether authentication is required */
-      required?: boolean;
-      /** Required user role */
-      role?: UserRole;
-      /** Required subscription tier */
-      tier?: SubscriptionTier;
-      /** Custom validation function */
-      validate?: (role: string, tier: string) => boolean;
-    };
-
-// =============================================================================
-// PAGE METADATA TYPES
-// =============================================================================
-
-/**
- * Page metadata interface for route discovery and configuration
- *
- * @remarks
- * **ALL PROPERTIES ARE OPTIONAL** - Framework provides smart defaults:
- *
- * - `auth`: false (public) by default - YOU must specify auth requirements explicitly
- * - `title`: Auto-extracted from filename (ShowcasePage → "Showcase")
- * - `entity`: Auto-extracted from path (pages/showcase/ → "showcase")
- * - `action`: Auto-extracted from filename patterns (ListPage → "list", FormPage → "form")
- * - `route`: Only needed for custom paths or dynamic routes like :id, :slug
- *
- * @example Simple page (no meta needed):
- * ```tsx
- * export function HomePage() {
- *   return <PageContainer>...</PageContainer>;
- * }
- * // Framework provides: auth=false, title from home.title, entity=home
- * ```
- *
- * @example Dynamic route (string format - explicit path):
- * ```tsx
- * export const meta: PageMeta = {
- *   route: '/blog/:slug'  // Creates /blog/:slug
- * };
- * // Framework provides: auth=false, title from blog.title, entity=blog
- * ```
- *
- * @example Dynamic route (object format - auto-generates base path):
- * ```tsx
- * export const meta: PageMeta = {
- *   route: { params: ['id'] }  // Creates /myRoute/:id (base path from file location)
- * };
- * // For file at pages/myRoute/DetailPage.tsx → route becomes /myRoute/:id
- * ```
- *
- * @example Auth-required (developer must be explicit):
- * ```tsx
- * export const meta: PageMeta = {
- *   auth: { required: true }  // YOU decide what needs auth
- * };
- * ```
- */
-interface PageMeta {
-  /** Authentication requirements for this route */
-  auth?: PageAuth;
-
-  /** Route configuration - just define the exact path you want */
-  route?: string | { params?: string[] };
-
-  /** Page title (optional - framework auto-extracts from filename if not provided) */
-  title?: string;
-
-  /**
-   * Translation/SEO namespace for this page
-   * @description Used for meta tags and translations
-   */
-  namespace?: string;
-
-  /**
-   * Icon for navigation (optional - framework provides smart defaults)
-   * @description **ONLY lucide-react JSX components** - extracted as component name string at build time for tree-shaking.
-   *
-   * **RESTRICTIONS:**
-   * - ✅ Only: `<Rocket />`, `<ShoppingCart />`, `<Home />` (lucide-react JSX components)
-   * - ❌ NOT: Emojis (`"🚀"`), strings (`"Rocket"`), or custom ReactNode
-   *
-   * **Why?** This is for build-time extraction and tree-shaking. The component name is extracted and stored as a string.
-   *
-   * **For flexible icons** (emojis, strings, custom components), use the `Icon` component directly in your JSX, not in PageMeta.
-   *
-   * @example
-   * ```tsx
-   * import { Rocket } from 'lucide-react';
-   * export const meta: PageMeta = {
-   *   icon: <Rocket />  // ✅ Correct - lucide-react component
-   * };
-   * ```
-   *
-   * @example
-   * ```tsx
-   * // ❌ WRONG - Don't use emojis or strings in PageMeta
-   * export const meta: PageMeta = {
-   *   icon: "🚀"  // ❌ Not supported in PageMeta
-   * };
-   * ```
-   */
-  icon?: ReactNode;
-
-  /**
-   * Hide from navigation menu (default: false - shows in navigation)
-   * @description Set to true to exclude this route from navigation menus
-   * @default false
-   * @example
-   * ```tsx
-   * export const meta: PageMeta = {
-   *   hideFromMenu: true // Won't appear in HeaderNavigation, Sidebar, etc.
-   * };
-   * ```
-   */
-  hideFromMenu?: boolean;
-}
-
-/**
- * Route metadata (discovery-generated)
- * @description Complete route metadata including auto-discovered fields from RouteDiscovery
- *
- * This extends PageMeta with fields that are automatically discovered from file paths:
- * - `entity`: Auto-extracted from path (pages/showcase/ → "showcase")
- * - `action`: Auto-extracted from filename patterns (ListPage → "list", FormPage → "form")
- *
- * These fields are always present in discovered routes but cannot be set in PageMeta.
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-interface RouteMeta extends PageMeta {
-  /** Entity/domain grouping - auto-discovered from file path (not user-configurable) */
-  entity?: string;
-  /** Action type for route categorization - auto-discovered from filename patterns (not user-configurable) */
-  action?: string | null;
-  /** File path where route was discovered */
-  file?: string;
-}
-
-// =============================================================================
-// PLUGIN CONFIGURATION TYPES
-// =============================================================================
-
-/**
- * i18n Plugin Configuration
- * @description Configuration for internationalization system
- */
-interface I18nPluginConfig {
-  /** Mapping of language → namespace → loader function */
-  mapping: Record<string, Record<string, () => Promise<any>>>;
-  /** List of available language codes */
-  languages: string[];
-  /** List of eagerly loaded namespace identifiers */
-  eager: string[];
-  /** Fallback language code */
-  fallback: string;
-  /** Preloaded translation content (optional) */
-  content?: Record<string, Record<string, any>>;
-  /** Storage configuration */
-  storage: {
-    /** Storage backend type */
-    type: StorageType;
-    /** Storage key prefix */
-    prefix: string;
-    /** Time-to-live in seconds */
-    ttl: number;
-    /** Whether to encrypt stored data */
-    encryption: boolean;
-    /** Maximum storage size in bytes */
-    maxSize: number;
-  };
-  /** Performance configuration */
-  performance: {
-    /** Maximum cache size */
-    cacheSize: number;
-    /** Error cache TTL in seconds */
-    errorCacheTTL: number;
-  };
-  /** Discovery manifest metadata */
-  manifest: {
-    /** Total number of translation files */
-    totalFiles: number;
-    /** Total number of namespaces */
-    totalNamespaces: number;
-    /** Total number of languages */
-    totalLanguages: number;
-    /** Number of eagerly loaded namespaces */
-    eagerNamespaces: number;
-    /** ISO timestamp of generation */
-    generatedAt: string;
-  };
-  /** Whether debug mode is enabled */
-  debug: boolean;
-}
-
-/**
- * Routes Plugin Configuration
- * @description Complete route configuration populated by discovery system
- */
-interface RoutesPluginConfig {
-  /**
-   * Array of discovered routes
-   * @description All routes discovered by the route discovery system
-   */
-  mapping: Array<{
-    /**
-     * URL path for the route (platform-agnostic)
-     * @description The URL path that users see in their browser
-     * @example '/showcase/layouts', '/users/:id', '/dashboard'
-     */
-    path: string;
-
-    /**
-     * Lazy component reference (Vite-specific)
-     * @description React.lazy() component for code splitting
-     * @example lazy(() => import("/src/pages/showcase/LayoutsPage"))
-     */
-    component: any;
-
-    /**
-     * Absolute file system path (Next.js-specific)
-     * @description The absolute path to the component file
-     * @example '/src/pages/showcase/LayoutsPage.tsx'
-     */
-    importPath: string;
-
-    /**
-     * Export name for named exports
-     * @example 'HomePage', 'AboutPage'
-     */
-    exportName?: string;
-
-    /**
-     * Authentication configuration (platform-agnostic)
-     * @description Defines whether the route requires authentication
-     */
-    auth: PageAuth;
-
-    /**
-     * Route metadata (platform-agnostic)
-     * @description Additional information about the route, including auto-discovered fields
-     */
-    meta: RouteMeta;
-  }>;
-
-  /**
-   * Discovery metadata and statistics
-   * @description Information about the route discovery process
-   */
-  manifest: {
-    /** Total number of discovered routes */
-    totalRoutes: number;
-    /** Number of routes requiring authentication */
-    authRequired: number;
-    /** Number of public routes */
-    publicRoutes: number;
-    /** Source of routes (auto-discovery vs manual) */
-    source: RouteSource;
-    /** ISO timestamp when routes were generated */
-    generatedAt: string;
-  };
-}
-
-/**
- * Themes Plugin Configuration
- * @description Configuration for theme discovery and management
- */
-interface ThemesPluginConfig {
-  /** Mapping of theme names to theme configurations */
-  mapping: Record<string, any>;
-  /** Array of discovered themes */
-  discovered: Array<{
-    /** Theme identifier */
-    name: string;
-    /** Human-readable theme name */
-    displayName: string;
-    /** Whether this is a dark theme */
-    isDark: boolean;
-    /** Theme metadata */
-    meta: {
-      /** Icon identifier */
-      icon: string;
-      /** Theme description */
-      description?: string;
-      /** Theme category */
-      category?: string;
-      /** Theme author */
-      author?: string;
-      /** Additional metadata */
-      [key: string]: any;
-    };
-    /** Source file path */
-    source: string;
-    /** Whether theme is essential (cannot be disabled) */
-    essential: boolean;
-  }>;
-  /** CSS custom property variables */
-  variables: Record<string, string>;
-  /** Utility class mappings */
-  utilities: Record<string, Record<string, string>>;
-  /** Discovery manifest metadata */
-  manifest: {
-    /** Total number of discovered themes */
-    totalThemes: number;
-    /** Total number of CSS variables */
-    totalVariables: number;
-    /** Total number of utility classes */
-    totalUtilities: number;
-    /** ISO timestamp of generation */
-    generatedAt: string;
-  };
-}
-
-/**
- * Assets Plugin Configuration
- * @description Configuration for static asset management
- */
-interface AssetsPluginConfig {
-  /** Mapping of asset paths to asset metadata */
-  mapping: Record<string, any>;
-  /** SVG content of logo.svg for inline rendering with CSS variable theming */
-  logoSvgContent?: string | null;
-  /** Discovery manifest metadata */
-  manifest: {
-    /** Total number of discovered assets */
-    totalAssets: number;
-    /** ISO timestamp of generation */
-    generatedAt: string;
-  };
-}
-
-/**
- * PWA Plugin Configuration
- * @description Configuration for Progressive Web App features
- */
-interface PWAPluginConfig {
-  /** Array of PWA assets */
-  assets: Array<{
-    /** Type of PWA asset */
-    type: PWAAssetType;
-    /** Asset file path */
-    path: string;
-    /** Asset file size in bytes */
-    size?: number;
-    /** Asset content (for inline assets) */
-    content?: any;
-    /** Asset format (for images) */
-    format?: string;
-    /** Asset purpose (for icons) */
-    purpose?: string;
-  }>;
-  /** PWA manifest configuration */
-  manifest: {
-    /** Application name */
-    name: string;
-    /** Short application name */
-    short_name: string;
-    /** Application description */
-    description: string;
-    /** Start URL */
-    start_url: string;
-    /** Display mode */
-    display: PWADisplayMode;
-    /** Background color */
-    background_color: string;
-    /** Theme color */
-    theme_color: string;
-    /** Array of app icons */
-    icons: Array<{
-      /** Icon source path */
-      src: string;
-      /** Icon sizes (e.g., '192x192') */
-      sizes: string;
-      /** Icon MIME type */
-      type: string;
-      /** Icon purpose (e.g., 'any', 'maskable') */
-      purpose: string;
-    }>;
-  };
-  /** Discovery manifest metadata */
-  manifestInfo: {
-    /** Total number of PWA assets */
-    totalAssets: number;
-    /** Total number of icons */
-    totalIcons: number;
-    /** Whether service worker is present */
-    hasServiceWorker: boolean;
-    /** ISO timestamp of generation */
-    generatedAt: string;
-  };
-}
-
-/**
- * Features Plugin Configuration
- * @description Configuration for feature discovery and enablement
- *
- * @remarks
- * This interface defines the structure for feature discovery data that is populated
- * at build time and made available at runtime for feature availability checking.
- *
- * @example
- * ```typescript
- * // Generated by feature discovery system
- * const featuresConfig: FeaturesPluginConfig = {
- *   available: ['auth', 'billing', 'i18n', 'oauth'],
- *   enabled: ['auth', 'i18n'],
- *   overridden: false
- * };
- * ```
- */
-interface FeaturesPluginConfig {
-  /**
-   * List of all available features discovered in packages/features/
-   * @example ['auth', 'billing', 'i18n', 'oauth']
-   */
-  available: string[];
-}
-
-// =============================================================================
-// FRAMEWORK CONFIGURATION
-// =============================================================================
-
-/**
- * Complete DoNotDev framework configuration structure
- * @description Single source of truth for all framework configuration
- *
- * @remarks
- * All discovery plugins add their data to this unified config.
- * Available at runtime via globalThis._DNDEV_CONFIG_ or window._DNDEV_CONFIG_
- */
-interface DndevFrameworkConfig {
-  /** Framework platform (Vite or Next.js) */
-  platform: Platform;
-  /** Current environment mode */
-  mode: EnvironmentMode;
-  /** Framework version */
-  version: string;
-  /** Execution context */
-  context: Context;
-  /** Unix timestamp of config generation */
-  timestamp: number;
-  /** i18n plugin configuration (optional) */
-  i18n?: I18nPluginConfig;
-  /** Routes plugin configuration (optional) */
-  routes?: RoutesPluginConfig;
-  /** Themes plugin configuration (optional) */
-  themes?: ThemesPluginConfig;
-  /** Assets plugin configuration (optional) */
-  assets?: AssetsPluginConfig;
-  /** PWA plugin configuration (optional) */
-  pwa?: PWAPluginConfig;
-  /** Features plugin configuration (optional) */
-  features?: FeaturesPluginConfig;
-  /** Environment variables (VITE_* variables from .env files) */
-  env?: Record<string, string>;
-}
-
-// =============================================================================
-// GLOBAL AUGMENTATIONS
-// =============================================================================
-
-declare global {
-  interface Window {
-    /**
-     * Single source of truth for all DoNotDev framework configuration
-     * @description Set by platform detection and populated by discovery plugins
-     */
-    _DNDEV_CONFIG_?: DndevFrameworkConfig;
-
-    /**
-     * Global store registry for singleton Zustand stores
-     * @description Ensures single instance across code-split chunks
-     */
-    _DNDEV_STORES_?: Record<string, any>;
-
-    /** PapaParse CSV parser library (external) */
-    Papa?: {
-      parse: (input: string | File, config?: any) => any;
-      unparse: (data: any[], config?: any) => string;
-    };
-
-    /** Sentry error tracking library (external) */
-    Sentry?: {
-      captureException: (error: unknown) => void;
-      withScope: (callback: (scope: any) => void) => void;
-      getClient: () => { close: () => Promise<boolean> } | undefined;
-    };
-
-    /**
-     * Google APIs (Maps, One Tap, etc.)
-     * @description Unified type for all Google services
-     */
-    google?: {
-      /** Google Maps API */
-      maps?: {
-        places?: {
-          AutocompleteService: new () => any;
-          PlacesService: new (element: HTMLElement) => any;
-          PlacesServiceStatus: {
-            OK: string;
-          };
-        };
-        [key: string]: any;
-      };
-      /** Google Identity Services (One Tap) */
-      accounts?: {
-        id?: {
-          initialize: (config: any) => void;
-          prompt: (callback?: (notification: any) => void) => void;
-          cancel?: () => void;
-          disableAutoSelect?: () => void;
-        };
-      };
-      [key: string]: any;
-    };
-
-    /** FedCM Identity Credential API */
-    IdentityCredential?: any;
-  }
-
-  namespace NodeJS {
-    interface ProcessEnv {
-      /** Serialized framework config for Node.js environment */
-      _DNDEV_CONFIG_?: string;
-    }
-  }
-
-  namespace globalThis {
-    /** Framework configuration (same as window._DNDEV_CONFIG_) */
-    var _DNDEV_CONFIG_: DndevFrameworkConfig | undefined;
-    /** Store registry (same as window._DNDEV_STORES_) */
-    var _DNDEV_STORES_: Record<string, any> | undefined;
-
-    // Third-party framework globals (not owned by DoNotDev)
-    var __vite_plugin_react_preamble_installed__: boolean | undefined;
-    var __vite_hmr_port: number | undefined;
-    var __NEXT_DATA__: any | undefined;
-    var __REACT_QUERY_CLIENT__: any | undefined;
-    var __REACT_QUERY_PROVIDER__: any | undefined;
-    var __DNDEV_DEBUG: boolean | undefined;
-    var __FIREBASE_DEMO_MODE__: boolean | undefined;
-    // gc is already defined by Node.js globals - removed to avoid TS 5.9+ conflict
-    var getAvailableThemes: (() => string[]) | undefined;
-  }
-}
 
 // packages/core/types/src/functions/functionTypes.ts