@platformos/platformos-check-common 0.0.2

package/dist/liquid-doc/arguments.js

@@ -0,0 +1,239 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportUnknownArguments = reportUnknownArguments;
+exports.reportMissingArguments = reportMissingArguments;
+exports.reportDuplicateArguments = reportDuplicateArguments;
+exports.findTypeMismatchParams = findTypeMismatchParams;
+exports.reportTypeMismatches = reportTypeMismatches;
+exports.generateTypeMismatchSuggestions = generateTypeMismatchSuggestions;
+exports.getBlockName = getBlockName;
+exports.getPartialName = getPartialName;
+exports.getLiquidDocParams = getLiquidDocParams;
+exports.makeRemoveArgumentCorrector = makeRemoveArgumentCorrector;
+exports.makeAddArgumentCorrector = makeAddArgumentCorrector;
+/**
+ * Helper methods shared between `render` tag and `content_for` tag to report
+ * errors when LiquidDoc exists
+ */
+const liquid_html_parser_1 = require("@platformos/liquid-html-parser");
+const utils_1 = require("./utils");
+const utils_2 = require("../checks/utils");
+/**
+ * Report error when unknown arguments are provided for `content_for` tag or `render` tag
+ */
+function reportUnknownArguments(context, node, unknownProvidedArgs, name) {
+    let errorOwnerMessage = '';
+    if (node.type === liquid_html_parser_1.NodeTypes.ContentForMarkup) {
+        errorOwnerMessage = ` in content_for tag for static block '${name}'`;
+    }
+    else if (node.type === liquid_html_parser_1.NodeTypes.RenderMarkup) {
+        errorOwnerMessage = ` in render tag for partial '${name}'`;
+    }
+    else if (node.type === liquid_html_parser_1.NodeTypes.FunctionMarkup) {
+        errorOwnerMessage = ` in function tag for partial '${name}'`;
+    }
+    for (const arg of unknownProvidedArgs) {
+        context.report({
+            message: `Unknown argument '${arg.name}'${errorOwnerMessage}.`,
+            startIndex: arg.position.start,
+            endIndex: arg.position.end,
+            suggest: [
+                {
+                    message: `Remove '${arg.name}'`,
+                    fix: makeRemoveArgumentCorrector(node, arg),
+                },
+            ],
+        });
+    }
+}
+/**
+ * Report error when missing arguments are provided for `content_for` tag or `render` tag
+ */
+function reportMissingArguments(context, node, missingRequiredArgs, name) {
+    let errorOwnerMessage = '';
+    if (node.type === liquid_html_parser_1.NodeTypes.ContentForMarkup) {
+        errorOwnerMessage = ` in content_for tag for static block '${name}'`;
+    }
+    else if (node.type === liquid_html_parser_1.NodeTypes.RenderMarkup) {
+        errorOwnerMessage = ` in render tag for partial '${name}'`;
+    }
+    else if (node.type === liquid_html_parser_1.NodeTypes.FunctionMarkup) {
+        errorOwnerMessage = ` in function tag for partial '${name}'`;
+    }
+    for (const arg of missingRequiredArgs) {
+        context.report({
+            message: `Missing required argument '${arg.name}'${errorOwnerMessage}.`,
+            startIndex: node.position.start,
+            endIndex: node.position.end,
+            suggest: [
+                {
+                    message: `Add required argument '${arg.name}'`,
+                    fix: makeAddArgumentCorrector(node, arg),
+                },
+            ],
+        });
+    }
+}
+function reportDuplicateArguments(context, node, duplicateArgs, name) {
+    let errorOwnerMessage = '';
+    if (node.type === liquid_html_parser_1.NodeTypes.ContentForMarkup) {
+        errorOwnerMessage = ` in content_for tag for static block '${name}'`;
+    }
+    else if (node.type === liquid_html_parser_1.NodeTypes.RenderMarkup) {
+        errorOwnerMessage = ` in render tag for partial '${name}'`;
+    }
+    else if (node.type === liquid_html_parser_1.NodeTypes.FunctionMarkup) {
+        errorOwnerMessage = ` in function tag for partial '${name}'`;
+    }
+    for (const arg of duplicateArgs) {
+        context.report({
+            message: `Duplicate argument '${arg.name}'${errorOwnerMessage}.`,
+            startIndex: arg.position.start,
+            endIndex: arg.position.end,
+            suggest: [
+                {
+                    message: `Remove duplicate argument '${arg.name}'`,
+                    fix: makeRemoveArgumentCorrector(node, arg),
+                },
+            ],
+        });
+    }
+}
+/**
+ * Find type mismatch between the arguments provided for `content_for` tag and `render` tag
+ * and their associated file's LiquidDoc
+ */
+function findTypeMismatchParams(liquidDocParameters, providedParams) {
+    const typeMismatchParams = [];
+    for (const arg of providedParams) {
+        if (arg.value.type === liquid_html_parser_1.NodeTypes.VariableLookup) {
+            continue;
+        }
+        const liquidDocParamDef = liquidDocParameters.get(arg.name);
+        if (liquidDocParamDef && liquidDocParamDef.type) {
+            const paramType = liquidDocParamDef.type.toLowerCase();
+            const supportedTypes = Object.keys(utils_1.BasicParamTypes).map((type) => type.toLowerCase());
+            if (!supportedTypes.includes(paramType)) {
+                continue;
+            }
+            if (!(0, utils_1.isTypeCompatible)(paramType, (0, utils_1.inferArgumentType)(arg.value))) {
+                typeMismatchParams.push(arg);
+            }
+        }
+    }
+    return typeMismatchParams;
+}
+/**
+ * Report error if the type mismatches between LiquidDoc and provided arguments
+ */
+function reportTypeMismatches(context, typeMismatchArgs, liquidDocParameters) {
+    for (const arg of typeMismatchArgs) {
+        const paramDef = liquidDocParameters.get(arg.name);
+        if (!paramDef || !paramDef.type)
+            continue;
+        const expectedType = paramDef.type.toLowerCase();
+        const actualType = (0, utils_1.inferArgumentType)(arg.value);
+        const suggestions = generateTypeMismatchSuggestions(expectedType, arg.value.position.start, arg.value.position.end);
+        context.report({
+            message: `Type mismatch for argument '${arg.name}': expected ${expectedType}, got ${actualType}`,
+            startIndex: arg.value.position.start,
+            endIndex: arg.value.position.end,
+            suggest: suggestions,
+        });
+    }
+}
+/**
+ * Generates suggestions for type mismatches based on the expected type and node positions
+ */
+function generateTypeMismatchSuggestions(expectedType, startPosition, endPosition) {
+    const defaultValue = (0, utils_1.getDefaultValueForType)(expectedType);
+    const suggestions = [];
+    // Only add the "replace with default" suggestion if the default is not an empty string
+    if (defaultValue !== '') {
+        suggestions.push({
+            message: `Replace with default value '${defaultValue}' for ${expectedType}`,
+            fix: (fixer) => {
+                return fixer.replace(startPosition, endPosition, defaultValue);
+            },
+        });
+    }
+    // Always include the "remove value" suggestion
+    suggestions.push({
+        message: `Remove value`,
+        fix: (fixer) => {
+            return fixer.remove(startPosition, endPosition);
+        },
+    });
+    return suggestions;
+}
+function isLastArg(node, arg) {
+    return (node.args.length == 1 || arg.position.start == node.args[node.args.length - 1].position.start);
+}
+function getBlockName(node) {
+    if (node.contentForType.value !== 'block') {
+        return;
+    }
+    const contentForTypeArg = node.args.find((arg) => arg.name == 'type')?.value;
+    if (!contentForTypeArg || !(0, utils_2.isLiquidString)(contentForTypeArg)) {
+        return;
+    }
+    return contentForTypeArg.value;
+}
+function getPartialName(node) {
+    if (node.type === liquid_html_parser_1.NodeTypes.RenderMarkup) {
+        if (!(0, utils_2.isLiquidString)(node.snippet)) {
+            return;
+        }
+        return node.snippet.value;
+    }
+    if (node.type === liquid_html_parser_1.NodeTypes.FunctionMarkup) {
+        if (!(0, utils_2.isLiquidString)(node.partial)) {
+            return;
+        }
+        return node.partial.value;
+    }
+}
+async function getLiquidDocParams(context, relativePath) {
+    const docDefinition = context.getDocDefinition && (await context.getDocDefinition(relativePath));
+    if (!docDefinition?.liquidDoc?.parameters) {
+        return;
+    }
+    return new Map(docDefinition.liquidDoc.parameters.map((p) => [p.name, p]));
+}
+function makeRemoveArgumentCorrector(node, arg) {
+    return (fixer) => {
+        const sourceBeforeArg = node.source.slice(node.position.start, arg.position.start);
+        const matches = sourceBeforeArg.match(/,\s*/g);
+        const lastCommaMatch = matches?.[matches.length - 1];
+        let startPos = lastCommaMatch
+            ? arg.position.start - (lastCommaMatch.length - 1)
+            : arg.position.start;
+        if (isLastArg(node, arg)) {
+            // Remove the leading comma if it's the last parameter
+            startPos -= 1;
+        }
+        const sourceAfterArg = node.source.substring(arg.position.end, node.position.end);
+        const trailingCommaMatch = sourceAfterArg.match(/\s*,/);
+        if (trailingCommaMatch) {
+            return fixer.remove(startPos, arg.position.end + trailingCommaMatch[0].length);
+        }
+        return fixer.remove(startPos, arg.position.end);
+    };
+}
+function makeAddArgumentCorrector(node, arg) {
+    return (fixer) => {
+        const paramToAdd = `, ${arg.name}: ${(0, utils_1.getDefaultValueForType)(arg.type)}`;
+        if (node.args.length == 0) {
+            return fixer.insert(node.position.end - 1, paramToAdd);
+        }
+        const lastArg = node.args[node.args.length - 1];
+        const sourceAfterLastArg = node.source.substring(lastArg.position.end, node.position.end);
+        const trailingCommaAndWhitespaceMatch = sourceAfterLastArg.match(/\s*,\s*/);
+        if (trailingCommaAndWhitespaceMatch) {
+            // IF there is already a trailing comma after the last arg, we want to find it and replace it with our own while stripping whitespace
+            return fixer.replace(lastArg.position.end, lastArg.position.end + trailingCommaAndWhitespaceMatch[0].length, `${paramToAdd} `);
+        }
+        return fixer.insert(lastArg.position.end, paramToAdd);
+    };
+}
+//# sourceMappingURL=arguments.js.map

