ATOMIC AI EXTERNAL FILES AND PATHS SPEC

RULE: This document defines the complete and binding system for external file access in the Atomic language.
RULE: Only the behaviors described in this document exist.
RULE: No additional file formats or path rules exist.
RULE: All rules defined here are mandatory.

PATH RESOLUTION
RULE: Atomic supports both relative and absolute file paths.
RULE: Absolute paths use the operating system full path syntax.
RULE: Relative paths are resolved against Atomic's resource directory.
RULE: The Atomic resource directory is located at:
%LOCALAPPDATA%/Atomic
RULE: If a relative path is provided, Atomic searches inside its resource directory.
RULE: Both '/' and '\' path separators are accepted.

FILE EXTENSION RESOLUTION
RULE: File extensions may be omitted.
RULE: If the extension is omitted, Atomic attempts to resolve it automatically.
RULE: Automatic resolution searches only among supported formats.

SUPPORTED IMAGE FORMATS
RULE: Atomic supports the following image formats:
.png
.jpeg
.jfif
.gif (non-animated only)
.bmp
RULE: Animated image formats are not supported.
RULE: Any image format not listed above is not supported.

SUPPORTED AUDIO FORMATS
RULE: Atomic supports the following audio format:
.ogg
RULE: Any other audio format is not supported.

SUPPORTED TABLE FORMATS
RULE: Atomic supports the following table format:
.csv
RULE: Any other table or spreadsheet format is not supported.

SUPPORTED TEXT FILE  FORMATS
RULE: Atomic supports the following text file format:
.txt
RULE: Atomic supports the .txt format for text import and export.
RULE: Text files may be used to load and store string data.

USAGE CONTEXT
RULE: External files may be referenced by functions that accept:
IMMAGINE
SUONO
NOME
PERCORSO
RULE: File loading behavior depends on the function using the file.
RULE: File existence and format validity are required for successful loading.

WEB-BASED RESOURCES
RULE: Atomic allows loading images and sounds directly from the internet.
RULE: Web-based resources may be used instead of local resource files.
RULE: This feature is intended to simplify project sharing by avoiding bundled assets.

INTERNET PATH SYNTAX
RULE: To reference a web resource, the path must start with the keyword:
internet/
RULE: The protocol prefix must be omitted.
FORBIDDEN:
http://
https://

RULE: The optional "www." prefix must also be omitted.
RULE: The remaining path corresponds to the web resource location.
RULE: The syntax is:
(NOME: internet/remote/path/to/resource)

SUPPORTED RESOURCE TYPES
RULE: Web-based paths may be used for:
images
sounds
RULE: The same format restrictions apply as for local files.
RULE: Unsupported formats remain unsupported even when loaded from the web.

USAGE RULES
RULE: Web-based resources are treated as external resources.
RULE: Web-based resources do not need to be present in the local resource directory.
RULE: The code file (.txt) alone is sufficient to share projects using web-based resources.

FORMAL CLOSURE
RULE: The external file handling system of Atomic is limited to what is defined in this document.
RULE: Any file format, path rule, or loading behavior not listed here:
does not exist
must not be inferred
must not be generated