@tomako/tools-runtime 0.1.0

package/src/features/tools/social-profile-kit/widget/types.ts

@@ -0,0 +1,104 @@
+import type {
+    SocialProfileInput,
+    SocialProfileInputMode,
+    SocialProfileMode,
+    SocialProfilePlatform,
+    SocialProfileTargetMarket,
+    SocialProfileTone,
+} from "../../../../lib/tools/social-profile-kit.schema";
+
+export type SelectedProfileElement =
+  | { kind: "avatar"; device?: ProfilePreviewDevice }
+  | { kind: "banner"; device?: ProfilePreviewDevice }
+  | {
+      kind: "text";
+      field: "displayName" | "username" | "bio" | "headline" | "description";
+    };
+
+export type EditableTextField = Extract<
+  SelectedProfileElement,
+  { kind: "text" }
+>["field"];
+
+export type ProfilePreviewDevice = "desktop" | "mobile";
+
+export type EditingProfileText = {
+  field: EditableTextField;
+  device: ProfilePreviewDevice;
+} | null;
+
+export type SocialProfileKitCopy = {
+  title: string;
+  subtitle: string;
+  modes: Record<SocialProfileMode, string>;
+  inputModes: Record<SocialProfileInputMode, string>;
+  fields: {
+    name: string;
+    namePlaceholder: string;
+    positioning: string;
+    positioningPlaceholder: string;
+    audience: string;
+    audiencePlaceholder: string;
+    targetMarket: string;
+    tone: string;
+    brandAsset: string;
+    brandAssetHint: string;
+    brandAssetEmpty: string;
+    brandAssetRemove: string;
+    prompt: string;
+    promptPlaceholder: string;
+  };
+  tones: Record<SocialProfileTone, string>;
+  targetMarkets: Record<SocialProfileTargetMarket, string>;
+  platforms: Record<SocialProfilePlatform, string>;
+  actions: Record<
+    | "generate"
+    | "generating"
+    | "regenerate"
+    | "copy"
+    | "copied"
+    | "edit"
+    | "done"
+    | "upload"
+    | "download"
+    | "downloadKit"
+    | "replaceColor"
+    | "downloadAll"
+    | "allPlatforms"
+    | "fullKit"
+    | "currentPlatform"
+    | "follow"
+    | "message",
+    string
+  >;
+  canvas: Record<
+    | "desktop"
+    | "mobile"
+    | "light"
+    | "dark"
+    | "zoomIn"
+    | "zoomOut"
+    | "fit"
+    | "selected"
+    | "unsupportedBanner",
+    string
+  >;
+  elements: Record<EditableTextField | "avatar" | "banner", string>;
+  status: Record<
+    | "defaultReady"
+    | "generated"
+    | "validationError"
+    | "idle"
+    | "queued"
+    | "generating"
+    | "ready"
+    | "failed",
+    string
+  >;
+  sections: Record<
+    "whatYouGet" | "sizes" | "howItWorks" | "relatedTools" | "faq",
+    string
+  >;
+};
+
+export type SocialProfileKitFormState = SocialProfileInput;

package/src/features/tools/spec-registry.ts

