npm - @jjlmoya/utils-games-development - Versions diffs - 1.65.0 → 1.67.0 - Mend

@jjlmoya/utils-games-development 1.65.0 → 1.67.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (77) hide show

package/package.json +67 -67
package/scripts/postinstall.mjs +27 -27
package/src/category/GamesCategorySEO.astro +19 -19
package/src/category/i18n/de.ts +15 -15
package/src/category/i18n/en.ts +15 -15
package/src/category/i18n/es.ts +15 -15
package/src/category/i18n/fr.ts +15 -15
package/src/category/i18n/id.ts +10 -10
package/src/category/i18n/it.ts +10 -10
package/src/category/i18n/ja.ts +10 -10
package/src/category/i18n/ko.ts +10 -10
package/src/category/i18n/nl.ts +10 -10
package/src/category/i18n/pl.ts +10 -10
package/src/category/i18n/pt.ts +10 -10
package/src/category/i18n/ru.ts +10 -10
package/src/category/i18n/sv.ts +10 -10
package/src/category/i18n/tr.ts +10 -10
package/src/category/i18n/zh.ts +10 -10
package/src/category/seo.astro +15 -15
package/src/components/PreviewNavSidebar.astro +116 -116
package/src/components/PreviewToolbar.astro +143 -143
package/src/data.ts +11 -11
package/src/env.d.ts +5 -5
package/src/index.ts +20 -20
package/src/layouts/PreviewLayout.astro +122 -122
package/src/pages/[locale]/[slug].astro +165 -165
package/src/pages/[locale].astro +250 -250
package/src/pages/index.astro +4 -4
package/src/tests/bibliography_wellformed_export.test.ts +46 -0
package/src/tests/category_seo_quality.test.ts +74 -0
package/src/tests/diacritics_density.test.ts +118 -118
package/src/tests/faq_count.test.ts +19 -19
package/src/tests/i18n_coverage.test.ts +36 -36
package/src/tests/inverted_punctuation.test.ts +84 -84
package/src/tests/mocks/astro_mock.js +2 -2
package/src/tests/no_en_dash.test.ts +70 -70
package/src/tests/no_h1_in_components.test.ts +48 -48
package/src/tests/pagespeed_best_practices.test.ts +198 -198
package/src/tests/qa-test-helpers.ts +32 -32
package/src/tests/qa_bibliography_links.test.ts +41 -41
package/src/tests/qa_claim_evidence.test.ts +69 -69
package/src/tests/qa_logic_reference_coverage.test.ts +46 -46
package/src/tests/qa_runtime_i18n.test.ts +100 -100
package/src/tests/schemas_fulfillment.test.ts +23 -23
package/src/tests/script_density.test.ts +94 -94
package/src/tests/seo_length.test.ts +23 -23
package/src/tests/seo_wellformed_export.test.ts +65 -0
package/src/tests/slug_language_code_format.test.ts +23 -23
package/src/tests/slug_uniqueness.test.ts +80 -80
package/src/tests/title_quality.test.ts +56 -56
package/src/tool/audioLoopPointFinder/audio-loop-point-finder.css +322 -322
package/src/tool/audioLoopPointFinder/client.ts +262 -262
package/src/tool/damageFormulaLab/bibliography.astro +3 -21
package/src/tool/damageFormulaLab/seo.astro +7 -5
package/src/tool/gameDeltaTimeFixedTimestepLab/bibliography.astro +3 -19
package/src/tool/hitboxHurtboxAnimator/hitbox-hurtbox-animator.css +614 -614
package/src/tool/hitboxHurtboxAnimator/seo.astro +7 -5
package/src/tool/saveFileEditor/component.astro +351 -351
package/src/tool/saveFileEditor/game-save-file-editor.css +250 -250
package/src/tool/spriteSheetPacker/app-client.ts +248 -248
package/src/tool/spriteSheetPacker/bibliography.ts +12 -12
package/src/tool/spriteSheetPacker/component.astro +229 -229
package/src/tool/spriteSheetPacker/dropzone-client.ts +55 -55
package/src/tool/spriteSheetPacker/entry.ts +28 -28
package/src/tool/spriteSheetPacker/exporter.ts +116 -116
package/src/tool/spriteSheetPacker/extractor-client.ts +127 -127
package/src/tool/spriteSheetPacker/flipbook-client.ts +60 -60
package/src/tool/spriteSheetPacker/logic.test.ts +155 -155
package/src/tool/spriteSheetPacker/logic.ts +32 -32
package/src/tool/spriteSheetPacker/packer-core.ts +121 -121
package/src/tool/spriteSheetPacker/packer-ui.ts +86 -86
package/src/tool/spriteSheetPacker/sprite-sheet-packer.css +578 -578
package/src/tool/spriteSheetPacker/types.ts +89 -89
package/src/tool/spriteSheetPacker/ui.ts +42 -42
package/src/tool/steamCapsuleGenerator/index.ts +9 -9
package/src/tool/steamCapsuleGenerator/validation.ts +14 -14
package/src/types.ts +72 -72

