@csszyx/unplugin 0.9.0 → 0.9.2

package/dist/next-watcher.cjs

@@ -0,0 +1,237 @@
+'use strict';
+
+const path = require('node:path');
+const nextWatcherCycle = require('./shared/unplugin.s62yJbu1.cjs');
+require('node:fs');
+require('node:crypto');
+require('node:os');
+require('proper-lockfile');
+
+function _interopNamespaceCompat(e) {
+    if (e && typeof e === 'object' && 'default' in e) return e;
+    const n = Object.create(null);
+    if (e) {
+        for (const k in e) {
+            n[k] = e[k];
+        }
+    }
+    n.default = e;
+    return n;
+}
+
+const path__namespace = /*#__PURE__*/_interopNamespaceCompat(path);
+
+class NextWatcherLoop {
+  context;
+  cycleOptions;
+  debounceMs;
+  runCycle;
+  setTimeoutFn;
+  clearTimeoutFn;
+  onError;
+  timer;
+  disposed = false;
+  pendingReasons = /* @__PURE__ */ new Set();
+  lastResult;
+  lastError;
+  /**
+   *
+   * @param options
+   */
+  constructor(options) {
+    this.context = options.context;
+    this.cycleOptions = options.cycleOptions ?? {};
+    this.debounceMs = options.debounceMs ?? 50;
+    this.runCycle = options.runCycle ?? nextWatcherCycle.runNextWatcherCycle;
+    this.setTimeoutFn = options.setTimeout ?? setTimeout;
+    this.clearTimeoutFn = options.clearTimeout ?? clearTimeout;
+    this.onError = options.onError;
+  }
+  /**
+   *
+   */
+  get pending() {
+    return this.timer !== void 0;
+  }
+  /**
+   *
+   */
+  get reasons() {
+    return [...this.pendingReasons];
+  }
+  /**
+   *
+   * @param reason
+   */
+  notify(reason = "change") {
+    if (this.disposed) {
+      return;
+    }
+    this.pendingReasons.add(reason);
+    if (this.timer !== void 0) {
+      return;
+    }
+    this.timer = this.setTimeoutFn(() => {
+      try {
+        this.runPendingCycle();
+      } catch (error) {
+        this.lastError = error;
+        this.onError?.(error);
+      }
+    }, this.debounceMs);
+  }
+  /**
+   *
+   */
+  flush() {
+    if (this.disposed || this.timer === void 0) {
+      return void 0;
+    }
+    return this.runPendingCycle();
+  }
+  /**
+   *
+   */
+  dispose() {
+    if (this.timer !== void 0) {
+      this.clearTimeoutFn(this.timer);
+    }
+    this.timer = void 0;
+    this.pendingReasons.clear();
+    this.disposed = true;
+  }
+  /**
+   *
+   */
+  runPendingCycle() {
+    const timer = this.timer;
+    if (timer !== void 0) {
+      this.clearTimeoutFn(timer);
+    }
+    this.timer = void 0;
+    const reasons = [...this.pendingReasons];
+    this.pendingReasons.clear();
+    const result = this.runCycle(this.context, this.cycleOptions, reasons);
+    this.lastResult = result;
+    this.lastError = void 0;
+    return result;
+  }
+}
+
+function isNextSafelistShardPath(shardsDir, filePath) {
+  if (!path__namespace.isAbsolute(filePath)) {
+    return false;
+  }
+  const relative = path__namespace.relative(path__namespace.resolve(shardsDir), path__namespace.resolve(filePath));
+  return relative.length > 0 && relative !== ".." && !relative.startsWith(`..${path__namespace.sep}`) && !path__namespace.isAbsolute(relative) && !relative.includes(path__namespace.sep) && !relative.startsWith(".") && relative.endsWith(".json");
+}
+function isNextAppSourcePath(root, filePath) {
+  if (!path__namespace.isAbsolute(filePath)) {
+    return false;
+  }
+  const relative = path__namespace.relative(path__namespace.resolve(root), path__namespace.resolve(filePath));
+  return relative.length > 0 && relative !== ".." && !relative.startsWith(`..${path__namespace.sep}`) && !path__namespace.isAbsolute(relative);
+}
+class NextSafelistWatcher {
+  root;
+  shardsDir;
+  loop;
+  started = false;
+  closed = false;
+  /**
+   *
+   * @param options
+   */
+  constructor(options) {
+    this.root = path__namespace.resolve(options.context.root);
+    this.shardsDir = path__namespace.resolve(options.context.safelist.shardsDir);
+    this.loop = new NextWatcherLoop(options);
+  }
+  /**
+   *
+   */
+  get pending() {
+    return this.loop.pending;
+  }
+  /**
+   *
+   */
+  get lastResult() {
+    return this.loop.lastResult;
+  }
+  /**
+   *
+   */
+  get lastError() {
+    return this.loop.lastError;
+  }
+  /**
+   * Materialize existing shards before accepting live filesystem events.
+   */
+  start() {
+    if (this.closed) {
+      throw new Error("[csszyx] Cannot start a closed Next safelist watcher.");
+    }
+    if (this.started && this.loop.lastResult) {
+      return this.loop.lastResult;
+    }
+    this.started = true;
+    this.loop.notify("initial");
+    const result = this.loop.flush();
+    if (!result) {
+      throw new Error("[csszyx] Next safelist watcher failed to run its initial cycle.");
+    }
+    return result;
+  }
+  /**
+   * Queue a materialization cycle for one relevant shard filesystem event.
+   *
+   * @param event Normalized add/change/unlink event.
+   * @param filePath Absolute event path.
+   * @returns Whether the event was accepted.
+   */
+  notify(event, filePath) {
+    if (this.closed || !this.started || !isNextSafelistShardPath(this.shardsDir, filePath)) {
+      return false;
+    }
+    this.loop.notify(`shard:${event}`);
+    return true;
+  }
+  /**
+   * Queue tombstone cleanup after a source file is removed.
+   *
+   * @param filePath Absolute deleted source path.
+   * @returns Whether the event was accepted.
+   */
+  notifySourceRemoval(filePath) {
+    if (this.closed || !this.started || !isNextAppSourcePath(this.root, filePath)) {
+      return false;
+    }
+    this.loop.notify("source:unlink");
+    return true;
+  }
+  /**
+   * Flush any pending event batch immediately.
+   */
+  flush() {
+    return this.loop.flush();
+  }
+  /**
+   * Flush pending work before permanently closing the controller.
+   */
+  close() {
+    if (this.closed) {
+      return void 0;
+    }
+    this.closed = true;
+    try {
+      return this.loop.flush();
+    } finally {
+      this.loop.dispose();
+    }
+  }
+}
+
+exports.NextSafelistWatcher = NextSafelistWatcher;
+exports.isNextAppSourcePath = isNextAppSourcePath;
+exports.isNextSafelistShardPath = isNextSafelistShardPath;

