Files
prosperon/docs/api/modules/dmon.md
John Alanbrook 83b798e365 Add Hugo website and rewrite docs to match current engine
New Hugo site in website/ with prosperon.dev theme (blue/gold/castle
aesthetic), docs sidebar navigation, and content pages. Rewrote all
doc files to align with the actual codebase: compositor+film2d
rendering, use() modules (no global prosperon object), Pit language,
script+JSON entity model. Added entities.md, front matter to all
70+ API docs, and updated API index for current module architecture.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-23 18:09:55 -06:00

1.3 KiB

title, type
title type
dmon docs

dmon

watch() function

Start watching the root directory, recursively.

This function begins monitoring the specified directory and its subdirectories recursively for events such as file creation, deletion, modification, or movement. Events are queued and can be retrieved by calling poll.

:throws: An error if dmon is already watching.

Returns: None

unwatch() function

Stop watching the currently monitored directory.

This function halts filesystem monitoring for the directory previously set by watch. It clears the watch state, allowing a new watch to be started.

:throws: An error if no directory is currently being watched.

Returns: None

poll(callback) function

Retrieve and process queued filesystem events.

This function dequeues all pending filesystem events and invokes the provided callback for each one. The callback receives an event object with properties: 'action' (string: "create", "delete", "modify", or "move"), 'root' (string: watched directory), 'file' (string: affected file path), and 'old' (string: previous file path for move events, empty if not applicable).

callback: A function to call for each event, receiving an event object as its argument.

Returns: None