================================================================================
  TinCLE (Tiny C Lovely Engine) Version 0.03 -- Pink --

                                    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.

  "Why TinCLE?"

    Because existing game engines are too bloated. They are like a heavy,
    endless stream. Our framework is so tiny, light, and fast—it's like a quick
    tinkle. Just let it out, and you're done! No waste, just pure relief.

  "Why asspack?"

    First came TinCLE, the light and quick relief for modern bloated development.
    But what about the heavy, solid assets? That's where asspack comes in.
    It seals all your textures, sounds, and data into a single, un-crackable
    package, preventing any leaking. TinCLE handles the fluid code, asspack
    compresses the solid mass. Together, they complete the ultimate cycle of
    clean, lightweight execution.

  "Why emcass?"

    First we mastered fluid code and solid assets for desktop deployment. But
    how do we blast them into the infinite web universe? That's where emcass
    comes in. It takes your entire creation, emulsifies it into high-performance
    WebAssembly bytecode, and streams it straight into the browser canvas. No
    friction, no heavy installation—just pure, boundless relief for players
    worldwide.

* Package Contents

  tincle.dll   ... Core game engine binary (Windows target).
  SKILL.md     ... AI skill specification sheet for automated code generation.
  Detailed_SKILL folder ... Detailed SKILL.md for Agenetic AIs.

  SDL2.dll     ... SDL Dynamic Link Library.
  SDL2_ttf.dll ... SDL_ttf Dynamic Link Library.
  SDL2_gfx.dll ... SDL2_gfx Dynamic Link Library.
  font.ttf     ... A public domain font provided by default as the starter kit.

  tinclec.exe  ... Compilation assistant utility for Windows builds.
  embedres.exe ... Resource embedding utility for Windows application metadata.
  asspack.exe  ... Asset packing deployment utility for Windows distribution.
  manifest.xml ... Default manifest file for embedding operations.

  emcass.exe    ... TinCLE Emscripten Compiler Assistant utility for Web builds.
  template.html ... Default HTML canvas layout wrapper for Web/WASM deployment.

  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.

  libs folder  ... Dynamic link standard C libraries
                   and framework engine headers.

* How to Use

  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).

  * 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.

    [Notice for AI Chat Users]
    If you are using an AI chat client that might overlook or skip parts of long
    files, please copy and paste the contents of SKILL01.txt through SKILL03.txt
    in the For_AI_Chat folder into the prompt one by one in numerical order to
    get started.

  * 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.

* 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.

* Development Environment

  Built with the following software stack:

  - Windows 10 Pro 64-bit
  - Tiny C Compiler Version 0.9.27
  - Emscripten SDK Version 6.0.0 (WASM Toolchain)
  - Simple DirectMedia Layer (SDL) Version 2.32.8
  - SDL_ttf Version 2.24.0
  - stb libraries
  - SDL2_GFX Version 1.0.4

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

* Version Information

  Version 0.03 - 2026/07/11 (Current Version)

    - Completely deprecated engine-specific button constants and color macros, 
      fully transitioning to standard, native SDL2 constants and C99 literals.
    - Added comprehensive multi-font support and flexible font size handling
      options.
    - Shifted the standard image rendering anchor point from Top-Left to Exact
      Center.
    - Heavily streamlined, restructured, and optimized SKILL.md for higher AI
      efficiency.
    - Improved memory allocation performance and runtime execution stability for
      the Web/WASM target.

  Version 0.02 - 2026/07/02

    - Added full Hybrid Web/WASM compilation pipeline support.
    - Introduced TinCLE Emcc Assistant (emcass.exe) and template.html framework.
    - Refined core engine main-loop processing mechanics for high-precision
      framerates.
    - Added tincle_draw_text_center function for perfect user interface text
      alignment.

  Version 0.01 - 2026/06/28

    - Initial Release (Windows Desktop Only)

* 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.

  * 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

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