================================================================================
  TinCLE (Tiny C Lovely Engine) Version 0.14 -- Chuuko --

                                    Copyright (C) 2026 michyo (Michiyo Tagami)
                                    Created with General Assistant: Gyaru Sono
================================================================================

* Overview

  TinCLE is an ultra-lightweight 2D game framework optimized for AI-driven
  development (Vibe Coding / One-Shot code generation) and programming beginners.
  It supports a dynamic hybrid ecosystem targeting both Windows Desktop (TCC)
  and Web Browser (WASM/Emscripten) platforms.

* Package Contents

  The "32bit" and "64bit" folders contain the following set of files tailored
  for each target environment:

  - 32bit folder: For Windows 32bit + Web (WASM) 32bit targets.
  - 64bit folder: For Windows 64bit + Web (WASM) 32bit targets.

  Please choose the appropriate folder based on your development needs. Unless
  there are specific circumstances, we highly recommend using the "32bit"
  environment. This ensures that the bit size of the native executable matches
  that of the WebAssembly, promoting the smoothest debugging and development
  process.

  tincle.dll         ... Core game engine binary (Windows target).
  SDL2.dll           ... SDL Dynamic Link Library.
  SDL2_gfx.dll       ... SDL2_gfx Dynamic Link Library.
  SDL2_ttf.dll       ... SDL_ttf Dynamic Link Library.
  CREDITS.txt        ... Detailed open-source licensing and third-party
                         information.

  SKILL.md           ... Talent Chip for automated code generation.
  SKILL_ADD1.md      ... Talent Chip for high level game creation.
  SKILL_ADD2.md      ... Talent Chip for releasing and human tools.
  SKILL_AON1.md      ... Talent Chip for add-on DLLs.
  SKILL_AON2.md      ... Talent Chip for add-on DLLs.
  SKILL_FB.md        ... Talent Chip for creating sound effects.
  SKILL_PT.md        ... Talent Chip for composing music.
  SKILL_PN.md        ... Talent Chip for network-enabled games.
  SKILL_PCG,md       ... Talent Chip for Platform Compliance & Content Safety.
  TinCLE.md          ... A document outlining TinCLE.
  HISTORY.md         ... A document detailing TinCLE's update history.
  info.txt           ... A prompt-assist file informing the AI of the engine's
                         core architecture.

  tinclec.exe        ... Compilation assistant utility for Windows builds.
  libs folder        ... Standard C libraries and framework engine headers.
  wasmmt folder      ... WebAssembly modules with multithreading support.
  cursor.png         ... A default mouse cursor image.
  font.ttf           ... A font provided by default as the starter kit.

  pisschk.exe        ... GLSL Error Checker.
  pisschk.dll        ... Dynamic Link Library for GLSL Error Checker.
  poopee.exe         ... Resource embedding utility for Windows application
                         metadata.
  manifest.xml       ... Default manifest file for embedding operations.
  icondom.exe        ... A dedicated icon generation utility that converts a
                         single image into standard Windows .ico formats.
  wipee.exe          ... A ZIP archiver for creating release packages.

  pisstrak.exe       ... MML Compiler (WAV/OGG Renderer).
  soundfont.sf2      ... A default soundfont.
  fartbox.exe        ... Sound Effects Compiler (WAV Renderer).
  fartbox.dll        ... Dynamic Link Library for Sound Effects Compiler.

  asspack.exe        ... Asset packing deployment utility for Windows
                         distribution.
  exsass.txt         ... List of asset file extensions.

  emcass.exe         ... TinCLE Emscripten Compiler Assistant utility for Web
                         builds.
  template.html      ... Default HTML canvas layout wrapper for Web/WASM
                         deployment.
  .htaccess          ... Server configuration file supplying necessary security
                         headers (COOP/COEP) for the Web build.
  churro.exe         ... Web server supporting COOP/COEP.

  pubicnet.exe       ... A tool for creating dedicated servers for individual
                         games.
  pubicnet.dll       ... Dynamic Link Library required for pubicnet to run.

  cannoli.dll        ... Additional DLL for using the Box2D/Box3D physics engine.
  cannoli.wasm       ... Additional WASM for using the Box2D/Box3D physics engine.
  gatochoc.dll       ... Additional DLL for using the Nuklear GUI library.
  gatochoc.wasm      ... Additional WASM for using the Nuklear GUI library.
  vtrushka.dll       ... Additional DLL for using the Nuklear VRML library.
  vtrushka.wasm      ... Additional WASM for using the Nuklear VRML library.

  cococake.exe       ... AI-collaborative IDE tailored for TinCLE development.
  cococake.ini       ... Configuration file for cococake IDE settings.
  Lexilla.dll        ... DLL for syntax highlighting capabilities.
  Scintilla.dll      ... DLL for core text editing and terminal UI.
  WebView2Loader.dll ... DLL for rendering embedded AI interfaces.

  The package also includes the following files tailored for human developers:

  popcorn.exe        ... Project Organizer for preparing new TinCLE projects.
  lollipop.exe       ... Virtual Line Printer for Creating PDF Files.
  readme.txt         ... Manual / Getting Started (This file).
  document.pdf       ... Reference manual formatted for human developers.
  CREDITS.txt        ... Detailed open-source licensing and third-party
                         information.
                         (Items not related to the user's game release.)
  TinCLE.md          ... TinCLE Overview Document.
  HISTORY.md         ... TinCLE Version History Document.

* How to Use

  If this is your first time using TinCLE and you'd like to get a general
  overview, attach "TinCLE.md”"to the chat AI and ask any questions you may
  have. If you'd like to see TinCLE's version history, attach "HISTORY.md" to
  the chat AI and ask any questions you may have.

  As a fundamental rule, please develop your project alongside your preferred
  AI coding partner (any AI assistant capable of generating standard C code).
  This engine is strictly not designed with the assumption that a human will
  write entire codebases from scratch (though it remains theoretically possible
  by reviewing the documentation).

  * Quick Project Setup via popcorn:

    If you want to start a brand-new project right away, simply run "popcorn.exe"
    located in the framework package. This utility automatically lets you select
    a destination directory and deploys all necessary framework files and
    SKILL.md directly into your target workspace in seconds.

  * Fully Automated AI Agent Workflow:

    If you grant your AI agent directory and file-handling execution privileges,
    place all framework files and directories into a folder accessible by the AI.
    Provide "SKILL.md" as the primary prompt guideline to request automated game
    creation. Ensure all raw game assets (images, fonts, audio) are placed
    directly in the same root folder (do not create subdirectories).
    The AI can invoke "tinclec" for native desktop binaries or "emcass" for web
    browser distribution deliverables automatically.

  * Interactive AI Chat Workflow:

    When developing via conventional AI chat prompts, feed the contents of
    "SKILL.md" to the AI as the initial context. Clearly describe your game
    concept, and request incremental code blocks. Simply copy-paste the
    generated output into "game.c" using your preferred text editor. Execute
    "tinclec" in the terminal to quickly playtest on Windows, or use "emcass"
    to test on a local web server.

  * Integrated Development via cococake IDE:

      You can streamline your AI-assisted development loop by using "cococake",
      the dedicated IDE for TinCLE that allows you to seamlessly update code and
      execute build commands while interacting with AI chat interfaces.
      Before launching, configure the following three parameters in
      "cococake.ini":

        AI_URL     ... The web address of the AI chat interface used for
                       development.
        TCC_PATH   ... The folder path containing tcc.exe in your environment.
        EMSDK_PATH ... The folder path containing emsdk.bat in your environment.

  * Human Understanding Stance:

    The overarching architectural philosophy of this framework views human
    readability as a secondary priority. However, if a human developer wishes to
    comprehend the underlying system mechanics, you can read "document.pdf,"
    which perfectly mirros the specifications outlined in SKILL.md. To grasp
    deployment pipelines or setup routines quickly, it is highly recommended to
    have an AI read SKILL.md and ask it questions directly.

* Troubleshooting: Cannot attach SKILL.md in AI Chat (e.g., Microsoft Copilot)

  Due to strict security filters on certain AI services (such as Microsoft
  Copilot), attaching `SKILL.md` directly as a file may be blocked, as the C
  language API signatures can be falsely flagged as malicious content.

  If you encounter this issue, please use our official GitHub Gist repository
  instead:

  * Official Gist Repository: https://gist.github.com/michyo

  * How to Use:

    1. Open the Gist repository corresponding to your TinCLE version.
    2. Locate the required skill file (e.g., `SKILL.md`, `SKILL_ADD.md`).
    3. Copy the URL of the file and paste it directly into your AI chat prompt.
    4. Instruct the AI to read the provided URL to load the necessary skills.

* System Requirements

  - Target Execution Environments:
    * Windows Desktop: Windows 10 or later (32-bit / 64-bit architectures)
    * Web Browser: Modern browsers supporting WebAssembly (WASM) and HTML5
                   (e.g., Google Chrome, Microsoft Edge, Mozilla Firefox)

  * It may operate on legacy versions of Windows or legacy browsers,
    but environment verification has not been conducted.

* License

  "TinCLE" is distributed as donationware (freeware). You are completely free
  to utilize it for your projects.
  However, users shall not reverse-engineer, decompile, disassemble, analyze,
  or attempt to decrypt the source code of this software framework binary.
  Furthermore, users shall not create derivative works or modified variations
  of this engine framework.

  All copyright titles belong exclusively to michyo (Michiyo Tagami).
  The copyright holder shall not be held liable or legally responsible for
  any operational failures, data loss, or damages arising from the use of
  this tool. Use this utility entirely at your own risk.

  Redistribution and reproduction are freely permitted worldwide. However,
  all distributions must remain intact in their original, unmodified package
  format. Post-distribution notification is highly appreciated but not mandatory.

  Please submit bug reports or general feedback directly to the author. The
  copyright holder will make reasonable efforts to address and improve issues,
  but this does not constitute a legal or contractual obligation.

  For detailed licensing metadata regarding the underlying tools and libraries,
  please refer to the included CREDITS.txt.

  * Commercial Use and Game Distribution Policy:

    When distributing a game built with this engine, you are completely free
    to bundle "tincle.dll" alongside your application. Commercial usage and
    monetization of your compiled games are fully permitted with zero royalty
    fees or licensing debts.

    While distribution requires bundling additional runtime modules (such as
    SDL2.dll), all third-party dependencies bundled with this engine operate
    under non-copyleft open-source terms, ensuring risk-free distribution.

    Please remember to include appropriate credit attributions in your game's
    documentation. For precise licensing compliance, please review the
    accompanying CREDITS.txt.

* Author Contact Information

  michyo (Michiyo Tagami)

    support@michyo.net
    http://www.michyo.net/
    X(Twitter): @Ravijour

================================================================================
