@cieloazul310/jclub-financial-utils 0.0.1-alpha.0

package/src/data/dictionary.json

@@ -0,0 +1,71 @@
+{
+  "name": "クラブ",
+  "fullname": "呼称",
+  "id": "id",
+  "year": "年",
+  "category": "所属",
+  "license": "ライセンス",
+  "revenue": "営業収入",
+  "sponsor": "スポンサー収入",
+  "ticket": "入場料収入",
+  "broadcast": "Jリーグ配分金",
+  "academy_rev": "アカデミー関連収入",
+  "women_rev": "女子チーム関連収入",
+  "goods_rev": "物販収入",
+  "transfer_rev": "移籍補償金等収入",
+  "transfer_int_rev": "国外クラブからの収入",
+  "transfer_dom_rev": "国内クラブからの収入",
+  "other_revs": "その他収入",
+  "expense": "営業費用",
+  "salary": "チーム人件費",
+  "transfer_exp": "移籍関連費用",
+  "transfer_int_exp": "国外クラブからの移籍に関する費用",
+  "transfer_dom_exp": "国内クラブからの移籍に関する費用",
+  "manage_exp": "事業費",
+  "general_exp": "総事業費",
+  "game_exp": "試合関連経費",
+  "team_exp": "トップチーム運営経費",
+  "academy_exp": "アカデミー運営経費",
+  "women_exp": "女子チーム運営経費",
+  "goods_exp": "物販関連費",
+  "other_cost": "その他売上原価",
+  "sga": "販売費および一般管理費",
+  "op_profit": "営業利益",
+  "no_rev": "営業外収益",
+  "no_exp": "営業外費用",
+  "ordinary_profit": "経常利益",
+  "sp_rev": "特別利益",
+  "sp_exp": "特別損失",
+  "profit_before_tax": "税引前当期利益",
+  "related_revenue": "関連する法人の営業収入",
+  "tax": "法人税および住民税等",
+  "profit": "当期純利益",
+  "curr_assets": "流動資産",
+  "fixed_assets": "固定資産等",
+  "assets": "総資産(資産の部)",
+  "curr_liabilities": "流動負債",
+  "fixed_liabilities": "固定負債",
+  "liabilities": "総負債(負債の部)",
+  "capital_stock": "資本金",
+  "capital_surplus": "資本剰余金等",
+  "retained_earnings": "利益剰余金",
+  "net_worth": "純資産(純資産の部)",
+  "rank": "順位",
+  "points": "勝ち点",
+  "ppg": "PPG",
+  "elevation": "昇降格",
+  "league_attd": "リーグ戦入場者数",
+  "league_games": "リーグ戦ホーム試合数",
+  "leaguecup_attd": "リーグカップ入場者数",
+  "leaguecup_games": "リーグカップホーム試合数",
+  "po_attd": "PO入場者数",
+  "po_games": "POホーム試合数",
+  "acl_attd": "ACL入場者数",
+  "acl_games": "ACLホーム試合数",
+  "second_attd": "セカンドチーム入場者数",
+  "second_games": "セカンドチームホーム試合数",
+  "all_attd": "年間総入場者数",
+  "all_games": "年間ホーム試合数",
+  "average_attd": "リーグ戦平均入場者数",
+  "unit_price": "客単価"
+}

package/src/data/years.json

