hbs-magic 0.1.0

package/dist/src/formatting-helpers.js

@@ -0,0 +1,63 @@
+import { execSync } from "node:child_process";
+import path from "path";
+import prettier from "prettier";
+import fs from "fs";
+const jsExtensions = [".ts", ".tsx", ".js", ".jsx"];
+export async function formatJsFileWithPrettier(sourcePath) {
+    const filePath = path.resolve(sourcePath);
+    const source = fs.readFileSync(filePath, "utf8");
+    const options = await prettier.resolveConfig(filePath);
+    const formatted = await prettier.format(source, {
+        ...options,
+        filepath: filePath,
+    });
+    if (formatted !== source) {
+        fs.writeFileSync(filePath, formatted, "utf8");
+    }
+}
+const csExtensions = [".cs"];
+function formatCsFileWithCSharpier(filePath) {
+    const resolved = path.resolve(filePath);
+    const toolDir = path.join(process.cwd(), ".csharpier");
+    if (!fs.existsSync(toolDir)) {
+        fs.mkdirSync(toolDir);
+        execSync("dotnet new tool-manifest", { cwd: toolDir, stdio: "ignore" });
+        execSync("dotnet tool install csharpier", {
+            cwd: toolDir,
+            stdio: "ignore",
+        });
+    }
+    execSync(`dotnet tool run csharpier format "${resolved}"`, {
+        cwd: toolDir,
+        stdio: "inherit",
+    });
+}
+var OutputFileType;
+(function (OutputFileType) {
+    OutputFileType[OutputFileType["JavaScript"] = 0] = "JavaScript";
+    OutputFileType[OutputFileType["Csharp"] = 1] = "Csharp";
+})(OutputFileType || (OutputFileType = {}));
+const outputFileTypeMap = {
+    [OutputFileType.JavaScript]: {
+        extensions: jsExtensions,
+        formatterFunc: formatJsFileWithPrettier,
+    },
+    [OutputFileType.Csharp]: {
+        extensions: csExtensions,
+        formatterFunc: formatCsFileWithCSharpier,
+    },
+};
+/*
+ * Detects the file type based on extension and formats it with the appropriate formatter.
+ * Currently supports JavaScript/TypeScript files with Prettier and C# files with CSharpier.
+ */
+export async function formatSourceFile(filePath) {
+    const ext = filePath.slice(filePath.lastIndexOf("."));
+    for (const formatter of Object.values(outputFileTypeMap)) {
+        if (formatter.extensions.includes(ext)) {
+            await formatter.formatterFunc(filePath);
+            return;
+        }
+    }
+    throw new Error(`Unsupported output file type: ${ext}`);
+}

package/dist/src/hbs-process-helpers.js

@@ -0,0 +1,22 @@
+import fs from "fs";
+import Handlebars from "handlebars";
+import { getDefaultExport } from "./file-helpers.js";
+export async function registerHbsHelpersFromFile(fullPath) {
+    const hbsHelpers = await getDefaultExport(fullPath);
+    for (const [name, value] of Object.entries(hbsHelpers)) {
+        if (typeof value === "function") {
+            Handlebars.registerHelper(name, value);
+        }
+    }
+}
+export async function registerHbsPartials(partials) {
+    for (const partial of partials) {
+        Handlebars.registerPartial(partial.name, partial.content);
+    }
+}
+export async function compileHbsTemplateAndWriteToFile(templatePath, inputObject, outputFilePath) {
+    const template = fs.readFileSync(templatePath, "utf8");
+    const compiled = Handlebars.compile(template);
+    const result = compiled(inputObject);
+    fs.writeFileSync(outputFilePath, result);
+}

package/dist/src/process-helpers.js