package/dist/next-watcher.d.cts

@@ -0,0 +1,106 @@
+import { N as NextStateContext } from './shared/unplugin.CPEWNSA0.cjs';
+import { a as NextWatcherCycleOptions, N as NextWatcherCycleResult } from './shared/unplugin.xeED_qwh.cjs';
+
+/**
+ *
+ */
+type WatcherTimer = ReturnType<typeof setTimeout>;
+/** Function used to run one materialization cycle. */
+type NextWatcherLoopCycleRunner = (context: NextStateContext, options: NextWatcherCycleOptions, reasons: readonly string[]) => NextWatcherCycleResult;
+/** Timer hooks kept injectable so debounce behavior is deterministic in tests. */
+interface NextWatcherLoopTimerHooks {
+    setTimeout?: (callback: () => void, delayMs: number) => WatcherTimer;
+    clearTimeout?: (timer: WatcherTimer) => void;
+}
+
+/** Filesystem events that can change the materialized safelist. */
+type NextSafelistWatchEvent = 'add' | 'change' | 'unlink';
+/** Options for the filesystem-independent Next safelist watcher controller. */
+interface NextSafelistWatcherOptions extends NextWatcherLoopTimerHooks {
+    context: NextStateContext;
+    cycleOptions?: NextWatcherCycleOptions;
+    debounceMs?: number;
+    runCycle?: NextWatcherLoopCycleRunner;
+    onError?: (error: unknown) => void;
+}
+/**
+ * Validate one watcher event path against the flat safelist shard directory.
+ *
+ * The future filesystem adapter must pass absolute paths. Restricting accepted
+ * events to direct `.json` children prevents unrelated cache files, atomic
+ * write temp files, and paths outside this app root from triggering a cycle.
+ *
+ * @param shardsDir Absolute safelist shard directory.
+ * @param filePath Absolute event path.
+ * @returns Whether the event belongs to a materialized shard.
+ */
+declare function isNextSafelistShardPath(shardsDir: string, filePath: string): boolean;
+/**
+ * Validate that an absolute source event path belongs to the resolved app root.
+ *
+ * @param root Absolute Next app root.
+ * @param filePath Absolute event path.
+ * @returns Whether the source is inside the app root.
+ */
+declare function isNextAppSourcePath(root: string, filePath: string): boolean;
+/**
+ * Lifecycle controller between an OS file watcher and the materialization loop.
+ *
+ * This class deliberately does not import `chokidar` or `fs.watch`. A CLI can
+ * own that dependency and feed normalized events here while the state machine
+ * remains deterministic and package-size neutral.
+ */
+declare class NextSafelistWatcher {
+    private readonly root;
+    private readonly shardsDir;
+    private readonly loop;
+    private started;
+    private closed;
+    /**
+     *
+     * @param options
+     */
+    constructor(options: NextSafelistWatcherOptions);
+    /**
+     *
+     */
+    get pending(): boolean;
+    /**
+     *
+     */
+    get lastResult(): NextWatcherCycleResult | undefined;
+    /**
+     *
+     */
+    get lastError(): unknown;
+    /**
+     * Materialize existing shards before accepting live filesystem events.
+     */
+    start(): NextWatcherCycleResult;
+    /**
+     * Queue a materialization cycle for one relevant shard filesystem event.
+     *
+     * @param event Normalized add/change/unlink event.
+     * @param filePath Absolute event path.
+     * @returns Whether the event was accepted.
+     */
+    notify(event: NextSafelistWatchEvent, filePath: string): boolean;
+    /**
+     * Queue tombstone cleanup after a source file is removed.
+     *
+     * @param filePath Absolute deleted source path.
+     * @returns Whether the event was accepted.
+     */
+    notifySourceRemoval(filePath: string): boolean;
+    /**
+     * Flush any pending event batch immediately.
+     */
+    flush(): NextWatcherCycleResult | undefined;
+    /**
+     * Flush pending work before permanently closing the controller.
+     */
+    close(): NextWatcherCycleResult | undefined;
+}
+
+export { NextSafelistWatcher, isNextAppSourcePath, isNextSafelistShardPath };
+export type { NextSafelistWatchEvent, NextSafelistWatcherOptions };

