ImportMeta

import { ImportMeta } from "destack:module";

Metadata about the current module and build configuration.

export interface ImportMeta {
    url: string;
    path: string | undefined;
    file: string | undefined;
    filename: string | undefined;
    dir: string | undefined;
    dirname: string | undefined;
    output: "bundle" | "program";
    platform: "unknown" | "windows" | "macos" | "linux" | "freebsd" | "openbsd" | "netbsd" | "dragonfly" | "solaris" | "illumos" | "haiku" | "fuchsia" | "redox" | "hermit" | "none";
    runtime: "destack" | "js";
    target: Dynamic<ImportMetaTarget>;
    targetName: string | undefined;
    product: string | undefined;
    version: string | undefined;
    stage: "experimental" | "alpha" | "beta" | "stable" | undefined;
    derive: readonly Derive[];
    role: string | undefined;
    labels: { readonly [key: string]: readonly string[] | undefined };
    host: "native" | "browser" | "wasi" | "emscripten" | "freestanding";
    modes: readonly string[];
    roles: readonly string[];
    features: readonly string[];
    tags: readonly string[];
    debug: boolean;
    dev: boolean;
    prod: boolean;
    test: boolean;
    bench: boolean;
    lint: boolean;
    env: Dynamic<ImportMetaEnv>;
}
language/library/src/module/meta.ds:64:123

Members

url: string

The URL of the current module (file:// for local, https:// for remote).

path: string | undefined

The file system path of the current module (only for local files).

file: string | undefined

Alias of path.

filename: string | undefined

Alias of file.

dir: string | undefined

The directory containing the current module (only for local files).

dirname: string | undefined

Alias of dir.

output: "bundle" | "program"

The artifact produced by the current build target.

platform: "unknown" | "windows" | "macos" | "linux" | "freebsd" | "openbsd" | "netbsd" | "dragonfly" | "solaris" | "illumos" | "haiku" | "fuchsia" | "redox" | "hermit" | "none"

The target platform (OS) being compiled for.

runtime: "destack" | "js"

The semantic runtime contract for this build.

target: Dynamic<ImportMetaTarget>

Structured target metadata.

targetName: string | undefined

Active build target name.

product: string | undefined

Active deliverable product name.

version: string | undefined

Active package version.

stage: "experimental" | "alpha" | "beta" | "stable" | undefined

Active package release stage.

derive: readonly Derive[]

Auto-derives declared by the current module.

role: string | undefined

Active product role.

labels: { readonly [key: string]: readonly string[] | undefined }

Labels contributed by active source graph conditions.

host: "native" | "browser" | "wasi" | "emscripten" | "freestanding"

Target host environment.

modes: readonly string[]

Active source graph modes.

roles: readonly string[]

Active source graph roles.

features: readonly string[]

Active source graph features.

tags: readonly string[]

Active source graph tags.

debug: boolean

True when the debug mode is active.

dev: boolean

True when the development mode is active.

prod: boolean

True when the production mode is active.

test: boolean

True when the test mode is active.

bench: boolean

True when the benchmark mode is active.

lint: boolean

True when the lint mode is active.

env: Dynamic<ImportMetaEnv>

Environment variables (from build configuration).