package/dist/liquid-doc/arguments.js.map

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

package/dist/liquid-doc/liquidDoc.d.ts

@@ -0,0 +1,33 @@
+import { UriString } from '../types';
+import { LiquidHtmlNode } from '../types';
+export type GetDocDefinitionForURI = (uri: UriString, category: 'blocks' | 'app/views/partials', name: string) => Promise<DocDefinition | undefined>;
+export type DocDefinition = {
+    uri: UriString;
+    liquidDoc?: DocContent;
+};
+type DocContent = {
+    parameters?: LiquidDocParameter[];
+    examples?: LiquidDocExample[];
+    description?: LiquidDocDescription;
+};
+interface LiquidDocNode {
+    nodeType: 'param' | 'example' | 'description';
+}
+export interface LiquidDocParameter extends LiquidDocNode {
+    nodeType: 'param';
+    name: string;
+    description: string | null;
+    type: string | null;
+    required: boolean;
+}
+export interface LiquidDocExample extends LiquidDocNode {
+    content: string;
+    nodeType: 'example';
+}
+export interface LiquidDocDescription extends LiquidDocNode {
+    content: string;
+    nodeType: 'description';
+}
+export declare function hasLiquidDoc(partial: LiquidHtmlNode): Promise<boolean>;
+export declare function extractDocDefinition(uri: UriString, ast: LiquidHtmlNode): Promise<DocDefinition>;
+export {};