@@ -0,0 +1,158 @@
+import { withResolvedLocales } from "../../lib/tools/resolve-tool-locale-copy";
+
+import { appIconResizerSpec } from "./app-icon-resizer/app-icon-resizer.spec";
+import { appStoreScreenshotGeneratorSpec } from "./app-store-screenshot-generator/app-store-screenshot-generator.spec";
+import { buildInPublicStoryGeneratorSpec } from "./build-in-public-story-generator/build-in-public-story-generator.spec";
+import { coldStartChannelSelectorSpec } from "./cold-start-channel-selector/cold-start-channel-selector.spec";
+import { commercialBpGeneratorSpec } from "./commercial-bp-generator/commercial-bp-generator.spec";
+import { communityFeedbackInboxSpec } from "./community-feedback-inbox/community-feedback-inbox.spec";
+import { communityPainPointExtractorSpec } from "./community-pain-point-extractor/community-pain-point-extractor.spec";
+import { communityPostRiskCheckerPackage } from "./community-post-risk-checker/community-post-risk-checker.package";
+import { competitorAnalysisSpec } from "./competitor-analysis/competitor-analysis.spec";
+import { disclaimerGeneratorPackage } from "./disclaimer-generator/disclaimer-generator.package";
+import { emailTemplateGeneratorSpec } from "./email-template-generator/email-template-generator.spec";
+import { gtmReadinessChecklistSpec } from "./gtm-readiness-checklist/gtm-readiness-checklist.spec";
+import { investorMatchingPlannerPackage } from "./investor-matching-planner/investor-matching-planner.package";
+import { kokoCodexAssistantSpec } from "./koko-codex-assistant/koko-codex-assistant.spec";
+import { logoGeneratorSpec } from "./logo-generator/logo-generator.spec";
+import { marketForecastReportSpec } from "./market-forecast-report/market-forecast-report.spec";
+import { millionUserGrowthTestSpec } from "./million-user-growth-test/million-user-growth-test.spec";
+import { ogImageGeneratorSpec } from "./og-image-generator/og-image-generator.spec";
+import { createPackageToolSpec } from "./package/to-tool-spec";
+import { pitchDeckGeneratorSpec } from "./pitch-deck-generator/pitch-deck-generator.spec";
+import { productAgreementGeneratorSpec } from "./product-agreement-generator/product-agreement-generator.spec";
+import { productHuntLaunchPlannerSpec } from "./product-hunt-launch-planner/product-hunt-launch-planner.spec";
+import { productNameGeneratorSpec } from "./product-name-generator/product-name-generator.spec";
+import { productPositioningAnalyzerPackage } from "./product-positioning-analyzer/product-positioning-analyzer.package";
+import { productPosterGeneratorSpec } from "./product-poster-generator/product-poster-generator.spec";
+import { productUiGeneratorSpec } from "./product-ui-generator/product-ui-generator.spec";
+import { redditPainPointFinderSpec } from "./reddit-pain-point-finder/reddit-pain-point-finder.spec";
+import { sloganGeneratorPackage } from "./slogan-generator/slogan-generator.package";
+import { socialListeningResearchReportSpec } from "./social-listening-research-report/social-listening-research-report.spec";
+import { socialPlatformAssetAdapterSpec } from "./social-platform-asset-adapter/social-platform-asset-adapter.spec";
+import { socialProfileKitSpec } from "./social-profile-kit/social-profile-kit.spec";
+import { startupIdeaResearchSpec } from "./startup-idea-research/startup-idea-research.spec";
+import { tarotReadingSpec } from "./tarot-reading/tarot-reading.spec";
+import { twitterGifDownloaderSpec } from "./twitter-gif-downloader/twitter-gif-downloader.spec";
+import type { ToolSpec } from "./types";
+import { userInterviewGuideGeneratorPackage } from "./user-interview-guide-generator/user-interview-guide-generator.package";
+import { userInterviewInsightReportGeneratorSpec } from "./user-interview-insight-report-generator/user-interview-insight-report-generator.spec";
+import { userInterviewRecordGeneratorSpec } from "./user-interview-record-generator/user-interview-record-generator.spec";
+import { utmBuilderPackage } from "./utm-builder/utm-builder.package";
+
+const toolSpecs: ToolSpec[] = [
+  appIconResizerSpec,
+  gtmReadinessChecklistSpec,
+  productNameGeneratorSpec,
+  productPosterGeneratorSpec,
+  millionUserGrowthTestSpec,
+  marketForecastReportSpec,
+  productUiGeneratorSpec,
+  appStoreScreenshotGeneratorSpec,
+  buildInPublicStoryGeneratorSpec,
+  ogImageGeneratorSpec,
+  coldStartChannelSelectorSpec,
+  tarotReadingSpec,
+  productAgreementGeneratorSpec,
+  productHuntLaunchPlannerSpec,
+  emailTemplateGeneratorSpec,
+  commercialBpGeneratorSpec,
+  pitchDeckGeneratorSpec,
+  competitorAnalysisSpec,
+  communityFeedbackInboxSpec,
+  startupIdeaResearchSpec,
+  communityPainPointExtractorSpec,
+  redditPainPointFinderSpec,
+  socialListeningResearchReportSpec,
+  twitterGifDownloaderSpec,
+  kokoCodexAssistantSpec,
+  logoGeneratorSpec,
+  socialProfileKitSpec,
+  socialPlatformAssetAdapterSpec,
+  createPackageToolSpec(userInterviewGuideGeneratorPackage),
+  createPackageToolSpec(utmBuilderPackage),
+  createPackageToolSpec(sloganGeneratorPackage),
+  createPackageToolSpec(investorMatchingPlannerPackage),
+  createPackageToolSpec(disclaimerGeneratorPackage),
+  createPackageToolSpec(productPositioningAnalyzerPackage),
+  createPackageToolSpec(communityPostRiskCheckerPackage),
+  userInterviewRecordGeneratorSpec,
+  userInterviewInsightReportGeneratorSpec,
+];
+
+const toolSlugAliases: Record<string, string> = {
+  "ai-product-poster-generator": "product-poster-generator",
+  "app-name-generator": "product-name-generator",
+  "app-store-icon-resizer": "app-icon-resizer",
+  "app-icon-slicer": "app-icon-resizer",
+  "brand-name-finder": "product-name-generator",
+  "build-in-public-feedback-organizer": "community-feedback-inbox",
+  "build-in-public-generator": "build-in-public-story-generator",
+  "build-in-public-post-generator": "build-in-public-story-generator",
+  "build-in-public-twitter-generator": "build-in-public-story-generator",
+  "blog-featured-image-generator": "og-image-generator",
+  "business-bp-generator": "commercial-bp-generator",
+  "business-plan-generator": "commercial-bp-generator",
+  "business-plan-image-generator": "commercial-bp-generator",
+  "community-post-checker": "community-post-risk-checker",
+  "arr-forecast-calculator": "market-forecast-report",
+  "investor-pitch-deck-generator": "pitch-deck-generator",
+  "market-size-forecast": "market-forecast-report",
+  "startup-market-forecast": "market-forecast-report",
+  "tam-sam-som-calculator": "market-forecast-report",
+  "fundraising-deck-generator": "pitch-deck-generator",
+  "startup-pitch-deck-generator": "pitch-deck-generator",
+  "google-play-icon-resizer": "app-icon-resizer",
+  "html-email-generator": "email-template-generator",
+  "mjml-email-template-generator": "email-template-generator",
+  "legal-policy-generator": "product-agreement-generator",
+  "million-user-test": "million-user-growth-test",
+  "one-million-user-test": "million-user-growth-test",
+  "open-graph-image-generator": "og-image-generator",
+  "product-growth-test": "million-user-growth-test",
+  "product-promo-poster-generator": "product-poster-generator",
+  "ai-app-interface-generator": "product-ui-generator",
+  "ai-product-interface-generator": "product-ui-generator",
+  "ai-product-ui-generator": "product-ui-generator",
+  "product-naming-generator": "product-name-generator",
+  "ui-prompt-generator": "product-ui-generator",
+  "reddit-product-feedback-analyzer": "community-feedback-inbox",
+  "reddit-post-review-tool": "community-post-risk-checker",
+  "reddit-self-promotion-checker": "community-post-risk-checker",
+  "reddit-user-research-tool": "reddit-pain-point-finder",
+  "reddit-analysis-tool": "social-listening-research-report",
+  "reddit-market-research-tool": "social-listening-research-report",
+  "saas-name-generator": "product-name-generator",
+  "saas-reddit-post-checker": "community-post-risk-checker",
+  "saas-poster-generator": "product-poster-generator",
+  "startup-idea-validation-reddit": "reddit-pain-point-finder",
+  "social-media-asset-adapter": "social-platform-asset-adapter",
+  "social-media-content-adapter": "social-platform-asset-adapter",
+  "social-profile-kit": "social-media-profile-generator",
+  "twitter-header-image-generator": "og-image-generator",
+  "x-header-image-generator": "og-image-generator",
+  "social-media-research-tool": "social-listening-research-report",
+  "social-listening-report": "social-listening-research-report",
+  "twitter-research-tool": "social-listening-research-report",
+  "x-analysis-tool": "social-listening-research-report",
+};
+
+export function resolveToolSlug(slug: string): string {
+  return toolSlugAliases[slug] ?? slug;
+}
+
+export function getToolSpec(slug: string): ToolSpec | undefined {
+  const resolvedSlug = resolveToolSlug(slug);
+  return toolSpecs.find((spec) => spec.slug === resolvedSlug);
+}
+
+export function listToolSpecs(): ToolSpec[] {
+  return toolSpecs;
+}
+
+export function listToolSpecsForMcp(): Array<{ slug: string; spec: ToolSpec }> {
+  return toolSpecs.map((spec) => ({
+    slug: spec.slug,
+    spec: withResolvedLocales(spec),
+  }));
+}