@@ -0,0 +1,173 @@
+[
+  {
+    "id": "2005",
+    "year": 2005,
+    "categories": [
+      "J1",
+      "J2"
+    ]
+  },
+  {
+    "id": "2006",
+    "year": 2006,
+    "categories": [
+      "J1",
+      "J2"
+    ]
+  },
+  {
+    "id": "2007",
+    "year": 2007,
+    "categories": [
+      "J1",
+      "J2"
+    ]
+  },
+  {
+    "id": "2008",
+    "year": 2008,
+    "categories": [
+      "J1",
+      "J2"
+    ]
+  },
+  {
+    "id": "2009",
+    "year": 2009,
+    "categories": [
+      "J1",
+      "J2"
+    ]
+  },
+  {
+    "id": "2010",
+    "year": 2010,
+    "categories": [
+      "J1",
+      "J2"
+    ]
+  },
+  {
+    "id": "2011",
+    "year": 2011,
+    "categories": [
+      "J1",
+      "J2"
+    ]
+  },
+  {
+    "id": "2012",
+    "year": 2012,
+    "categories": [
+      "J1",
+      "J2"
+    ]
+  },
+  {
+    "id": "2013",
+    "year": 2013,
+    "categories": [
+      "J1",
+      "J2"
+    ]
+  },
+  {
+    "id": "2014",
+    "year": 2014,
+    "categories": [
+      "J1",
+      "J2",
+      "J3"
+    ]
+  },
+  {
+    "id": "2015",
+    "year": 2015,
+    "categories": [
+      "J1",
+      "J2",
+      "J3"
+    ]
+  },
+  {
+    "id": "2016",
+    "year": 2016,
+    "categories": [
+      "J1",
+      "J2",
+      "J3"
+    ]
+  },
+  {
+    "id": "2017",
+    "year": 2017,
+    "categories": [
+      "J1",
+      "J2",
+      "J3"
+    ]
+  },
+  {
+    "id": "2018",
+    "year": 2018,
+    "categories": [
+      "J1",
+      "J2",
+      "J3"
+    ]
+  },
+  {
+    "id": "2019",
+    "year": 2019,
+    "categories": [
+      "J1",
+      "J2",
+      "J3"
+    ]
+  },
+  {
+    "id": "2020",
+    "year": 2020,
+    "categories": [
+      "J1",
+      "J2",
+      "J3"
+    ]
+  },
+  {
+    "id": "2021",
+    "year": 2021,
+    "categories": [
+      "J1",
+      "J2",
+      "J3"
+    ]
+  },
+  {
+    "id": "2022",
+    "year": 2022,
+    "categories": [
+      "J1",
+      "J2",
+      "J3"
+    ]
+  },
+  {
+    "id": "2023",
+    "year": 2023,
+    "categories": [
+      "J1",
+      "J2",
+      "J3"
+    ]
+  },
+  {
+    "id": "2024",
+    "year": 2024,
+    "categories": [
+      "J1",
+      "J2",
+      "J3"
+    ]
+  }
+]

package/src/dictionary.ts