package/dist/liquid-doc/liquidDoc.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasLiquidDoc = hasLiquidDoc;
+exports.extractDocDefinition = extractDocDefinition;
+const visitor_1 = require("../visitor");
+async function hasLiquidDoc(partial) {
+    let foundDocTag = false;
+    await (0, visitor_1.visit)(partial, {
+        async LiquidRawTag(node) {
+            if (node.name === 'doc')
+                foundDocTag = true;
+        },
+    });
+    return foundDocTag;
+}
+async function extractDocDefinition(uri, ast) {
+    let hasDocTag = false;
+    const nodes = await (0, visitor_1.visit)(ast, {
+        async LiquidRawTag(node) {
+            if (node.name === 'doc')
+                hasDocTag = true;
+            return undefined;
+        },
+        async LiquidDocParamNode(node) {
+            return {
+                name: node.paramName.value,
+                description: node.paramDescription?.value ?? null,
+                type: node.paramType?.value ?? null,
+                required: node.required,
+                nodeType: 'param',
+            };
+        },
+        async LiquidDocExampleNode(node) {
+            return {
+                content: handleMultilineIndentation(node.content.value.trim()),
+                nodeType: 'example',
+            };
+        },
+        async LiquidDocDescriptionNode(node) {
+            return {
+                content: handleMultilineIndentation(node.content.value.trim()),
+                nodeType: 'description',
+            };
+        },
+    });
+    if (!hasDocTag)
+        return { uri };
+    const { parameters, examples, description } = nodes.reduce((acc, node) => {
+        if (node.nodeType === 'param') {
+            acc.parameters.push(node);
+        }
+        else if (node.nodeType === 'example') {
+            acc.examples.push(node);
+        }
+        else if (node.nodeType === 'description' && !acc.description) {
+            acc.description = node;
+        }
+        return acc;
+    }, {
+        parameters: [],
+        examples: [],
+        description: undefined,
+    });
+    return {
+        uri,
+        liquidDoc: {
+            ...(parameters.length && { parameters }),
+            ...(examples.length && { examples }),
+            ...(description && { description }),
+        },
+    };
+}
+function handleMultilineIndentation(text) {
+    const lines = text.split('\n');
+    if (lines.length <= 1)
+        return text;
+    const nonEmptyLines = lines.slice(1).filter((line) => line.trim().length > 0);
+    const indentLengths = nonEmptyLines.map((line) => {
+        const match = line.match(/^\s*/);
+        return match ? match[0].length : 0;
+    });
+    if (indentLengths.length === 0)
+        return text;
+    const minIndent = Math.min(...indentLengths);
+    return [
+        lines[0],
+        ...lines.slice(1).map((line) => {
+            if (line.trim().length === 0)
+                return line; // Skip empty lines
+            return line.slice(minIndent);
+        }),
+    ].join('\n');
+}
+//# sourceMappingURL=liquidDoc.js.map