package/src/features/tools/startup-idea-research/startup-idea-research.container.tsx

@@ -0,0 +1,111 @@
+import { createToolGuideTranslator } from "../shared/tool-message-translator";
+import { StartupIdeaResearch } from "./widget";
+
+import {
+    ToolDividedFaqList,
+    ToolDividedRows,
+    ToolPlainTextGrid,
+    ToolSectionEyebrow,
+    type ToolFaqItem,
+} from "../shared/tool-content-sections";
+import { ToolCta } from "../shared/tool-cta";
+import { ToolImageVisual, ToolWorkspaceSection } from "../shared/tool-guide-section";
+import { ToolPageShell } from "../shared/tool-page-shell";
+import type { ToolPageProps } from "../types";
+
+export async function StartupIdeaResearchContainer({ locale, spec }: ToolPageProps) {
+  const t = await createToolGuideTranslator(
+    locale,
+    "toolsPages.startupIdeaResearch.guide",
+  );
+
+  const values = t.raw("valueItems") as readonly string[];
+  const standards = t.raw("standardItems") as readonly string[];
+  const guidance = t.raw("resultGuidanceItems") as readonly string[];
+  const faqItems = t.raw("faqItems") as readonly ToolFaqItem[];
+
+  return (
+    <ToolPageShell
+      locale={locale}
+      spec={spec}
+      heroVariant="showcase"
+      heroVisual={
+        <ToolImageVisual
+          src="/tools/startup-idea-research-hero.webp"
+          alt={t("visualAlt.hero")}
+          priority
+          wide
+        />
+      }
+    >
+      <ToolWorkspaceSection
+        heading={t("workspaceHeading")}
+        hint={t("workspaceHint")}
+        badge={t("workspaceBadge")}
+      >
+        <div className="grid gap-8 xl:grid-cols-[1fr_0.42fr] xl:items-start">
+          <StartupIdeaResearch />
+          <ToolImageVisual
+            src="/tools/startup-idea-research-hero.webp"
+            alt={t("visualAlt.workspace")}
+          />
+        </div>
+      </ToolWorkspaceSection>
+
+      <section className="border-t border-[#E8E4DB] py-12 md:py-16">
+        <ToolSectionEyebrow>{t("valueKicker")}</ToolSectionEyebrow>
+        <h2 className="mt-3 text-3xl font-semibold leading-tight text-[#111111] md:text-4xl">
+          {t("valueTitle")}
+        </h2>
+        <div className="mt-7">
+          <ToolPlainTextGrid items={values} columns="four" />
+        </div>
+      </section>
+
+      <section className="grid gap-8 border-t border-[#E8E4DB] py-12 md:grid-cols-[0.95fr_1.05fr] md:items-center md:py-16">
+        <div>
+          <ToolSectionEyebrow>{t("standardKicker")}</ToolSectionEyebrow>
+          <h2 className="mt-3 text-3xl font-semibold leading-tight text-[#111111] md:text-4xl">
+            {t("standardTitle")}
+          </h2>
+          <div className="mt-5">
+            <ToolDividedRows items={standards} />
+          </div>
+        </div>
+        <ToolImageVisual src="/tools/startup-idea-research-hero.webp" alt={t("visualAlt.value")} />
+      </section>
+
+      <section className="grid gap-8 border-t border-[#E8E4DB] py-12 md:grid-cols-[1.05fr_0.95fr] md:items-center md:py-16">
+        <ToolImageVisual src="/tools/startup-idea-research-hero.webp" alt={t("visualAlt.support")} />
+        <div>
+          <ToolSectionEyebrow>{t("resultKicker")}</ToolSectionEyebrow>
+          <h2 className="mt-3 text-3xl font-semibold leading-tight text-[#111111] md:text-4xl">
+            {t("resultTitle")}
+          </h2>
+          <div className="mt-5">
+            <ToolDividedRows items={guidance} />
+          </div>
+        </div>
+      </section>
+
+      <section className="grid gap-8 border-t border-[#E8E4DB] py-12 md:grid-cols-[1fr_0.75fr] md:items-start md:py-16">
+        <div>
+          <ToolSectionEyebrow>{t("faqKicker")}</ToolSectionEyebrow>
+          <h2 className="mt-3 text-3xl font-semibold leading-tight text-[#111111] md:text-4xl">
+            {t("faqTitle")}
+          </h2>
+          <div className="mt-5">
+            <ToolDividedFaqList items={faqItems} />
+          </div>
+        </div>
+        <ToolImageVisual src="/tools/startup-idea-research-hero.webp" alt={t("visualAlt.useCase")} />
+      </section>
+
+      <ToolCta
+        hint={t("ctaHint")}
+        primary={{ href: "/tools/competitor-analysis", label: t("ctaPrimary") }}
+        secondary={{ href: "/tools", label: t("ctaSecondary") }}
+      />
+    </ToolPageShell>
+  );
+}