package/src/index.ts CHANGED Viewed

@@ -1,21 +1,21 @@
-export { gamesCategory } from './category';
-export const GamesCategorySEO = () => import('./category/GamesCategorySEO.astro').then((m) => m.default);
-export type {
-  KnownLocale,
-  FAQItem,
-  BibliographyEntry,
-  HowToStep,
-  ToolLocaleContent,
-  CategoryLocaleContent,
-  LocaleLoader,
-  LocaleMap,
-  GamesToolEntry,
-  GamesCategoryEntry,
-  ToolDefinition,
-} from './types';
-export { ALL_ENTRIES, ALL_TOOLS } from './tools';
+export { gamesCategory } from './category';
+export const GamesCategorySEO = () => import('./category/GamesCategorySEO.astro').then((m) => m.default);
+export type {
+  KnownLocale,
+  FAQItem,
+  BibliographyEntry,
+  HowToStep,
+  ToolLocaleContent,
+  CategoryLocaleContent,
+  LocaleLoader,
+  LocaleMap,
+  GamesToolEntry,
+  GamesCategoryEntry,
+  ToolDefinition,
+} from './types';
+export { ALL_ENTRIES, ALL_TOOLS } from './tools';
 export { STEAM_CAPSULE_GENERATOR_TOOL, steamCapsuleGenerator } from './tool/steamCapsuleGenerator';
 export { STEAM_BBCODE_TRANSLATOR_TOOL, steamBbcodeTranslator } from './tool/steamBbcodeTranslator';
 export { RETRO_SFX_GENERATOR_TOOL, retroSfxGenerator } from './tool/retroSfxGenerator';
@@ -23,5 +23,5 @@ export { PIXEL_ART_PALETTE_SWAPPER_TOOL, pixelArtPaletteSwapper } from './tool/p
 export { GAME_UI_ACCESSIBILITY_TESTER_TOOL, gameUiAccessibilityTester } from './tool/gameUIAccessibilityTester';
 export { HITBOX_HURTBOX_ANIMATOR_TOOL, hitboxHurtboxAnimator } from './tool/hitboxHurtboxAnimator';
 export { DAMAGE_FORMULA_LAB_TOOL, damageFormulaLab } from './tool/damageFormulaLab';
-export type { ToolLocaleContent as GamesToolLocaleContent } from './types';
+export type { ToolLocaleContent as GamesToolLocaleContent } from './types';

package/src/layouts/PreviewLayout.astro CHANGED Viewed