package/dist/liquid-doc/liquidDoc.js.map

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

package/dist/liquid-doc/utils.d.ts

@@ -0,0 +1,49 @@
+import { LiquidExpression } from '@platformos/liquid-html-parser';
+import { ObjectEntry, UriString } from '../types';
+/**
+ * The base set of supported param types for LiquidDoc.
+ *
+ * This is used in conjunction with objects defined in [liquid docs](https://shopify.dev/docs/api/liquid/objects)
+ * to determine ALL supported param types for LiquidDoc.
+ *
+ * References `getValidParamTypes`
+ */
+export declare enum BasicParamTypes {
+    String = "string",
+    Number = "number",
+    Boolean = "boolean",
+    Object = "object"
+}
+export declare enum SupportedDocTagTypes {
+    Param = "param",
+    Example = "example",
+    Description = "description"
+}
+/**
+ * Provides a default completion value for an argument / parameter of a given type.
+ */
+export declare function getDefaultValueForType(type: string | null): "''" | "0" | "false" | "";
+/**
+ * Casts the value of a LiquidNamedArgument to a string representing the type of the value.
+ */
+export declare function inferArgumentType(arg: LiquidExpression): BasicParamTypes;
+/**
+ * Checks if the provided argument type is compatible with the expected type.
+ * Makes certain types more permissive:
+ * - Boolean accepts any value, since everything is truthy / falsy in Liquid
+ */
+export declare function isTypeCompatible(expectedType: string, actualType: BasicParamTypes): boolean;
+/**
+ * Checks if the provided file path supports the LiquidDoc tag.
+ */
+export declare function filePathSupportsLiquidDoc(uri: UriString): boolean;
+/**
+ * Dynamically generates a map of LiquidDoc param types using object entries from
+ * [liquid docs](https://shopify.dev/docs/api/liquid/objects).
+ *
+ * This is used in conjunction with the base set of supported param.
+ *
+ * References `BasicParamTypes`
+ */
+export declare function getValidParamTypes(objectEntries: ObjectEntry[]): Map<string, string | undefined>;
+export declare function parseParamType(validParamTypes: Set<string>, value: string): [pseudoType: string, isArray: boolean] | undefined;