package/src/features/tools/startup-idea-research/startup-idea-research.spec.ts

@@ -0,0 +1,15 @@
+import type { ToolSpec } from "../types";
+
+export const startupIdeaResearchSpec: ToolSpec = {
+  slug: "startup-idea-research",
+  toolType: "analyzer",
+  riskLevel: "medium",
+  seo: {
+    "publishedAt": "2026-06-30",
+    "updatedAt": "2026-06-30",
+    "readingTime": "8 min",
+    "featured": false,
+    "ogImage": "/tools/startup-idea-research-hero.webp"
+  },
+  widget: {"id":"startup-idea-research","mode":"custom"},
+};

package/src/features/tools/startup-idea-research/widget/constants.ts

@@ -0,0 +1,11 @@
+import type { StartupIdeaSignalStrength } from "../../../../lib/tools/startup-idea-research-schema";
+
+export const GRACE_WINDOW_MS = 480_000;
+export const RESULT_RETRY_INTERVAL_MS = 1200;
+export const RESULT_RETRY_WINDOW_MS = 15_000;
+
+export const SIGNAL_STYLE: Record<StartupIdeaSignalStrength, string> = {
+  strong: "border-[#A7E0B5] bg-[#F0FAF2] text-[#166534]",
+  mixed: "border-[#F1D48B] bg-[#FFF8E1] text-[#854D0E]",
+  weak: "border-[#D7DCE3] bg-[#F4F5F7] text-[#626A73]",
+};

