DIALECT_IDconstconst DIALECT_ID: "native-pinned"The id of the dialect.
The dialect: its guarantees as data (for Archon and for Toolchain), the plan file it renders from an order and a plan, the steps that check and apply it through the program of the dialect, and the observation that gives Archon what is installed. A tool that is installed as pinned is observed as its own desired state, so that Archon's plan says nothing is to be done.
import { nativePinned } from "./dialect.ts";
// nativePinned({ policy }).guarantees.destroy === trueDIALECT_IDconstconst DIALECT_ID: "native-pinned"The id of the dialect.
TOOL_DIALECTconstconst TOOL_DIALECT: ToolDialectThe dialect as Toolchain reads it: how exactly it pins, how it checks, where it installs, what it reaches, and that it never builds from source.
jobOffunctionfunction jobOf(r: Requirement): ToolJob | undefinedThe job a tool requirement of Toolchain asks of this dialect, or nothing where it asks another dialect or is not one.
DialectOptionstypeno test imports ittype DialectOptions = {
readonly policy: Policy;
/** The platform the tools are installed on; this computer's by default. */
readonly platform?: string;
/** The folder the files of a render are written in, below the working folder; `.archon` by default. */
readonly renderRoot?: string;
};What a dialect is made with.
nativePinnedfunctionfunction nativePinned(o: DialectOptions): DialectThe dialect, as the port of Archon takes it.
observeRequirementsfunctionfunction observeRequirements(requirements: readonly Requirement[], store: Store, o: { readonly policy: Policy; readonly path?: string | undefined; readonly ask?: Ask | undefined; }): Promise<ReadonlyMap<RequirementId, JsonValue>>What Archon is given of what is installed: the desired state itself for a tool that is installed as pinned, a state that differs for one that is installed otherwise, nothing for one that is absent.