package/dist/liquid-doc/utils.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupportedDocTagTypes = exports.BasicParamTypes = void 0;
+exports.getDefaultValueForType = getDefaultValueForType;
+exports.inferArgumentType = inferArgumentType;
+exports.isTypeCompatible = isTypeCompatible;
+exports.filePathSupportsLiquidDoc = filePathSupportsLiquidDoc;
+exports.getValidParamTypes = getValidParamTypes;
+exports.parseParamType = parseParamType;
+const liquid_html_parser_1 = require("@platformos/liquid-html-parser");
+const utils_1 = require("../utils");
+const to_schema_1 = require("../to-schema");
+const to_schema_2 = require("../to-schema");
+/**
+ * The base set of supported param types for LiquidDoc.
+ *
+ * This is used in conjunction with objects defined in [liquid docs](https://shopify.dev/docs/api/liquid/objects)
+ * to determine ALL supported param types for LiquidDoc.
+ *
+ * References `getValidParamTypes`
+ */
+var BasicParamTypes;
+(function (BasicParamTypes) {
+    BasicParamTypes["String"] = "string";
+    BasicParamTypes["Number"] = "number";
+    BasicParamTypes["Boolean"] = "boolean";
+    BasicParamTypes["Object"] = "object";
+})(BasicParamTypes || (exports.BasicParamTypes = BasicParamTypes = {}));
+var SupportedDocTagTypes;
+(function (SupportedDocTagTypes) {
+    SupportedDocTagTypes["Param"] = "param";
+    SupportedDocTagTypes["Example"] = "example";
+    SupportedDocTagTypes["Description"] = "description";
+})(SupportedDocTagTypes || (exports.SupportedDocTagTypes = SupportedDocTagTypes = {}));
+/**
+ * Provides a default completion value for an argument / parameter of a given type.
+ */
+function getDefaultValueForType(type) {
+    switch (type?.toLowerCase()) {
+        case BasicParamTypes.String:
+            return "''";
+        case BasicParamTypes.Number:
+            return '0';
+        case BasicParamTypes.Boolean:
+            return 'false';
+        case BasicParamTypes.Object: // Objects don't have a sensible default value (maybe `theme`?)
+        default:
+            return '';
+    }
+}
+/**
+ * Casts the value of a LiquidNamedArgument to a string representing the type of the value.
+ */
+function inferArgumentType(arg) {
+    switch (arg.type) {
+        case liquid_html_parser_1.NodeTypes.String:
+            return BasicParamTypes.String;
+        case liquid_html_parser_1.NodeTypes.Number:
+            return BasicParamTypes.Number;
+        case liquid_html_parser_1.NodeTypes.LiquidLiteral:
+            return BasicParamTypes.Boolean;
+        case liquid_html_parser_1.NodeTypes.Range:
+        case liquid_html_parser_1.NodeTypes.VariableLookup:
+            return BasicParamTypes.Object;
+        default:
+            // This ensures that we have a case for every possible type for arg.value
+            return (0, utils_1.assertNever)(arg);
+    }
+}
+/**
+ * Checks if the provided argument type is compatible with the expected type.
+ * Makes certain types more permissive:
+ * - Boolean accepts any value, since everything is truthy / falsy in Liquid
+ */
+function isTypeCompatible(expectedType, actualType) {
+    const normalizedExpectedType = expectedType.toLowerCase();
+    if (normalizedExpectedType === BasicParamTypes.Boolean) {
+        return true;
+    }
+    return normalizedExpectedType === actualType;
+}
+/**
+ * Checks if the provided file path supports the LiquidDoc tag.
+ */
+function filePathSupportsLiquidDoc(uri) {
+    return (0, to_schema_1.isSnippet)(uri) || (0, to_schema_2.isBlock)(uri);
+}
+/**
+ * Dynamically generates a map of LiquidDoc param types using object entries from
+ * [liquid docs](https://shopify.dev/docs/api/liquid/objects).
+ *
+ * This is used in conjunction with the base set of supported param.
+ *
+ * References `BasicParamTypes`
+ */
+function getValidParamTypes(objectEntries) {
+    const paramTypes = new Map([
+        [BasicParamTypes.String, undefined],
+        [BasicParamTypes.Number, undefined],
+        [BasicParamTypes.Boolean, undefined],
+        [
+            BasicParamTypes.Object,
+            'A generic type used to represent any liquid object or primitive value.',
+        ],
+    ]);
+    objectEntries.forEach((obj) => paramTypes.set(obj.name, obj.summary || obj.description));
+    return paramTypes;
+}
+function parseParamType(validParamTypes, value) {
+    const paramTypeMatch = value.match(/^([a-z_]+)(\[\])?$/);
+    if (!paramTypeMatch)
+        return undefined;
+    const extractedParamType = paramTypeMatch[1];
+    const isArrayType = !!paramTypeMatch[2];
+    if (!validParamTypes.has(extractedParamType))
+        return undefined;
+    return [extractedParamType, isArrayType];
+}
+//# sourceMappingURL=utils.js.map