@@ -0,0 +1,39 @@
+import type { FinancialDatum } from "./types";
+import dictionary from "./data/dictionary.json";
+
+const has = Object.prototype.hasOwnProperty;
+
+function isDirectoryKey(
+  key: string,
+): key is keyof Omit<FinancialDatum, "slug"> {
+  return has.call(dictionary, key);
+}
+
+/**
+ * プロパティ名から日本語ラベルを取得する
+ * @param key FinancialDatum のプロパティ名
+ * @returns 日本語ラベル。未定義のキーの場合はキー名をそのまま返す
+ */
+export function getLabel(key: string): string {
+  if (isDirectoryKey(key)) return dictionary[key];
+  return key;
+}
+
+/**
+ * プロパティ名から日本語ラベルを取得する（オプションつき）
+ * @param key FinancialDatum のプロパティ名
+ * @param options fallback や後処理のオプション
+ * @returns 日本語ラベル
+ */
+export function getLabelWithOptions(
+  key: keyof Omit<FinancialDatum, "slug">,
+  options?: {
+    /** キーが未定義の場合のフォールバック。省略時はキー名を返す */
+    fallback?: string;
+    /** ラベルに対する後処理 */
+    transform?: (label: string) => string;
+  },
+): string {
+  const label = dictionary[key] ?? options?.fallback ?? key;
+  return options?.transform ? options.transform(label) : label;
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from "./all-fields";
+export * from "./clubs";
+export * from "./dictionary";
+export * from "./years";
+export * from "./types";

package/src/types/club.ts

@@ -0,0 +1,16 @@
+export type ClubInfo = {
+  id: string;
+  slug: string;
+  name: string;
+  fullname: string;
+  short_name: string;
+  company: string;
+  category: string;
+  hometown: string;
+  area?: string | null;
+  period: number;
+  website: string | null;
+  settlement?: string | null;
+  relatedCompanies?: string[] | null;
+  annotation?: string[] | null;
+};

package/src/types/data.ts

@@ -0,0 +1,161 @@
+export type General = {
+  id: string;
+  name: string;
+  slug: string;
+  fullname: string;
+  year: number;
+  category: string;
+  license: string | null;
+};
+export type SeasonResult = {
+  rank: number;
+  points: number;
+  ppg: number;
+  elevation: "昇格" | "降格" | null;
+};
+export type PL = {
+  /** 営業収入 */
+  revenue: number;
+  /** 営業費用 */
+  expense: number;
+  /** 営業利益 */
+  op_profit: number;
+  /** 営業外収入 */
+  no_rev: number | null;
+  /** 営業外費用 */
+  no_exp: number | null;
+  /** 経常利益 */
+  ordinary_profit: number;
+  /** 特別利益 */
+  sp_rev: number | null;
+  /** 特別損失 */
+  sp_exp: number | null;
+  /** 税引前当期利益 */
+  profit_before_tax: number | null;
+  /** 法人税および住民税等 */
+  tax: number | null;
+  /** 当期純利益 */
+  profit: number;
+  /** 関連する法人の営業収入 */
+  related_revenue: number | null;
+};
+export type BS = {
+  /** 流動資産 */
+  curr_assets: number | null;
+  /** 固定資産等 */
+  fixed_assets: number | null;
+  /** 総資産 */
+  assets: number | null;
+  /** 流動負債 */
+  curr_liabilities: number | null;
+  /** 固定負債 */
+  fixed_liabilities: number | null;
+  /** 総負債 */
+  liabilities: number | null;
+  /** 純資産 */
+  net_worth: number | null;
+  /** 資本金 */
+  capital_stock: number | null;
+  /** 資本剰余金 */
+  capital_surplus: number | null;
+  /** 利益剰余金 */
+  retained_earnings: number | null;
+  /** 当期純利益 */
+  profit: number;
+};
+export type Revenue = {
+  /** 営業収入 */
+  revenue: number;
+  /** 広告料収入 */
+  sponsor: number | null;
+  /** 入場料収入 */
+  ticket: number | null;
+  /** Jリーグ配分金 */
+  broadcast: number | null;
+  /** アカデミー関連収入 */
+  academy_rev: number | null;
+  /** 女子チーム関連収入 */
+  women_rev: number | null;
+  /** 物販収入 */
+  goods_rev: number | null;
+  /** 移籍補償金等収入 */
+  transfer_rev: number | null;
+  /** 国外クラブからの収入 */
+  transfer_int_rev: number | null;
+  /** 国内クラブからの収入 */
+  transfer_dom_rev: number | null;
+  /** その他収入 */
+  other_revs: number | null;
+  /** 関連する法人の営業収入 */
+  related_revenue: number | null;
+};
+export type Expense = {
+  /** 営業費用 */
+  expense: number;
+  /** チーム人件費 */
+  salary: number | null;
+  /** 移籍関連費用 */
+  transfer_exp: number | null;
+  /** 国外クラブからの移籍に関する費用 */
+  transfer_int_exp: number | null;
+  /** 国内クラブからの移籍に関する費用 */
+  transfer_dom_exp: number | null;
+  /** 事業費 */
+  manage_exp: number | null;
+  /** 総事業費 */
+  general_exp: number | null;
+  /** 試合関連経費 */
+  game_exp: number | null;
+  /** トップチーム運営経費 */
+  team_exp: number | null;
+  /** アカデミー関連経費 */
+  academy_exp: number | null;
+  /** 女子チーム運営経費 */
+  women_exp: number | null;
+  /** 物販関連費 */
+  goods_exp: number | null;
+  /** その他売上原価 */
+  other_cost: number | null;
+  /** 販売費および一般管理費 */
+  sga: number | null;
+};
+export type Attd = {
+  /** 入場料収入 */
+  ticket: number | null;
+  /** リーグ戦入場者数 */
+  league_attd: number;
+  /** リーグ戦ホーム試合数 */
+  league_games: number;
+  /** リーグカップ入場者数 */
+  leaguecup_attd: number | null;
+  /** リーグカップホーム試合数 */
+  leaguecup_games: number | null;
+  /** PO入場者数 */
+  po_attd: number | null;
+  /** POホーム試合数 */
+  po_games: number | null;
+  /** ACL入場者数 */
+  acl_attd: number | null;
+  /** ACLホーム試合数 */
+  acl_games: number | null;
+  /** セカンドチーム入場者数 */
+  second_attd: number | null;
+  /** セカンドチームホーム試合数 */
+  second_games: number | null;
+  /** 総入場者数 */
+  all_attd: number;
+  /** ホーム総試合数 */
+  all_games: number;
+  /** リーグ戦平均入場者数 */
+  average_attd: number;
+  /** 客単価 */
+  unit_price: number | null;
+};
+
+export type FinancialDatum = General &
+  SeasonResult &
+  PL &
+  BS &
+  Revenue &
+  Expense &
+  Attd;

package/src/types/index.ts

@@ -0,0 +1,3 @@
+export * from "./club";
+export * from "./data";
+export * from "./year";

package/src/types/year.ts

@@ -0,0 +1,5 @@
+export type YearInfo = {
+  id: string;
+  year: number;
+  categories: ("J1" | "J2" | "J3")[];
+};

package/src/years.ts

@@ -0,0 +1,6 @@
+import type { YearInfo } from "./types";
+import years from "./data/years.json";
+
+export function getAllYears() {
+  return years as YearInfo[];
+}

package/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "@repo/typescript-config/base.json",
+  "include": ["scripts", "src", "tsdown.config.ts", "__tests__"]
+}

