refactor(symfony-console): extract symfony/console into the shirabe-symfony-console crate

Move `Symfony\Component\Console` out of shirabe-external-packages and
into its own crate, so the path is
`shirabe_symfony_console::application::Application` instead of
`shirabe_external_packages::symfony::console::application::Application`.
The `delegate_to_inner!` and `delegate_command_trait_impls_to_inner!`
macros move with it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

1 files changed, 175 insertions, 0 deletions

diff --git a/crates/shirabe-symfony-console/src/helper/debug_formatter_helper.rs b/crates/shirabe-symfony-console/src/helper/debug_formatter_helper.rs
new file mode 100644
index 00000000..f7fd2157
--- /dev/null
+++ b/crates/shirabe-symfony-console/src/helper/debug_formatter_helper.rs
@@ -0,0 +1,175 @@
+//! ref: composer/vendor/symfony/console/Helper/DebugFormatterHelper.php
+
+use crate::helper::helper::Helper;
+use crate::helper::helper_interface::HelperInterface;
+use crate::helper::helper_set::HelperSet;
+use indexmap::IndexMap;
+
+const COLORS: [&str; 9] = [
+    "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "default",
+];
+
+/// Helps outputting debug information when running an external program from a command.
+///
+/// An external program can be a Process, an HTTP request, or anything else.
+#[derive(Debug)]
+pub struct DebugFormatterHelper {
+    inner: Helper,
+    started: IndexMap<String, DebugFormatterSession>,
+    count: i64,
+}
+
+/// Per-id session state. PHP stores this as `['border' => int, 'out' => true, 'err' => true]`
+/// where presence of `out`/`err` keys is tested via `isset` and removed via `unset`.
+#[derive(Debug, Default)]
+struct DebugFormatterSession {
+    border: i64,
+    out: bool,
+    err: bool,
+}
+
+impl Default for DebugFormatterHelper {
+    fn default() -> Self {
+        Self {
+            inner: Helper::default(),
+            started: IndexMap::new(),
+            count: -1,
+        }
+    }
+}
+
+impl DebugFormatterHelper {
+    /// Starts a debug formatting session.
+    pub fn start(&mut self, id: &str, message: &str, prefix: &str) -> String {
+        self.count += 1;
+        self.started.insert(
+            id.to_string(),
+            DebugFormatterSession {
+                border: self.count % COLORS.len() as i64,
+                out: false,
+                err: false,
+            },
+        );
+
+        format!(
+            "{}<bg=blue;fg=white> {} </> <fg=blue>{}</>\n",
+            self.get_border(id),
+            prefix,
+            message,
+        )
+    }
+
+    /// Adds progress to a formatting session.
+    pub fn progress(
+        &mut self,
+        id: &str,
+        buffer: &str,
+        error: bool,
+        prefix: &str,
+        error_prefix: &str,
+    ) -> String {
+        let mut message = String::new();
+
+        if error {
+            if self.started[id].out {
+                message.push('\n');
+                self.started.get_mut(id).unwrap().out = false;
+            }
+            if !self.started[id].err {
+                message.push_str(&format!(
+                    "{}<bg=red;fg=white> {} </> ",
+                    self.get_border(id),
+                    error_prefix,
+                ));
+                self.started.get_mut(id).unwrap().err = true;
+            }
+
+            message.push_str(&shirabe_php_shim::str_replace(
+                "\n",
+                &format!(
+                    "\n{}<bg=red;fg=white> {} </> ",
+                    self.get_border(id),
+                    error_prefix,
+                ),
+                buffer,
+            ));
+        } else {
+            if self.started[id].err {
+                message.push('\n');
+                self.started.get_mut(id).unwrap().err = false;
+            }
+            if !self.started[id].out {
+                message.push_str(&format!(
+                    "{}<bg=green;fg=white> {} </> ",
+                    self.get_border(id),
+                    prefix,
+                ));
+                self.started.get_mut(id).unwrap().out = true;
+            }
+
+            message.push_str(&shirabe_php_shim::str_replace(
+                "\n",
+                &format!(
+                    "\n{}<bg=green;fg=white> {} </> ",
+                    self.get_border(id),
+                    prefix,
+                ),
+                buffer,
+            ));
+        }
+
+        message
+    }
+
+    /// Stops a formatting session.
+    pub fn stop(&mut self, id: &str, message: &str, successful: bool, prefix: &str) -> String {
+        let trailing_eol = if self.started[id].out || self.started[id].err {
+            "\n"
+        } else {
+            ""
+        };
+
+        if successful {
+            return format!(
+                "{}{}<bg=green;fg=white> {} </> <fg=green>{}</>\n",
+                trailing_eol,
+                self.get_border(id),
+                prefix,
+                message,
+            );
+        }
+
+        let message = format!(
+            "{}{}<bg=red;fg=white> {} </> <fg=red>{}</>\n",
+            trailing_eol,
+            self.get_border(id),
+            prefix,
+            message,
+        );
+
+        if let Some(session) = self.started.get_mut(id) {
+            session.out = false;
+            session.err = false;
+        }
+
+        message
+    }
+
+    fn get_border(&self, id: &str) -> String {
+        format!("<bg={}> </>", COLORS[self.started[id].border as usize])
+    }
+}
+
+impl HelperInterface for DebugFormatterHelper {
+    fn set_helper_set(&mut self, helper_set: Option<std::rc::Rc<std::cell::RefCell<HelperSet>>>) {
+        self.inner.set_helper_set(helper_set);
+    }
+
+    fn get_helper_set(&self) -> Option<std::rc::Rc<std::cell::RefCell<HelperSet>>> {
+        self.inner.get_helper_set()
+    }
+
+    fn get_name(&self) -> String {
+        "debug_formatter".to_string()
+    }
+}