package/dist/liquid-doc/utils.js.map

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

package/dist/path.d.ts

@@ -0,0 +1,10 @@
+import { RelativePath, UriString } from './types';
+import { URI, Utils } from 'vscode-uri';
+export { URI, Utils };
+export declare function relative(uri: UriString | URI, rootUri: UriString): RelativePath;
+export declare function join(rootUri: UriString | URI, ...paths: string[]): string;
+export declare function resolve(uri: UriString | URI, path: string): string;
+export declare function normalize(uri: UriString | URI): UriString;
+export declare function dirname(uri: UriString | URI): UriString;
+export declare function basename(uri: UriString | URI, ext?: string): string;
+export declare function fsPath(uri: UriString | URI): string;

package/dist/path.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Utils = exports.URI = void 0;
+exports.relative = relative;
+exports.join = join;
+exports.resolve = resolve;
+exports.normalize = normalize;
+exports.dirname = dirname;
+exports.basename = basename;
+exports.fsPath = fsPath;
+const vscode_uri_1 = require("vscode-uri");
+Object.defineProperty(exports, "URI", { enumerable: true, get: function () { return vscode_uri_1.URI; } });
+Object.defineProperty(exports, "Utils", { enumerable: true, get: function () { return vscode_uri_1.Utils; } });
+function relative(uri, rootUri) {
+    return normalize(uri)
+        .replace(rootUri, '')
+        .replace(/\\\\/g, '/') // We expect forward slash paths (windows path get normalized)
+        .replace(/^\/+/, '');
+}
+function join(rootUri, ...paths) {
+    return normalize(vscode_uri_1.Utils.joinPath(asUri(rootUri), ...paths));
+}
+function resolve(uri, path) {
+    return normalize(vscode_uri_1.Utils.resolvePath(asUri(uri), path));
+}
+function normalize(uri) {
+    const normalized = asUri(uri).toString(true);
+    // On Windows machines, paths use backslash ('\') as separator
+    // This causes issues since backslashes in glob patterns are treated as escape characters
+    // and in various URI contexts, forward slashes are expected
+    // We replace all backslashes with forward slashes for cross-platform consistency
+    return normalized.replace(/\\/g, '/');
+}
+function dirname(uri) {
+    return normalize(vscode_uri_1.Utils.dirname(asUri(uri)));
+}
+function basename(uri, ext) {
+    const base = vscode_uri_1.Utils.basename(asUri(uri));
+    return ext ? base.replace(new RegExp(`${ext.replace(/\./g, '\\.')}$`), '') : base;
+}
+function fsPath(uri) {
+    return asUri(uri).fsPath;
+}
+function asUri(uri) {
+    return vscode_uri_1.URI.isUri(uri) ? uri : vscode_uri_1.URI.parse(uri);
+}
+//# sourceMappingURL=path.js.map