package/dist/next-watcher.d.mts

@@ -0,0 +1,106 @@
+import { N as NextStateContext } from './shared/unplugin.CPEWNSA0.mjs';
+import { a as NextWatcherCycleOptions, N as NextWatcherCycleResult } from './shared/unplugin.CdZxp0x-.mjs';
+
+/**
+ *
+ */
+type WatcherTimer = ReturnType<typeof setTimeout>;
+/** Function used to run one materialization cycle. */
+type NextWatcherLoopCycleRunner = (context: NextStateContext, options: NextWatcherCycleOptions, reasons: readonly string[]) => NextWatcherCycleResult;
+/** Timer hooks kept injectable so debounce behavior is deterministic in tests. */
+interface NextWatcherLoopTimerHooks {
+    setTimeout?: (callback: () => void, delayMs: number) => WatcherTimer;
+    clearTimeout?: (timer: WatcherTimer) => void;
+}
+
+/** Filesystem events that can change the materialized safelist. */
+type NextSafelistWatchEvent = 'add' | 'change' | 'unlink';
+/** Options for the filesystem-independent Next safelist watcher controller. */
+interface NextSafelistWatcherOptions extends NextWatcherLoopTimerHooks {
+    context: NextStateContext;
+    cycleOptions?: NextWatcherCycleOptions;
+    debounceMs?: number;
+    runCycle?: NextWatcherLoopCycleRunner;
+    onError?: (error: unknown) => void;
+}
+/**
+ * Validate one watcher event path against the flat safelist shard directory.
+ *
+ * The future filesystem adapter must pass absolute paths. Restricting accepted
+ * events to direct `.json` children prevents unrelated cache files, atomic
+ * write temp files, and paths outside this app root from triggering a cycle.
+ *
+ * @param shardsDir Absolute safelist shard directory.
+ * @param filePath Absolute event path.
+ * @returns Whether the event belongs to a materialized shard.
+ */
+declare function isNextSafelistShardPath(shardsDir: string, filePath: string): boolean;
+/**
+ * Validate that an absolute source event path belongs to the resolved app root.
+ *
+ * @param root Absolute Next app root.
+ * @param filePath Absolute event path.
+ * @returns Whether the source is inside the app root.
+ */
+declare function isNextAppSourcePath(root: string, filePath: string): boolean;
+/**
+ * Lifecycle controller between an OS file watcher and the materialization loop.
+ *
+ * This class deliberately does not import `chokidar` or `fs.watch`. A CLI can
+ * own that dependency and feed normalized events here while the state machine
+ * remains deterministic and package-size neutral.
+ */
+declare class NextSafelistWatcher {
+    private readonly root;
+    private readonly shardsDir;
+    private readonly loop;
+    private started;
+    private closed;
+    /**
+     *
+     * @param options
+     */
+    constructor(options: NextSafelistWatcherOptions);
+    /**
+     *
+     */
+    get pending(): boolean;
+    /**
+     *
+     */
+    get lastResult(): NextWatcherCycleResult | undefined;
+    /**
+     *
+     */
+    get lastError(): unknown;
+    /**
+     * Materialize existing shards before accepting live filesystem events.
+     */
+    start(): NextWatcherCycleResult;
+    /**
+     * Queue a materialization cycle for one relevant shard filesystem event.
+     *
+     * @param event Normalized add/change/unlink event.
+     * @param filePath Absolute event path.
+     * @returns Whether the event was accepted.
+     */
+    notify(event: NextSafelistWatchEvent, filePath: string): boolean;
+    /**
+     * Queue tombstone cleanup after a source file is removed.
+     *
+     * @param filePath Absolute deleted source path.
+     * @returns Whether the event was accepted.
+     */
+    notifySourceRemoval(filePath: string): boolean;
+    /**
+     * Flush any pending event batch immediately.
+     */
+    flush(): NextWatcherCycleResult | undefined;
+    /**
+     * Flush pending work before permanently closing the controller.
+     */
+    close(): NextWatcherCycleResult | undefined;
+}
+
+export { NextSafelistWatcher, isNextAppSourcePath, isNextSafelistShardPath };
+export type { NextSafelistWatchEvent, NextSafelistWatcherOptions };