@@ -0,0 +1,50 @@
+import { hbsMagicCliUsage, hbsMagicHelp, inputDataNotFound, multipleSourcesDetected, positionalArgumentsNotAllowed, } from "./cli-messages.js";
+import { getJson } from "./file-helpers.js";
+export function extractArguments(process, required) {
+    const raw = process.argv.slice(2);
+    if (raw.length === 1 && raw[0] === "--help") {
+        console.log(hbsMagicHelp);
+        process.exit(1);
+    }
+    const args = {};
+    for (const arg of raw) {
+        if (arg.startsWith("--")) {
+            const [key, value] = arg.slice(2).split("=");
+            args[key] = value ?? true;
+        }
+        else {
+            throw new Error(positionalArgumentsNotAllowed);
+        }
+    }
+    for (const req of required) {
+        if (!(req in args)) {
+            console.error(`Missing required argument: --${req}`);
+            console.error(hbsMagicCliUsage);
+            process.exit(1);
+        }
+    }
+    return args;
+}
+export function extractFlag(process, flagName) {
+    const arg = process.argv.find((a) => a.startsWith(`--${flagName}`));
+    return !!arg;
+}
+export function extractArgument(process, argumentName) {
+    const arg = process.argv.find((a) => a.startsWith(`--${argumentName}=`));
+    return arg?.split("=")[1] ?? undefined;
+}
+export async function getInputObject(externalJson, preparationScriptResult, inputPath) {
+    if (!externalJson && !preparationScriptResult && !inputPath)
+        throw new Error(inputDataNotFound);
+    const sourcesCount = (externalJson ? 1 : 0) +
+        (preparationScriptResult ? 1 : 0) +
+        (inputPath ? 1 : 0);
+    if (sourcesCount > 1)
+        console.warn(multipleSourcesDetected);
+    if (externalJson)
+        return await getJson(externalJson);
+    if (preparationScriptResult)
+        return preparationScriptResult;
+    if (inputPath)
+        return await getJson(inputPath);
+}

package/examples/advanced_csharp-url-helpers/Result.gen.cs

