@platformos/platformos-common 0.0.11 → 0.0.12

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @platformos/platformos-common
 
+## 0.0.12
+
+### Patch Changes
+
+- **MissingRenderPartialArguments**: Reports an error when required `@param` arguments declared in a partial's LiquidDoc are not provided at the `{% render %}` call site.
+- **NestedGraphQLQuery**: Detects N+1 query patterns — `{% graphql %}` tags inside `{% for %}`/`{% tablerow %}` loops. Also follows `{% function %}` and `{% render %}` calls transitively to detect indirect GraphQL queries. Skips loops wrapped in `{% cache %}` or `{% background %}`.
+- Added **GraphQLFieldCompletionProvider**: Provides completions for GraphQL field names.
+- Added **GraphQLFieldHoverProvider**: Shows hover documentation for GraphQL fields.
+- Added `theme_render_rc` as a new document type, enabling the `{% theme_render_rc %}` tag to resolve partials through configurable `theme_search_paths` defined in `app/config.yml`.
+- **DocumentsLocator**: New `locateWithSearchPaths()` method resolves partials using prioritized search paths, including dynamic paths with `{{ }}` Liquid expressions that expand by enumerating subdirectories.
+- **loadSearchPaths()**: New utility to read and parse `theme_search_paths` from `app/config.yml`.
+- **TranslationKeyExists**: Refactored to load all defined keys (app-level and module-level) in a single pass. Now suggests nearest matching keys using Levenshtein distance when a translation key is not found.
+- Extracted shared translation utilities into `translation-utils.ts` for module discovery and key loading.
+- Added `levenshtein.ts` utility for fuzzy key matching.
+- Added support for `{% try %}...{% catch error %}` — the error variable in catch branches is now correctly registered as defined, preventing false-positive "undefined object" warnings.
+- `null`/`nil` literals are now treated as compatible with any `@param` type, preventing false type-mismatch errors when passing null values to partials.
+- `recursiveReadDirectory` now gracefully handles `ENOENT` errors instead of crashing when a directory doesn't exist.
+- **MissingPartial** check updated to support `theme_render_rc` tag resolution through search paths.
+- Extracted `tryExtractAssignUrl()` helper to deduplicate assign-to-URL resolution logic shared between `MissingPage` check and `buildVariableMap`.
+- Fixed `buildVariableMap` to correctly recurse into block tags (`{% if %}`, `{% for %}`) whose position spans beyond the cursor offset — previously assigns inside such blocks could be missed.
+- **SearchPathsLoader**: Now caches `theme_search_paths` per root URI to avoid re-reading `app/config.yml` on every request. Invalidated when file watchers detect config changes.
+- Immediate cache invalidation on `app/config.yml` save (via `onDidSaveTextDocument`) so go-to-definition doesn't see stale data.
+- Bulk file-watcher threshold extracted to `BULK_PAGE_CHANGE_THRESHOLD` constant.
+- **RouteTable**: Added `routeCount()` method returning total number of route entries.
+- Route table build errors are now properly handled — a failed build resets the cached promise so subsequent attempts can retry.
+- `MissingPartial` check simplified with a shared `reportIfMissing()` helper, reducing code duplication across `RenderMarkup`, `FunctionMarkup`, and `GraphQLMarkup` visitors.
+- AST traversal helpers (`getTraversableChildren`, `getTraversableMarkup`) extracted in `url-helpers.ts`.
+- `MissingPage` check front-loads route table building in `onCodePathStart` instead of lazy-loading per element visit.
+
 ## 0.0.11
 
 ### Patch Changes

package/dist/documents-locator/DocumentsLocator.d.ts

@@ -1,6 +1,14 @@
 import { AbstractFileSystem } from '../AbstractFileSystem';
 import { URI } from 'vscode-uri';