package/dist/next-watcher.mjs

@@ -0,0 +1,219 @@
+import * as path from 'node:path';
+import { r as runNextWatcherCycle } from './shared/unplugin.BtQzlC2C.mjs';
+import 'node:fs';
+import 'node:crypto';
+import 'node:os';
+import 'proper-lockfile';
+
+class NextWatcherLoop {
+  context;
+  cycleOptions;
+  debounceMs;
+  runCycle;
+  setTimeoutFn;
+  clearTimeoutFn;
+  onError;
+  timer;
+  disposed = false;
+  pendingReasons = /* @__PURE__ */ new Set();
+  lastResult;
+  lastError;
+  /**
+   *
+   * @param options
+   */
+  constructor(options) {
+    this.context = options.context;
+    this.cycleOptions = options.cycleOptions ?? {};
+    this.debounceMs = options.debounceMs ?? 50;
+    this.runCycle = options.runCycle ?? runNextWatcherCycle;
+    this.setTimeoutFn = options.setTimeout ?? setTimeout;
+    this.clearTimeoutFn = options.clearTimeout ?? clearTimeout;
+    this.onError = options.onError;
+  }
+  /**
+   *
+   */
+  get pending() {
+    return this.timer !== void 0;
+  }
+  /**
+   *
+   */
+  get reasons() {
+    return [...this.pendingReasons];
+  }
+  /**
+   *
+   * @param reason
+   */
+  notify(reason = "change") {
+    if (this.disposed) {
+      return;
+    }
+    this.pendingReasons.add(reason);
+    if (this.timer !== void 0) {
+      return;
+    }
+    this.timer = this.setTimeoutFn(() => {
+      try {
+        this.runPendingCycle();
+      } catch (error) {
+        this.lastError = error;
+        this.onError?.(error);
+      }
+    }, this.debounceMs);
+  }
+  /**
+   *
+   */
+  flush() {
+    if (this.disposed || this.timer === void 0) {
+      return void 0;
+    }
+    return this.runPendingCycle();
+  }
+  /**
+   *
+   */
+  dispose() {
+    if (this.timer !== void 0) {
+      this.clearTimeoutFn(this.timer);
+    }
+    this.timer = void 0;
+    this.pendingReasons.clear();
+    this.disposed = true;
+  }
+  /**
+   *
+   */
+  runPendingCycle() {
+    const timer = this.timer;
+    if (timer !== void 0) {
+      this.clearTimeoutFn(timer);
+    }
+    this.timer = void 0;
+    const reasons = [...this.pendingReasons];
+    this.pendingReasons.clear();
+    const result = this.runCycle(this.context, this.cycleOptions, reasons);
+    this.lastResult = result;
+    this.lastError = void 0;
+    return result;
+  }
+}
+
+function isNextSafelistShardPath(shardsDir, filePath) {
+  if (!path.isAbsolute(filePath)) {
+    return false;
+  }
+  const relative = path.relative(path.resolve(shardsDir), path.resolve(filePath));
+  return relative.length > 0 && relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative) && !relative.includes(path.sep) && !relative.startsWith(".") && relative.endsWith(".json");
+}
+function isNextAppSourcePath(root, filePath) {
+  if (!path.isAbsolute(filePath)) {
+    return false;
+  }
+  const relative = path.relative(path.resolve(root), path.resolve(filePath));
+  return relative.length > 0 && relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);
+}
+class NextSafelistWatcher {
+  root;
+  shardsDir;
+  loop;
+  started = false;
+  closed = false;
+  /**
+   *
+   * @param options
+   */
+  constructor(options) {
+    this.root = path.resolve(options.context.root);
+    this.shardsDir = path.resolve(options.context.safelist.shardsDir);
+    this.loop = new NextWatcherLoop(options);
+  }
+  /**
+   *
+   */
+  get pending() {
+    return this.loop.pending;
+  }
+  /**
+   *
+   */
+  get lastResult() {
+    return this.loop.lastResult;
+  }
+  /**
+   *
+   */
+  get lastError() {
+    return this.loop.lastError;
+  }
+  /**
+   * Materialize existing shards before accepting live filesystem events.
+   */
+  start() {
+    if (this.closed) {
+      throw new Error("[csszyx] Cannot start a closed Next safelist watcher.");
+    }
+    if (this.started && this.loop.lastResult) {
+      return this.loop.lastResult;
+    }
+    this.started = true;
+    this.loop.notify("initial");
+    const result = this.loop.flush();
+    if (!result) {
+      throw new Error("[csszyx] Next safelist watcher failed to run its initial cycle.");
+    }
+    return result;
+  }
+  /**
+   * Queue a materialization cycle for one relevant shard filesystem event.
+   *
+   * @param event Normalized add/change/unlink event.
+   * @param filePath Absolute event path.
+   * @returns Whether the event was accepted.
+   */
+  notify(event, filePath) {
+    if (this.closed || !this.started || !isNextSafelistShardPath(this.shardsDir, filePath)) {
+      return false;
+    }
+    this.loop.notify(`shard:${event}`);
+    return true;
+  }
+  /**
+   * Queue tombstone cleanup after a source file is removed.
+   *
+   * @param filePath Absolute deleted source path.
+   * @returns Whether the event was accepted.
+   */
+  notifySourceRemoval(filePath) {
+    if (this.closed || !this.started || !isNextAppSourcePath(this.root, filePath)) {
+      return false;
+    }
+    this.loop.notify("source:unlink");
+    return true;
+  }
+  /**
+   * Flush any pending event batch immediately.
+   */
+  flush() {
+    return this.loop.flush();
+  }
+  /**
+   * Flush pending work before permanently closing the controller.
+   */
+  close() {
+    if (this.closed) {
+      return void 0;
+    }
+    this.closed = true;
+    try {
+      return this.loop.flush();
+    } finally {
+      this.loop.dispose();
+    }
+  }
+}
+
+export { NextSafelistWatcher, isNextAppSourcePath, isNextSafelistShardPath };