package/tsdown.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  entry: ["src/*", "src/types/*"],
+  format: {
+    esm: {
+      target: ["esnext"],
+    },
+    cjs: {
+      target: ["node22"],
+    },
+  },
+  clean: true,
+  dts: true,
+});

package/years.yml

@@ -0,0 +1,111 @@
+- id: "2005"
+  year: 2005
+  categories: 
+    - J1
+    - J2
+- id: "2006"
+  year: 2006
+  categories: 
+    - J1
+    - J2
+- id: "2007"
+  year: 2007
+  categories: 
+    - J1
+    - J2
+- id: "2008"
+  year: 2008
+  categories: 
+    - J1
+    - J2
+- id: "2009"
+  year: 2009
+  categories: 
+    - J1
+    - J2
+- id: "2010"
+  year: 2010
+  categories: 
+    - J1
+    - J2
+- id: "2011"
+  year: 2011
+  categories: 
+    - J1
+    - J2
+- id: "2012"
+  year: 2012
+  categories: 
+    - J1
+    - J2
+- id: "2013"
+  year: 2013
+  categories: 
+    - J1
+    - J2
+- id: "2014"
+  year: 2014
+  categories: 
+    - J1
+    - J2
+    - J3
+- id: "2015"
+  year: 2015
+  categories: 
+    - J1
+    - J2
+    - J3
+- id: "2016"
+  year: 2016
+  categories: 
+    - J1
+    - J2
+    - J3
+- id: "2017"
+  year: 2017
+  categories: 
+    - J1
+    - J2
+    - J3
+- id: "2018"
+  year: 2018
+  categories: 
+    - J1
+    - J2
+    - J3
+- id: "2019"
+  year: 2019
+  categories: 
+    - J1
+    - J2
+    - J3
+- id: "2020"
+  year: 2020
+  categories: 
+    - J1
+    - J2
+    - J3
+- id: "2021"
+  year: 2021
+  categories: 
+    - J1
+    - J2
+    - J3
+- id: "2022"
+  year: 2022
+  categories: 
+    - J1
+    - J2
+    - J3
+- id: "2023"
+  year: 2023
+  categories:
+    - J1
+    - J2
+    - J3
+- id: "2024"
+  year: 2024
+  categories:
+    - J1
+    - J2
+    - J3