@@ -0,0 +1,455 @@
+using System;
+using System.Collections.Generic;
+
+namespace ExampleProject.Common.FrontendUrlHelpers;
+
+//--------------------------------------------------------------------------------------------------------------
+// <auto-generated>
+//     This file was auto-generated by "hbs-magic" CLI.
+//     Do not modify this file manually. Instead, modify the template and regenerate the code.
+// </auto-generated>
+//--------------------------------------------------------------------------------------------------------------
+
+public static class Routes
+{
+    public static class Unauthorized
+    {
+        public static class Login
+        {
+            public static string Link(string siteUrl, LoginQueryParams queryParams) =>
+                siteUrl + "/login" + "?" + queryParams.GetQueryString();
+        }
+
+        public static class Register
+        {
+            public static string Link(string siteUrl, RegisterQueryParams queryParams) =>
+                siteUrl + "/register" + "?" + queryParams.GetQueryString();
+        }
+
+        public static class ConfirmEmail
+        {
+            public static string Link(string siteUrl, string userId, string token) =>
+                siteUrl
+                + "/confirm-email/:userId/:token"
+                    .Replace(":userId", userId.ToString())
+                    .Replace(":token", token.ToString());
+        }
+
+        public static class ForgotPassword
+        {
+            public static string Link(string siteUrl) => siteUrl + "/forgot-password";
+        }
+    }
+
+    public static class Authorized
+    {
+        public static class Dashboard
+        {
+            public static string Link(string siteUrl, DashboardQueryParams queryParams) =>
+                siteUrl + "/" + "?" + queryParams.GetQueryString();
+        }
+
+        public static class Profile
+        {
+            public static string Link(string siteUrl, int userId, string section) =>
+                siteUrl
+                + "/profile/:userId"
+                    .Replace(":userId", userId.ToString())
+                    .Replace(":section", section.ToString());
+        }
+
+        public static class Settings
+        {
+            public static string Link(string siteUrl, SettingsQueryParams queryParams) =>
+                siteUrl + "/settings" + "?" + queryParams.GetQueryString();
+        }
+
+        public static class Courses
+        {
+            public static string Link(string siteUrl, CoursesQueryParams queryParams) =>
+                siteUrl + "/courses" + "?" + queryParams.GetQueryString();
+        }
+
+        public static class CourseDetails
+        {
+            public static string Link(string siteUrl, int courseId, string tab) =>
+                siteUrl
+                + "/courses/:courseId"
+                    .Replace(":courseId", courseId.ToString())
+                    .Replace(":tab", tab.ToString());
+        }
+
+        public static class CourseNotFound
+        {
+            public static string Link(string siteUrl, int courseId) =>
+                siteUrl + "/courses/:courseId/not-found".Replace(":courseId", courseId.ToString());
+        }
+
+        public static class CourseAccessDenied
+        {
+            public static string Link(string siteUrl, int courseId) =>
+                siteUrl
+                + "/courses/:courseId/access-denied".Replace(":courseId", courseId.ToString());
+        }
+
+        public static class CourseStudents
+        {
+            public static string Link(string siteUrl, int courseId, int page, List<string> roles) =>
+                siteUrl
+                + "/courses/:courseId/students"
+                    .Replace(":courseId", courseId.ToString())
+                    .Replace(":page", page.ToString())
+                    .Replace(":roles", roles.ToString());
+        }
+
+        public static class AssignmentList
+        {
+            public static string Link(
+                string siteUrl,
+                int courseId,
+                string status,
+                string dueBefore
+            ) =>
+                siteUrl
+                + "/courses/:courseId/assignments"
+                    .Replace(":courseId", courseId.ToString())
+                    .Replace(":status", status.ToString())
+                    .Replace(":dueBefore", dueBefore.ToString());
+        }
+
+        public static class AssignmentDetails
+        {
+            public static string Link(string siteUrl, int courseId, int assignmentId, string tab) =>
+                siteUrl
+                + "/courses/:courseId/assignments/:assignmentId"
+                    .Replace(":courseId", courseId.ToString())
+                    .Replace(":assignmentId", assignmentId.ToString())
+                    .Replace(":tab", tab.ToString());
+        }
+
+        public static class AssignmentSubmissions
+        {
+            public static string Link(
+                string siteUrl,
+                int courseId,
+                int assignmentId,
+                int page,
+                List<string> userIds
+            ) =>
+                siteUrl
+                + "/courses/:courseId/assignments/:assignmentId/submissions"
+                    .Replace(":courseId", courseId.ToString())
+                    .Replace(":assignmentId", assignmentId.ToString())
+                    .Replace(":page", page.ToString())
+                    .Replace(":userIds", userIds.ToString());
+        }
+
+        public static class Announcements
+        {
+            public static string Link(string siteUrl, int courseId, int page) =>
+                siteUrl
+                + "/courses/:courseId/announcements"
+                    .Replace(":courseId", courseId.ToString())
+                    .Replace(":page", page.ToString());
+        }
+
+        public static class AnnouncementDetails
+        {
+            public static string Link(
+                string siteUrl,
+                int courseId,
+                int announcementId,
+                string highlight
+            ) =>
+                siteUrl
+                + "/courses/:courseId/announcements/:announcementId"
+                    .Replace(":courseId", courseId.ToString())
+                    .Replace(":announcementId", announcementId.ToString())
+                    .Replace(":highlight", highlight.ToString());
+        }
+
+        public static class Products
+        {
+            public static string Link(string siteUrl, ProductsQueryParams queryParams) =>
+                siteUrl + "/products" + "?" + queryParams.GetQueryString();
+        }
+
+        public static class ProductDetails
+        {
+            public static string Link(string siteUrl, int id) =>
+                siteUrl + "/products/:id".Replace(":id", id.ToString());
+        }
+
+        public static class CreateProduct
+        {
+            public static string Link(string siteUrl, CreateProductQueryParams queryParams) =>
+                siteUrl + "/products/create" + "?" + queryParams.GetQueryString();
+        }
+
+        public static class EditProduct
+        {
+            public static string Link(string siteUrl, int id, string mode) =>
+                siteUrl
+                + "/products/:id/edit"
+                    .Replace(":id", id.ToString())
+                    .Replace(":mode", mode.ToString());
+        }
+
+        public static class Admin
+        {
+            public static string Link(string siteUrl, AdminQueryParams queryParams) =>
+                siteUrl + "/admin" + "?" + queryParams.GetQueryString();
+        }
+
+        public static class AdminUsers
+        {
+            public static string Link(string siteUrl, AdminUsersQueryParams queryParams) =>
+                siteUrl + "/admin/users" + "?" + queryParams.GetQueryString();
+        }
+
+        public static class AdminUserDetails
+        {
+            public static string Link(string siteUrl, int userId, string tab) =>
+                siteUrl
+                + "/admin/users/:userId"
+                    .Replace(":userId", userId.ToString())
+                    .Replace(":tab", tab.ToString());
+        }
+
+        public static class Notifications
+        {
+            public static string Link(string siteUrl, NotificationsQueryParams queryParams) =>
+                siteUrl + "/notifications" + "?" + queryParams.GetQueryString();
+        }
+
+        public static class Search
+        {
+            public static string Link(string siteUrl, SearchQueryParams queryParams) =>
+                siteUrl + "/search" + "?" + queryParams.GetQueryString();
+        }
+
+        public static class UiKit
+        {
+            public static string Link(string siteUrl, UiKitQueryParams queryParams) =>
+                siteUrl + "/uikit" + "?" + queryParams.GetQueryString();
+        }
+    }
+}
+
+public interface IRouteQueryParams
+{
+    public string GetQueryString();
+}
+
+public class LoginQueryParams : IRouteQueryParams
+{
+    public string? Redirect { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (!string.IsNullOrEmpty(Redirect))
+            queryParams.Add($"redirect={Redirect}");
+
+        return string.Join("&", queryParams);
+    }
+}
+
+public class RegisterQueryParams : IRouteQueryParams
+{
+    public string? Ref { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (!string.IsNullOrEmpty(Ref))
+            queryParams.Add($"ref={Ref}");
+
+        return string.Join("&", queryParams);
+    }
+}
+
+public class DashboardQueryParams : IRouteQueryParams
+{
+    public string? Tab { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (!string.IsNullOrEmpty(Tab))
+            queryParams.Add($"tab={Tab}");
+
+        return string.Join("&", queryParams);
+    }
+}
+
+public class SettingsQueryParams : IRouteQueryParams
+{
+    public string? Page { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (!string.IsNullOrEmpty(Page))
+            queryParams.Add($"page={Page}");
+
+        return string.Join("&", queryParams);
+    }
+}
+
+public class CoursesQueryParams : IRouteQueryParams
+{
+    public int? Page { get; init; }
+    public int? PageSize { get; init; }
+    public string? Search { get; init; }
+    public List<string>? Tags { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (Page != null)
+            queryParams.Add($"page={Page.Value}");
+        if (PageSize != null)
+            queryParams.Add($"pageSize={PageSize.Value}");
+        if (!string.IsNullOrEmpty(Search))
+            queryParams.Add($"search={Search}");
+        if (Tags is { Count: > 0 })
+            queryParams.Add($"tags={string.Join(",", Tags)}");
+
+        return string.Join("&", queryParams);
+    }
+}
+
+public class ProductsQueryParams : IRouteQueryParams
+{
+    public int? Page { get; init; }
+    public int? PageSize { get; init; }
+    public string? SortBy { get; init; }
+    public List<string>? Categories { get; init; }
+    public int? MinPrice { get; init; }
+    public int? MaxPrice { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (Page != null)
+            queryParams.Add($"page={Page.Value}");
+        if (PageSize != null)
+            queryParams.Add($"pageSize={PageSize.Value}");
+        if (!string.IsNullOrEmpty(SortBy))
+            queryParams.Add($"sortBy={SortBy}");
+        if (Categories is { Count: > 0 })
+            queryParams.Add($"categories={string.Join(",", Categories)}");
+        if (MinPrice != null)
+            queryParams.Add($"minPrice={MinPrice.Value}");
+        if (MaxPrice != null)
+            queryParams.Add($"maxPrice={MaxPrice.Value}");
+
+        return string.Join("&", queryParams);
+    }
+}
+
+public class CreateProductQueryParams : IRouteQueryParams
+{
+    public int? TemplateId { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (TemplateId != null)
+            queryParams.Add($"templateId={TemplateId.Value}");
+
+        return string.Join("&", queryParams);
+    }
+}
+
+public class AdminQueryParams : IRouteQueryParams
+{
+    public string? Tab { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (!string.IsNullOrEmpty(Tab))
+            queryParams.Add($"tab={Tab}");
+
+        return string.Join("&", queryParams);
+    }
+}
+
+public class AdminUsersQueryParams : IRouteQueryParams
+{
+    public int? Page { get; init; }
+    public List<string>? Roles { get; init; }
+    public string? Search { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (Page != null)
+            queryParams.Add($"page={Page.Value}");
+        if (Roles is { Count: > 0 })
+            queryParams.Add($"roles={string.Join(",", Roles)}");
+        if (!string.IsNullOrEmpty(Search))
+            queryParams.Add($"search={Search}");
+
+        return string.Join("&", queryParams);
+    }
+}
+
+public class NotificationsQueryParams : IRouteQueryParams
+{
+    public bool? UnreadOnly { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (UnreadOnly != null)
+            queryParams.Add($"unreadOnly={UnreadOnly.Value}");
+
+        return string.Join("&", queryParams);
+    }
+}
+
+public class SearchQueryParams : IRouteQueryParams
+{
+    public List<string>? Types { get; init; }
+    public int? Page { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (Types is { Count: > 0 })
+            queryParams.Add($"types={string.Join(",", Types)}");
+        if (Page != null)
+            queryParams.Add($"page={Page.Value}");
+
+        return string.Join("&", queryParams);
+    }
+}
+
+public class UiKitQueryParams : IRouteQueryParams
+{
+    public string? Component { get; init; }
+
+    public string GetQueryString()
+    {
+        var queryParams = new List<string>();
+
+        if (!string.IsNullOrEmpty(Component))
+            queryParams.Add($"component={Component}");
+
+        return string.Join("&", queryParams);
+    }
+}