package/dist/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../src/path.ts"],"names":[],"mappings":";;;AAKA,4BAKC;AAED,oBAEC;AAED,0BAEC;AAED,8BAOC;AAED,0BAEC;AAED,4BAGC;AAED,wBAEC;AAvCD,2CAAwC;AAE/B,oFAFA,gBAAG,OAEA;AAAE,sFAFA,kBAAK,OAEA;AAEnB,SAAgB,QAAQ,CAAC,GAAoB,EAAE,OAAkB;IAC/D,OAAO,SAAS,CAAC,GAAG,CAAC;SAClB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,8DAA8D;SACpF,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,SAAgB,IAAI,CAAC,OAAwB,EAAE,GAAG,KAAe;IAC/D,OAAO,SAAS,CAAC,kBAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,SAAgB,OAAO,CAAC,GAAoB,EAAE,IAAY;IACxD,OAAO,SAAS,CAAC,kBAAK,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,SAAgB,SAAS,CAAC,GAAoB;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,8DAA8D;IAC9D,yFAAyF;IACzF,4DAA4D;IAC5D,iFAAiF;IACjF,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,SAAgB,OAAO,CAAC,GAAoB;IAC1C,OAAO,SAAS,CAAC,kBAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,QAAQ,CAAC,GAAoB,EAAE,GAAY;IACzD,MAAM,IAAI,GAAG,kBAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED,SAAgB,MAAM,CAAC,GAAoB;IACzC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;AAC3B,CAAC;AAED,SAAS,KAAK,CAAC,GAAoB;IACjC,OAAO,gBAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC"}

package/dist/tags/content-for.d.ts

@@ -0,0 +1,3 @@
+export declare const RESERVED_CONTENT_FOR_ARGUMENTS: string[];
+export declare const REQUIRED_CONTENT_FOR_ARGUMENTS: string[];
+export declare const CLOSEST_ARGUMENT = "closest.";

package/dist/tags/content-for.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLOSEST_ARGUMENT = exports.REQUIRED_CONTENT_FOR_ARGUMENTS = exports.RESERVED_CONTENT_FOR_ARGUMENTS = void 0;
+exports.RESERVED_CONTENT_FOR_ARGUMENTS = [
+    'attributes',
+    'block',
+    'blocks',
+    'class',
+    'context',
+    'inherit',
+    'resource',
+    'resources',
+    'schema',
+    'section',
+    'sections',
+    'settings',
+    'snippet',
+    'snippets',
+    'src',
+    'style',
+    'styles',
+    'template',
+    'templates',
+];
+exports.REQUIRED_CONTENT_FOR_ARGUMENTS = ['id', 'type'];
+exports.CLOSEST_ARGUMENT = 'closest.';
+//# sourceMappingURL=content-for.js.map