Libraries

A Go library returns a *runtime.Library.

func Library() *runtime.Library {
    return &runtime.Library{
        Name:        "files",
        Description: "File resources.",
        Resources: map[string]runtime.ResourceRegistration{
            "file": runtime.MakeResource[File, *FileOutput, runtime.NoConfig](),
        },
    }
}

The main fields are:

• Name and Description for human-readable metadata.
• Configuration for an optional library configuration schema.
• Resources, DataSources, and Actions for primitive node types.
• Functions for inline expression functions.
• ResourceComposites, DataComposites, and ActionComposites for generated UB libraries.

The compiler assigns the resolved library path. Library authors register the types; factory source chooses the import alias.

A factory imports the library and calls a registered type with alias.type:

imports: { files: 'github.com/example/files' }

resources: {
  config: files.file { path: input.path, content: input.content }
}