@@ -1,122 +1,122 @@
----
-import "@jjlmoya/utils-shared/theme.css";
-import PreviewToolbar from "../components/PreviewToolbar.astro";
-import type { KnownLocale } from "../types";
-interface Props {
-  title: string;
-  currentLocale?: KnownLocale;
-  localeUrls?: Partial<Record<KnownLocale, string>>;
-  hasSidebar?: boolean;
-}
-const {
-  title,
-  currentLocale = "es",
-  localeUrls = {},
-  hasSidebar = false,
-} = Astro.props;
----
-<!doctype html>
-<html lang={currentLocale}>
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width" />
-    <title>{title} · preview</title>
-    <link rel="preconnect" href="https://fonts.googleapis.com" />
-    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-    <link
-      href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800;900&display=swap"
-      rel="stylesheet"
-    />
-    <script is:inline>
-      (function () {
-        const saved = localStorage.getItem("theme") || "theme-dark";
-        document.documentElement.classList.add(saved);
-      })();
-    </script>
-    <slot name="head" />
-  </head>
-  <body>
-    <PreviewToolbar currentLocale={currentLocale} localeUrls={localeUrls} />
-    <div class:list={["page-wrapper", { "with-sidebar": hasSidebar }]}>
-      {
-        hasSidebar && (
-          <aside class="sidebar-area">
-            <slot name="sidebar" />
-          </aside>
-        )
-      }
-      <main>
-        <slot />
-      </main>
-    </div>
-  </body>
-</html>
-<style is:global>
-  :root {
-    --accent: #f43f5e;
-    --primary-base: #9f1239;
-    --cyan: #06b6d4;
-  }
-  .theme-dark,
-  .theme-light {
-    --text-main: var(--text-base);
-    --border-color: var(--border-base);
-  }
-  *,
-  *::before,
-  *::after {
-    box-sizing: border-box;
-  }
-  body {
-    background-color: var(--bg-page);
-    color: var(--text-base);
-    margin: 0;
-    min-height: 100vh;
-    transition:
-      background-color 0.3s ease,
-      color 0.3s ease;
-    font-family: Inter, sans-serif;
-  }
-  main {
-    padding: 0 2rem;
-  }
-  .page-wrapper {
-    display: flex;
-    flex-direction: column;
-  }
-  .page-wrapper.with-sidebar {
-    display: grid;
-    grid-template-columns: 240px 1fr;
-    min-height: 100vh;
-  }
-  .sidebar-area {
-    position: sticky;
-    top: 0;
-    height: 100vh;
-    overflow-y: auto;
-    border-right: 1px solid var(--border-color);
-    background: var(--bg-page);
-  }
-  @media (max-width: 768px) {
-    .page-wrapper.with-sidebar {
-      grid-template-columns: 1fr;
-    }
-    .sidebar-area {
-      display: none;
-    }
-  }
-</style>
+---
+import "@jjlmoya/utils-shared/theme.css";
+import PreviewToolbar from "../components/PreviewToolbar.astro";
+import type { KnownLocale } from "../types";
+interface Props {
+  title: string;
+  currentLocale?: KnownLocale;
+  localeUrls?: Partial<Record<KnownLocale, string>>;
+  hasSidebar?: boolean;
+}
+const {
+  title,
+  currentLocale = "es",
+  localeUrls = {},
+  hasSidebar = false,
+} = Astro.props;
+---
+<!doctype html>
+<html lang={currentLocale}>
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width" />
+    <title>{title} · preview</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800;900&display=swap"
+      rel="stylesheet"
+    />
+    <script is:inline>
+      (function () {
+        const saved = localStorage.getItem("theme") || "theme-dark";
+        document.documentElement.classList.add(saved);
+      })();
+    </script>
+    <slot name="head" />
+  </head>
+  <body>
+    <PreviewToolbar currentLocale={currentLocale} localeUrls={localeUrls} />
+    <div class:list={["page-wrapper", { "with-sidebar": hasSidebar }]}>
+      {
+        hasSidebar && (
+          <aside class="sidebar-area">
+            <slot name="sidebar" />
+          </aside>
+        )
+      }
+      <main>
+        <slot />
+      </main>
+    </div>
+  </body>
+</html>
+<style is:global>
+  :root {
+    --accent: #f43f5e;
+    --primary-base: #9f1239;
+    --cyan: #06b6d4;
+  }
+  .theme-dark,
+  .theme-light {
+    --text-main: var(--text-base);
+    --border-color: var(--border-base);
+  }
+  *,
+  *::before,
+  *::after {
+    box-sizing: border-box;
+  }
+  body {
+    background-color: var(--bg-page);
+    color: var(--text-base);
+    margin: 0;
+    min-height: 100vh;
+    transition:
+      background-color 0.3s ease,
+      color 0.3s ease;
+    font-family: Inter, sans-serif;
+  }
+  main {
+    padding: 0 2rem;
+  }
+  .page-wrapper {
+    display: flex;
+    flex-direction: column;
+  }
+  .page-wrapper.with-sidebar {
+    display: grid;
+    grid-template-columns: 240px 1fr;
+    min-height: 100vh;
+  }
+  .sidebar-area {
+    position: sticky;
+    top: 0;
+    height: 100vh;
+    overflow-y: auto;
+    border-right: 1px solid var(--border-color);
+    background: var(--bg-page);
+  }
+  @media (max-width: 768px) {
+    .page-wrapper.with-sidebar {
+      grid-template-columns: 1fr;
+    }
+    .sidebar-area {
+      display: none;
+    }
+  }
+</style>