-export type DocumentType = 'function' | 'render' | 'include' | 'graphql' | 'asset';
+export type DocumentType = 'function' | 'render' | 'include' | 'graphql' | 'asset' | 'theme_render_rc';
+/**
+ * Load theme_search_paths from app/config.yml.
+ * Returns null if the file doesn't exist, is malformed, or has no valid theme_search_paths.
+ * Results should be cached per root URI.
+ */
+export declare function loadSearchPaths(fs: {
+    readFile(uri: string): Promise<string>;
+}, rootUri: URI): Promise<string[] | null>;
 export declare class DocumentsLocator {
     private readonly fs;
     constructor(fs: AbstractFileSystem);
@@ -9,6 +17,31 @@ export declare class DocumentsLocator {
     private getSearchPaths;
     private locateFile;
     private listFiles;
-    locate(rootUri: URI, nodeName: DocumentType, fileName: string): Promise<string | undefined>;
+    private static readonly LIQUID_EXPRESSION_RE;
+    private listSubdirectoryNames;
+    private expandedPathsCache;
+    clearExpandedPathsCache(): void;
+    /**
+     * Expand a search path that may contain {{ ... }} Liquid expressions into
+     * concrete directory prefixes by enumerating subdirectories at each dynamic
+     * segment. Static segments pass through unchanged.
+     *
+     * Results are cached per (rootUri, searchPath) and capped at 100 entries.
+     */
+    private expandDynamicPath;
+    /**
+     * Resolve a search path (static, dynamic, or empty) into concrete prefix
+     * strings. Cached for dynamic paths.
+     */
+    private resolveSearchPath;
+    /**
+     * Locate a partial using theme search paths (for theme_render_rc).
+     *
+     * Tries each search path prefix in priority order, then falls back to the
+     * unprefixed name (unless '' was already in the list, meaning the default
+     * position was explicitly placed).
+     */
+    locateWithSearchPaths(rootUri: URI, fileName: string, themeSearchPaths: string[]): Promise<string | undefined>;
+    locate(rootUri: URI, nodeName: DocumentType, fileName: string, themeSearchPaths?: string[] | null): Promise<string | undefined>;
     list(rootUri: URI, nodeName: string | undefined, filePrefix: string): Promise<string[]>;
 }

package/dist/documents-locator/DocumentsLocator.js

@@ -1,12 +1,38 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocumentsLocator = void 0;
+exports.loadSearchPaths = loadSearchPaths;
+const js_yaml_1 = __importDefault(require("js-yaml"));
 const AbstractFileSystem_1 = require("../AbstractFileSystem");
 const path_utils_1 = require("../path-utils");
 const vscode_uri_1 = require("vscode-uri");
+/**
+ * Load theme_search_paths from app/config.yml.
+ * Returns null if the file doesn't exist, is malformed, or has no valid theme_search_paths.
+ * Results should be cached per root URI.
+ */
+async function loadSearchPaths(fs, rootUri) {
+    try {
+        const configUri = vscode_uri_1.Utils.joinPath(rootUri, 'app/config.yml').toString();
+        const content = await fs.readFile(configUri);
+        const config = js_yaml_1.default.load(content);
+        const paths = config?.theme_search_paths;
+        if (Array.isArray(paths) && paths.length > 0) {
+            return paths.map(String);
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
 class DocumentsLocator {
     constructor(fs) {
         this.fs = fs;
+        this.expandedPathsCache = new Map();
     }
     async isFile(path) {
         try {
@@ -100,12 +126,109 @@ class DocumentsLocator {
         }
         return Array.from(results).sort((a, b) => a.localeCompare(b));
     }
-    async locate(rootUri, nodeName, fileName) {
+    async listSubdirectoryNames(dirUri) {
+        try {
+            const entries = await this.fs.readDirectory(dirUri);
+            return entries
+                .filter(([, type]) => type === AbstractFileSystem_1.FileType.Directory)
+                .map(([name]) => {
+                const lastSlash = name.lastIndexOf('/');
+                return lastSlash === -1 ? name : name.slice(lastSlash + 1);
+            })
+                .filter((name) => name.length > 0);
+        }
+        catch {
+            return [];
+        }
+    }
+    clearExpandedPathsCache() {
+        this.expandedPathsCache.clear();
+    }
+    /**
+     * Expand a search path that may contain {{ ... }} Liquid expressions into
+     * concrete directory prefixes by enumerating subdirectories at each dynamic
+     * segment. Static segments pass through unchanged.
+     *
+     * Results are cached per (rootUri, searchPath) and capped at 100 entries.
+     */
+    async expandDynamicPath(rootUri, searchPath) {
+        const segments = searchPath.split('/');
+        const basePaths = this.getSearchPaths('partial');
+        let prefixes = [''];
+        for (const segment of segments) {
+            if (!DocumentsLocator.LIQUID_EXPRESSION_RE.test(segment)) {
+                prefixes = prefixes.map((p) => (p ? `${p}/${segment}` : segment));
+                continue;
+            }
+            const nextPrefixes = [];
+            for (const prefix of prefixes) {
+                const subdirs = new Set();
+                for (const base of basePaths) {
+                    const dirUri = prefix
+                        ? vscode_uri_1.Utils.joinPath(rootUri, base, prefix).toString()
+                        : vscode_uri_1.Utils.joinPath(rootUri, base).toString();
+                    for (const name of await this.listSubdirectoryNames(dirUri)) {
+                        subdirs.add(name);
+                    }
+                }
+                for (const sub of subdirs) {
+                    nextPrefixes.push(prefix ? `${prefix}/${sub}` : sub);
+                    if (nextPrefixes.length >= 100)
+                        break;
+                }
+                if (nextPrefixes.length >= 100)
+                    break;
+            }
+            prefixes = nextPrefixes;
+        }
+        return prefixes;
+    }
+    /**
+     * Resolve a search path (static, dynamic, or empty) into concrete prefix
+     * strings. Cached for dynamic paths.
+     */
+    async resolveSearchPath(rootUri, searchPath) {
+        if (searchPath === '')
+            return [''];
+        if (!DocumentsLocator.LIQUID_EXPRESSION_RE.test(searchPath))
+            return [searchPath];
+        const cacheKey = `${rootUri.toString()}:${searchPath}`;
+        if (!this.expandedPathsCache.has(cacheKey)) {
+            this.expandedPathsCache.set(cacheKey, this.expandDynamicPath(rootUri, searchPath));
+        }
+        return this.expandedPathsCache.get(cacheKey);
+    }
+    /**
+     * Locate a partial using theme search paths (for theme_render_rc).
+     *
+     * Tries each search path prefix in priority order, then falls back to the
+     * unprefixed name (unless '' was already in the list, meaning the default
+     * position was explicitly placed).
+     */
+    async locateWithSearchPaths(rootUri, fileName, themeSearchPaths) {
+        for (const searchPath of themeSearchPaths) {
+            for (const prefix of await this.resolveSearchPath(rootUri, searchPath)) {
+                const candidate = prefix ? `${prefix}/${fileName}` : fileName;
+                const result = await this.locateFile(rootUri, candidate, 'partial');
+                if (result)
+                    return result;
+            }
+        }
+        if (!themeSearchPaths.includes('')) {
+            return this.locateFile(rootUri, fileName, 'partial');
+        }
+        return undefined;
+    }
+    async locate(rootUri, nodeName, fileName, themeSearchPaths) {
         switch (nodeName) {
             case 'render':
             case 'include':
             case 'function':
                 return this.locateFile(rootUri, fileName, 'partial');
+            case 'theme_render_rc':
+                return themeSearchPaths
+                    ? this.locateWithSearchPaths(rootUri, fileName, themeSearchPaths)
+                    : this.locateFile(rootUri, fileName, 'partial');
             case 'graphql':
                 return this.locateFile(rootUri, fileName, 'graphql');
             case 'asset':
@@ -119,6 +242,7 @@ class DocumentsLocator {
             case 'function':
             case 'render':
             case 'include':
+            case 'theme_render_rc':
                 return this.listFiles(rootUri, filePrefix, 'partial');
             case 'graphql':
                 return this.listFiles(rootUri, filePrefix, 'graphql');
@@ -130,4 +254,5 @@ class DocumentsLocator {
     }
 }
 exports.DocumentsLocator = DocumentsLocator;
+DocumentsLocator.LIQUID_EXPRESSION_RE = /\{\{.*?\}\}/;
 //# sourceMappingURL=DocumentsLocator.js.map

package/dist/documents-locator/DocumentsLocator.js.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentsLocator.js","sourceRoot":"","sources":["../../src/documents-locator/DocumentsLocator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DocumentsLocator.js","sourceRoot":"","sources":["../../src/documents-locator/DocumentsLocator.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './documents-locator/DocumentsLocator';
 export * from './translation-provider/TranslationProvider';
+export * from './route-table';
 export * from './AbstractFileSystem';
 export * from './path-utils';

package/dist/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./documents-locator/DocumentsLocator"), exports);
 __exportStar(require("./translation-provider/TranslationProvider"), exports);
+__exportStar(require("./route-table"), exports);
 __exportStar(require("./AbstractFileSystem"), exports);
 __exportStar(require("./path-utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uEAAqD;AACrD,6EAA2D;AAC3D,uDAAqC;AACrC,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uEAAqD;AACrD,6EAA2D;AAC3D,gDAA8B;AAC9B,uDAAqC;AACrC,+CAA6B"}

package/dist/route-table/RouteTable.d.ts

@@ -0,0 +1,45 @@
+import { URI } from 'vscode-uri';
+import { AbstractFileSystem } from '../AbstractFileSystem';
+import { RouteEntry } from './types';
+export declare class RouteTable {
+    private fs;
+    private routes;
+    private _built;
+    constructor(fs: AbstractFileSystem);
+    /** Returns true if build() has completed at least once. */
+    isBuilt(): boolean;
+    build(rootUri: URI): Promise<void>;
+    updateFile(uri: string, content: string): void;
+    removeFile(uri: string): void;
+    /**
+     * Find all routes matching a URL pattern and optional method.
+     * The pattern can contain `:_liquid_` segments for Liquid interpolations.
+     * Results are sorted by precedence (highest priority first = lowest number).
+     *
+     * A known format extension on the last segment (e.g., `/api/data.json`)
+     * is stripped and used to filter routes by format. When no format extension
+     * is present (e.g., `/about`), only `html` routes match — following the
+     * platformOS/Rails convention where HTML is the default format and non-HTML
+     * formats require an explicit extension or Accept header.
+     */
+    match(urlPattern: string, method?: string): RouteEntry[];
+    hasMatch(urlPattern: string, method?: string): boolean;
+    /** Returns the total number of route entries (including index aliases). */
+    routeCount(): number;
+    allRoutes(): RouteEntry[];
+    private matchEntry;
+    /**
+     * Try optional groups left-to-right greedily — matching Rails' ActionDispatch::Journey
+     * semantics. Each group is tried in order; if it matches, its segments are consumed
+     * and the next group is attempted. If it doesn't match, it's skipped (optional).
+     *
+     * This greedy approach is correct because the platformOS backend converts slugs like
+     * `search(/:country)(/:city)` into Journey path strings and Journey matches
+     * left-to-right without backtracking.
+     */
+    private matchOptionalGroups;
+    private addPageFromContent;
+    private discoverPageFiles;
+    private discoverModuleNames;
+    private walkDirectory;
+}