package/src/features/tools/startup-idea-research/widget/index.ts

@@ -0,0 +1,7 @@
+"use client";
+
+import dynamic from "next/dynamic";
+
+export const StartupIdeaResearch = dynamic(() =>
+  import("./startup-idea-research").then((module) => module.StartupIdeaResearch),
+);

package/src/features/tools/startup-idea-research/widget/preview-panels.tsx

@@ -0,0 +1,67 @@
+"use client";
+
+import {
+    Loader2,
+    RefreshCw,
+    Search
+} from "lucide-react";
+
+import { Button } from "@tomako/ui/button";
+
+
+export function EmptyPanel({ title, hint }: { title: string; hint: string }) {
+  return (
+    <div className="flex min-h-[30rem] flex-col items-center justify-center rounded-[1.5rem] border border-dashed border-[#D7DCE3] bg-[#FAFBFC] p-8 text-center">
+      <span className="flex size-12 items-center justify-center rounded-full bg-[#F1F2F4] text-[#111111]">
+        <Search className="size-6" aria-hidden />
+      </span>
+      <p className="mt-4 text-base font-semibold text-[#111111]">{title}</p>
+      <p className="mt-2 max-w-md text-sm leading-6 text-[#777777]">{hint}</p>
+    </div>
+  );
+}
+
+export function RunningPanel({
+  title,
+  hint,
+  statusLabel,
+}: {
+  title: string;
+  hint: string;
+  statusLabel: string;
+}) {
+  return (
+    <div className="flex min-h-[30rem] flex-col items-center justify-center rounded-[1.5rem] border border-[#E2E6EC] bg-white p-8 text-center shadow-[0_14px_38px_rgba(17,17,17,0.05)]">
+      <span className="flex size-12 items-center justify-center rounded-full bg-[#F1F2F4] text-[#111111]">
+        <Loader2 className="size-6 animate-spin" aria-hidden />
+      </span>
+      <p className="mt-4 text-base font-semibold text-[#111111]">{title}</p>
+      <p className="mt-2 max-w-md text-sm leading-6 text-[#777777]">{hint}</p>
+      {statusLabel ? (
+        <span className="mt-4 rounded-full bg-[#F2F5F9] px-3 py-1 text-xs font-semibold text-[#55708A]">
+          {statusLabel}
+        </span>
+      ) : null}
+    </div>
+  );
+}
+
+export function ErrorPanel({
+  message,
+  retryLabel,
+  onRetry,
+}: {
+  message: string;
+  retryLabel: string;
+  onRetry: () => void;
+}) {
+  return (
+    <div className="flex min-h-[30rem] flex-col items-center justify-center rounded-[1.5rem] border border-[#F3D2C9] bg-[#FFF6F2] p-8 text-center">
+      <p className="max-w-sm text-sm leading-6 text-[#9A3412]">{message}</p>
+      <Button variant="outline" className="mt-5" onClick={onRetry}>
+        <RefreshCw className="size-4" aria-hidden />
+        {retryLabel}
+      </Button>
+    </div>
+  );
+}