package/src/pages/[locale]/[slug].astro CHANGED Viewed

@@ -1,165 +1,165 @@
----
-import PreviewLayout from "../../layouts/PreviewLayout.astro";
-import PreviewNavSidebar from "../../components/PreviewNavSidebar.astro";
-import { ALL_TOOLS } from "../../index";
-import {
-  UtilityHeader,
-  FAQSection,
-  Bibliography,
-  SEORenderer,
-} from "@jjlmoya/utils-shared";
-import type { KnownLocale, ToolLocaleContent } from "../../types";
-import type { UtilitySEOContent } from "@jjlmoya/utils-shared";
-import type { AstroComponentFactory } from "astro/runtime/server/index.js";
-export async function getStaticPaths() {
-  const paths = [];
-  for (const { entry, Component: lazyComp } of ALL_TOOLS) {
-    const { default: Component } = await (lazyComp as () => Promise<{ default: AstroComponentFactory }>)();
-    const localeEntries = Object.entries(entry.i18n) as [
-      KnownLocale,
-      () => Promise<ToolLocaleContent>,
-    ][];
-    const localeContents = await Promise.all(
-      localeEntries.map(async ([locale, loader]) => ({
-        locale,
-        content: await loader(),
-      })),
-    );
-    const localeUrls = Object.fromEntries(
-      localeContents.map(({ locale, content }) => [
-        locale,
-        `/${locale}/${content.slug}`,
-      ]),
-    ) as Partial<Record<KnownLocale, string>>;
-    const firstLoader = entry.i18n.en ?? Object.values(entry.i18n)[0];
-    const englishSlug = firstLoader ? (await firstLoader()).slug : entry.id;
-    for (const { locale, content } of localeContents) {
-      const allToolsNav = (
-        await Promise.all(
-          ALL_TOOLS.map(async ({ entry: navEntry }) => {
-            const loader = navEntry.i18n[locale] ?? navEntry.i18n.en;
-            if (!loader) return null;
-            const navContent = await loader();
-            return {
-              id: navEntry.id,
-              title: navContent.title,
-              href: `/${locale}/${navContent.slug}`,
-              isActive: navEntry.id === entry.id,
-            };
-          }),
-        )
-      ).filter(Boolean) as NavItem[];
-      paths.push({
-        params: { locale, slug: content.slug },
-        props: { Component, locale, content, localeUrls, allToolsNav, englishSlug },
-      });
-    }
-  }
-  return paths;
-}
-interface Props {
-  Component: AstroComponentFactory;
-  locale: KnownLocale;
-  content: ToolLocaleContent;
-  localeUrls: Partial<Record<KnownLocale, string>>;
-  allToolsNav: NavItem[];
-  englishSlug: string;
-}
-interface NavItem {
-  id: string;
-  title: string;
-  href: string;
-  isActive?: boolean;
-}
-const { Component, locale, content, localeUrls, allToolsNav, englishSlug } = Astro.props as Props;
-const cssFiles = import.meta.glob("../../tool/**/*.css", { query: "?raw", import: "default" });
-const cssKey = Object.keys(cssFiles).find((k) => k.endsWith(`/${englishSlug}.css`));
-const toolCssLoader = cssKey ? cssFiles[cssKey] : undefined;
-const toolCss = toolCssLoader ? await toolCssLoader() as string : "";
-const seoContent: UtilitySEOContent = { locale, sections: content.seo ?? [] };
-const words = content.title.split(" ");
-const titleHighlight = words[0] || "";
-const titleBase = words.slice(1).join(" ") || "";
----
-<PreviewLayout
-  title={content.title}
-  currentLocale={locale}
-  localeUrls={localeUrls}
-  hasSidebar={true}
->
-  <PreviewNavSidebar
-    slot="sidebar"
-    categoryTitle="Tools"
-    tools={allToolsNav}
-  />
-  <Fragment slot="head">
-    {toolCss && <style set:html={toolCss} />}
-    {
-      ( content.schemas ?? []).map((schema) => (
-        <script
-          is:inline
-          type="application/ld+json"
-          set:html={JSON.stringify(schema)}
-        />
-      ))
-    }
-  </Fragment>
-  <div class="tool-page">
-    <UtilityHeader
-      titleHighlight={titleHighlight}
-      titleBase={titleBase}
-      description={content.description}
-    />
-    <section class="section-tool">
-      <Component ui={content.ui} />
-    </section>
-    <section class="section-seo">
-      <SEORenderer content={seoContent} />
-    </section>
-    <section class="section-faq">
-      <FAQSection items={content.faq} />
-    </section>
-    <section class="section-bibliography">
-      <Bibliography links={content.bibliography} />
-    </section>
-  </div>
-</PreviewLayout>
-<style>
-  .tool-page {
-    display: flex;
-    flex-direction: column;
-    gap: 2rem;
-  }
-  .section-tool {
-    max-width: 1200px;
-    margin: 0 auto;
-    width: 100%;
-  }
-  .section-seo,
-  .section-faq,
-  .section-bibliography {
-    padding-top: 2rem;
-    border-top: 1px solid var(--border-color);
-  }
-</style>
+---
+import PreviewLayout from "../../layouts/PreviewLayout.astro";
+import PreviewNavSidebar from "../../components/PreviewNavSidebar.astro";
+import { ALL_TOOLS } from "../../index";
+import {
+  UtilityHeader,
+  FAQSection,
+  Bibliography,
+  SEORenderer,
+} from "@jjlmoya/utils-shared";
+import type { KnownLocale, ToolLocaleContent } from "../../types";
+import type { UtilitySEOContent } from "@jjlmoya/utils-shared";
+import type { AstroComponentFactory } from "astro/runtime/server/index.js";
+export async function getStaticPaths() {
+  const paths = [];
+  for (const { entry, Component: lazyComp } of ALL_TOOLS) {
+    const { default: Component } = await (lazyComp as () => Promise<{ default: AstroComponentFactory }>)();
+    const localeEntries = Object.entries(entry.i18n) as [
+      KnownLocale,
+      () => Promise<ToolLocaleContent>,
+    ][];
+    const localeContents = await Promise.all(
+      localeEntries.map(async ([locale, loader]) => ({
+        locale,
+        content: await loader(),
+      })),
+    );
+    const localeUrls = Object.fromEntries(
+      localeContents.map(({ locale, content }) => [
+        locale,
+        `/${locale}/${content.slug}`,
+      ]),
+    ) as Partial<Record<KnownLocale, string>>;
+    const firstLoader = entry.i18n.en ?? Object.values(entry.i18n)[0];
+    const englishSlug = firstLoader ? (await firstLoader()).slug : entry.id;
+    for (const { locale, content } of localeContents) {
+      const allToolsNav = (
+        await Promise.all(
+          ALL_TOOLS.map(async ({ entry: navEntry }) => {
+            const loader = navEntry.i18n[locale] ?? navEntry.i18n.en;
+            if (!loader) return null;
+            const navContent = await loader();
+            return {
+              id: navEntry.id,
+              title: navContent.title,
+              href: `/${locale}/${navContent.slug}`,
+              isActive: navEntry.id === entry.id,
+            };
+          }),
+        )
+      ).filter(Boolean) as NavItem[];
+      paths.push({
+        params: { locale, slug: content.slug },
+        props: { Component, locale, content, localeUrls, allToolsNav, englishSlug },
+      });
+    }
+  }
+  return paths;
+}
+interface Props {
+  Component: AstroComponentFactory;
+  locale: KnownLocale;
+  content: ToolLocaleContent;
+  localeUrls: Partial<Record<KnownLocale, string>>;
+  allToolsNav: NavItem[];
+  englishSlug: string;
+}
+interface NavItem {
+  id: string;
+  title: string;
+  href: string;
+  isActive?: boolean;
+}
+const { Component, locale, content, localeUrls, allToolsNav, englishSlug } = Astro.props as Props;
+const cssFiles = import.meta.glob("../../tool/**/*.css", { query: "?raw", import: "default" });
+const cssKey = Object.keys(cssFiles).find((k) => k.endsWith(`/${englishSlug}.css`));
+const toolCssLoader = cssKey ? cssFiles[cssKey] : undefined;
+const toolCss = toolCssLoader ? await toolCssLoader() as string : "";
+const seoContent: UtilitySEOContent = { locale, sections: content.seo ?? [] };
+const words = content.title.split(" ");
+const titleHighlight = words[0] || "";
+const titleBase = words.slice(1).join(" ") || "";
+---
+<PreviewLayout
+  title={content.title}
+  currentLocale={locale}
+  localeUrls={localeUrls}
+  hasSidebar={true}
+>
+  <PreviewNavSidebar
+    slot="sidebar"
+    categoryTitle="Tools"
+    tools={allToolsNav}
+  />
+  <Fragment slot="head">
+    {toolCss && <style set:html={toolCss} />}
+    {
+      ( content.schemas ?? []).map((schema) => (
+        <script
+          is:inline
+          type="application/ld+json"
+          set:html={JSON.stringify(schema)}
+        />
+      ))
+    }
+  </Fragment>
+  <div class="tool-page">
+    <UtilityHeader
+      titleHighlight={titleHighlight}
+      titleBase={titleBase}
+      description={content.description}
+    />
+    <section class="section-tool">
+      <Component ui={content.ui} />
+    </section>
+    <section class="section-seo">
+      <SEORenderer content={seoContent} />
+    </section>
+    <section class="section-faq">
+      <FAQSection items={content.faq} />
+    </section>
+    <section class="section-bibliography">
+      <Bibliography links={content.bibliography} />
+    </section>
+  </div>
+</PreviewLayout>
+<style>
+  .tool-page {
+    display: flex;
+    flex-direction: column;
+    gap: 2rem;
+  }
+  .section-tool {
+    max-width: 1200px;
+    margin: 0 auto;
+    width: 100%;
+  }
+  .section-seo,
+  .section-faq,
+  .section-bibliography {
+    padding-top: 2rem;
+    border-top: 1px solid var(--border-color);
+  }
+</style>